وصفة

اكتشف سبب تعذر اتصال موقع أو API

عندما يعمل الإنترنت ويفشل عنوان واحد، يفحص Kilobat كل طبقة بالتتابع. ويحدد الطبقة التي فشلت والخطوة التالية.

مجاني في التطبيق وCLIتاريخ التحقق: 29 أكتوبر 2026

في التطبيق

  1. افتح لوحة المعلومات وانقر على علامة تبويب الصحة.

  2. اعثر على «لماذا لا يمكن الاتصال؟».

  3. الصق العنوان الدقيق الذي يفشل في الحقل، مثل github.com أو URL كامل.

  4. اختر التطبيق إذا كانت المشكلة تخص تطبيقًا واحدًا. يفحص Kilobat عندئذٍ الوكيل الخاص به واتصالاته المفتوحة أيضًا.

  5. انقر على فحص. اقرأ الطبقة التي فشلت والخطوة التالية.

باستخدام CLI

  1. افحص مضيفًا واحدًا.

    kilobat why api.example.com

    النتيجة كل طبقة بحالة ناجحة أو تحذير أو فاشلة أو متخطاة، ثم النتيجة والخطوة التالية. ينتهي الأمر بالرمز 1 عند فشل طبقة.

  2. افحص URL الدقيق الذي يستخدمه تطبيق واحد. تخفي النتيجة قيم الاستعلام.

    kilobat why https://example.com/file.zip --app com.example.App
  3. اختبر عبر عنوان الوكيل الذي يضبطه التطبيق في إعداداته الخاصة.

    kilobat why https://huggingface.co --proxy http://127.0.0.1:7890
  4. أخبر Kilobat عندما تعمل التعليمات البرمجية في حاوية أو جهاز افتراضي أو على جهاز بعيد.

    kilobat why db.internal --context container
  5. سجّل وقت فشل التطبيق بجانب وقت الفحص.

    kilobat why api.example.com --failed-at 14:05

عبر MCP

صِل خادم MCP مرة واحدة باستخدام claude mcp add kilobat -- kilobat mcp. للعملاء الآخرين، راجع الوثائق. يمكن للوكيل بعدها استدعاء هذه الأدوات. تطلب الأدوات التي تغيّر الإعدادات من الوكيل سؤالك أولًا.

الأداة والوسائطوظيفته
diagnose_connection
{"target": "https://api.example.com/v1/models", "app": "process:node"}
يُرجع verdict وnext وsteps، ولكل منها layer وstatus وdetail.

من المفيد معرفته

  • يعمل الفحص داخل Kilobat، وليس عبر curl. لا يمكن لملف تعريف Kilobat صارم حظر الفحص نفسه.
  • يختبر IPv4 وIPv6 كلًا على حدة. يحصل مسار IPv6 المعطّل على نتيجة مستقلة.
  • نجاح الفحص يعني أن هذا الطلب يعمل من جهاز Mac هذا عبر ذلك المسار الآن. لا يمكنه رؤية عملية نقل جارية بالفعل.

الأسئلة

ماذا يفعل --context provider؟

استخدمه عندما تقدم خدمة مستضافة الطلب من خوادمها الخاصة. يعمل العنوان الخاص مثل localhost من Mac، لكن لا تستطيع تلك الخوادم الوصول إليه.

المصادر

تم التحقق في 29 أكتوبر 2026.