تشخيص حالات الفشل
يصف رمز التشخيص الأدلة التي حصل عليها هذا الفاحص. وهو لا يحدد كل سبب جذري محتمل، ولا يحتاج أبدا إلى كلمة مرورك في لقطة شاشة أو رسالة إلى الدعم.
يتولى فريق المنتج في TrueProxies صيانة هذه المنهجية. ولا يقدم المسؤول المذكور عن الصيانة بوصفه مدققا مستقلا أو جهة اعتماد خارجية.
إجابة سريعة
البداية تكون برمز الخطأ الدقيق، وبروتوكول النقل المختار، والهدف المختار، وتسمية لنقطة الاتصال خالية من بيانات الاعتماد. تحدث حالات فشل الصيغة والعناوين الخاصة قبل إرسال أي طلب عبر البروكسي. أما حالات فشل DNS والمصادقة والاتصال وTLS وانتهاء المهلة والاستجابة فتحدث في مراحل شبكية مختلفة. واستجابة الهدف الواقعة خارج النطاق المقبول تعني أن طلبا خفيفا واحدا لم يقبل؛ ولا تثبت أن عنوان IP الخارج محظور في كل مكان.
حدود الأدلة
يوضح التشخيص الموثوق للبروكسي ما تظهره النتيجة الواحدة بدقة، ويبقي الادعاءات الأوسع خارج الحكم.
| الإشارة | ما تثبته | ما لا تثبته |
|---|---|---|
| الحالة | فئة النتيجة العامة التي يعرضها هذا الفاحص، مثل «غير صالح» أو «غير متصل» أو «انتهت المهلة» أو «يعمل». | الجهة المشغلة المسؤولة، أو توفر نقطة الاتصال في المستقبل، أو ما إذا كان عميل آخر سيتصرف بالطريقة نفسها تماما. |
| رمز الخطأ | المرحلة المرتبطة بحالة الفشل المرصودة: محلل الإدخال أو محلل DNS أو النقل أو المصادقة أو الهدف أو الاستجابة. | السبب الجذري الكامل على مستوى الحزم، أو وقوع حادث يشمل المزود بأكمله. |
| حالة HTTP للهدف | الحالة الواردة في ترويسات الاستجابة الأولى المعادة لطلب الهدف المختار. | أن الوجهة حظرت البروكسي؛ فلاستجابات 4xx و5xx أسباب محتملة كثيرة. |
| تسمية خالية من بيانات الاعتماد | رقم السطر المرسل ونقطة الاتصال المخفية اللذان تنتمي إليهما النتيجة. | اسم المستخدم أو كلمة المرور المرسلة، إذ يجب أن تبقى سرية. |
سير عمل التشخيص
إبقاء نقطة الاتصال وبروتوكول النقل والهدف وحدود الأدلة واضحة وصريحة، حتى تظل إعادة المحاولة قابلة للمقارنة.
التحقق من صيغة السطر، وضع عناوين IPv6 الحرفية بين أقواس مربعة، وإبقاء المنفذ ضمن النطاق 1–65535، واستخدام ترميز النسبة المئوية للأحرف المحجوزة داخل بيانات الاعتماد المكتوبة بصيغة URL. ولا تنشر سلسلة بيانات الاعتماد الخام.
استبدال الوضع التلقائي ببروتوكول النقل الذي يوثقه المزود: http:// لنقل بروكسي HTTP عادي، وhttps:// لاتصال TLS بالبروكسي، وsocks5:// لتحليل DNS للهدف من جهة الفاحص، أو socks5h:// لتحليل DNS للهدف من جهة البروكسي.
تشغيل أولا فحص «اتصال HTTPS العام». فإذا نجح، تشغيل نقطة الاتصال نفسها مع هدف Google أو Wikipedia المختار، حتى لا تخلط استجابة الوجهة ببروكسي معطل.
إبقاء نقطة الاتصال وبروتوكول النقل والهدف والخادم المنفذ ثابتة في الفحص المتكرر. فإذا تغيرت عدة إعدادات معا، لا يمكن نسب النتيجة المختلفة إلى سبب واحد.
تنشر قائمة المزودين وحقول البيانات وحدود التوقيت والمهل الزمنية والخصوصية والقيود بصيغة JSON مرقمة الإصدار.
مرجع التفسير
ينبغي التعامل مع الرمز على أنه ملاحظة محدودة النطاق، وتصميم الفحص التالي المقترح لتضييق نطاق الفشل دون كشف بيانات الاعتماد أو افتراض أن المزود هو المخطئ.
| الرمز | الدليل المرصود | الفحص التالي الآمن |
|---|---|---|
| INVALID_FORMAT | تعذر تحليل السطر إلى نقطة اتصال بروكسي عامة مدعومة. | قارنه بالأمثلة المقبولة، والتحقق من الأقواس والمخطط والمنفذ وفواصل بيانات الاعتماد. |
| PRIVATE_ADDRESS | كانت نقطة الاتصال خاصة أو محجوزة، أو لم يحلل اسمها إلى عناوين عامة حصرا. | استخدام اسم المضيف العام الذي يقدمه المزود، ولا ترسل عناوين الاسترجاع الداخلي أو الشبكة المحلية أو الخدمات الداخلية. |
| DNS_FAILED | تعذر على الفاحص تحليل اسم مضيف البروكسي المرسل. | التحقق من التهجئة ومن سجلات DNS العامة باستخدام محلل مستقل، ثم إعادة المحاولة. |
| AUTH_REQUIRED | طلب البروكسي المصادقة أو رفض تبادل المصادقة المقدم. | التحقق بشكل خاص من صيغة اسم المستخدم وترميز كلمة المرور ووضع المصادقة بعنوان IP موثوق وقواعد المصادقة الخاصة بالمنتج. |
| CONNECT_REFUSED | رفض المضيف البعيد اتصال البروكسي أو أغلقه. | التأكد من المضيف والمنفذ وحالة الخدمة وقوائم عناوين IP الموثوقة، وما إذا كان المزود يتوقع بروتوكول نقل آخر. |
| NETWORK_UNREACHABLE | تعذر على الفاحص إنشاء مسار إلى مضيف البروكسي. | التحقق من إمكانية الوصول عبر عائلة العناوين المستخدمة، وما إذا كانت نقطة الاتصال مقصورة على شبكة خاصة أو شبكة المزود. |
| TLS_FAILED | فشلت مصافحة TLS مطلوبة أو فشل التحقق من الشهادة. | التأكد مما إذا كان نقل البروكسي هو HTTPS، وما إذا كان اسم المضيف يطابق شهادته، وما إذا كان المزود يتطلب نقطة اتصال TLS مختلفة. |
| TARGET_DNS_FAILED | تعذر تحليل اسم مضيف الهدف المختار في وضع DNS الموثق لبروتوكول النقل النشط. | إبقاء بروتوكول نقل البروكسي ثابتا، والتحقق مما إذا كان المقصود تحليل DNS للهدف من جهة الفاحص أم من جهة البروكسي. |
| TARGET_CONNECT_FAILED | نجح مسار البروكسي في فحص الخروج، لكنه لم ينشئ الاتصال بالهدف المختار. | اعتبار ذلك دليلا على مشكلة نقل خاصة بالهدف، وإعادة تجربة «اتصال HTTPS العام» قبل تغيير بيانات الاعتماد. |
| TARGET_TLS_FAILED | فشلت مصافحة HTTPS مع الهدف المختار بعد نجاح فحص الخروج المحايد. | مقارنة سياسة الهدف ببروتوكول النقل النشط، ولا تبلغ عن نقطة اتصال البروكسي نفسها بأنها غير متصلة في كل الأحوال. |
| TARGET_TIMEOUT | لم ينتج عن طلب الهدف المختار أي ترويسات استجابة خلال ثماني ثوان. | الاحتفاظ بدليل الخروج الناجح وإعادة تجربة الهدف نفسه مرة واحدة، ولا تختلق حالة HTTP. |
| TARGET_FAILED | فشل طلب الهدف المختار دون رمز عام أكثر تحديدا لمرحلة الهدف. | إعادة اختبار نقطة اتصال واحدة ببروتوكول النقل الصريح نفسه، وتسجيل الرمز والهدف والوقت فقط، وهي بيانات غير سرية. |
| TARGET_NOT_ACCEPTED | أعاد الهدف المختار ترويسات استجابة خارج النطاق المقبول 2xx/3xx. | تسجيل الحالة وإعادة تجربة «اتصال HTTPS العام»، والتعامل مع النتيجة على أنها خاصة بالهدف لا دليلا على الحظر. |
| TIMEOUT | لم تكتمل محاولة طلب واحدة عبر البروكسي خلال ثماني ثوان. | إعادة المحاولة في وقت آخر ومقارنة ببروتوكول نقل صريح، ولا تعامل انتهاء مهلة واحدا على أنه قياس للإنتاجية. |
| BAD_RESPONSE | أعادت خدمة عنوان IP الخارج استجابة بحالة غير 200، أو كبيرة الحجم بشكل مفرط، أو مشوهة، أو تتضمن عنوانا غير عام. | إعادة المحاولة مرة واحدة ومقارنة بنقطة اتصال أخرى؛ فقد تشير النتائج المتكررة إلى إعادة كتابة الاستجابة أو إلى مشكلة في خدمة المنبع. |
| CANCELLED | ألغي التشغيل قبل أن ينتج هذا الفحص نتيجة نهائية عادية. | بدء تشغيل جديد إذا كنت لا تزال بحاجة إلى الأدلة، ولا تفسر الإلغاء على أنه فشل في نقطة الاتصال. |
| UNKNOWN | لم تطابق حالة الفشل فئة عامة أكثر دقة. | إعادة اختبار نقطة اتصال واحدة ببروتوكول نقل صريح، والاحتفاظ للدعم بالطوابع الزمنية والرموز وتفاصيل الهدف غير السرية فقط. |
استكشاف الأخطاء وإصلاحها
إبقاء بيانات الاعتماد سرية، وغير متغيرا واحدا في كل مرة.
المعنى المرجح: الوضع التلقائي تسلسل محدود لتسهيل الاستخدام، ولا يخمن أوضاع TLS إلى البروكسي أو أوضاع SOCKS مع DNS عن بعد.
الفحص التالي: الاحتفاظ بالمخطط الصريح الناجح في إعدادات العميل بدلا من الاعتماد على الاستدلال من رقم المنفذ.
المعنى المرجح: وصل البروكسي إلى فحص الخروج المحايد، بينما أعادت الوجهة المختارة ترويسات استجابة مختلفة.
الفحص التالي: مراجعة الحالة وقواعد الوجهة والمنطقة ومعدل الطلبات وسلوك العميل، دون وصف نقطة الاتصال بأنها معطلة.
المعنى المرجح: قد يكون المسار أو مجمع البروكسي أو عنوان الخروج أو قائمة الانتظار أو الوجهة متغيرا.
الفحص التالي: تكرار اختبار صريح ثابت، ومقارنة عدد مرات النجاح ووسيط زمن الاستجابة بدلا من الاعتماد على تشغيل واحد.
المعنى المرجح: نجح فحص الخروج عبر البروكسي، لكن الإثراء المباشر المنفصل عبر GeoJS لم يعد حقولا قابلة للاستخدام.
الفحص التالي: اعتبار الاتصال مرصودا والموقع غير متاح، وإعادة المحاولة بدلا من اختلاق موقع جغرافي.
تحدد هذه المعايير دلالات البروتوكولات والاستجابات التي يستند إليها في تحديد حدود أدلة الفاحص.
متابعة التشخيص
يجيب كل مورد عن سؤال مختلف، ويرتبط بفاحص البروكسي المرجعي الوحيد.
فصل توقيت الاستجابة عن الإنتاجية، ومقارنة القياسات المتكررة بشكل صحيح.
فتح الموردفهم بروتوكولات النقل الصريحة وأوضاع DNS في SOCKS5 وسلوك الوضع التلقائي المحدود.
فتح الموردفسر أدلة ترويسات الاستجابة من Google أو Wikipedia دون اعتبار كل رفض حظرا.
فتح الموردبعد فحص نقطة اتصال البروكسي، مقارنة مسارات IPv4 وIPv6 وWebRTC وDNS الظاهرة للمتصفح.
فتح المورد