تشخيص حالات الفشل
يصف رمز التشخيص الأدلة التي حصل عليها هذا الفاحص. وهو لا يحدد كل سبب جذري محتمل، ولا يحتاج أبدًا إلى كلمة مرورك في لقطة شاشة أو رسالة إلى الدعم.
يتولى فريق المنتج في 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 الظاهرة للمتصفح.
افتح المورد