---
title: "اكتشف سبب تعذّر الاتصال بموقع أو API واحد · وصفات Kilobat"
url: "https://kilobat.app/ar/guides/recipes/why-cant-it-connect"
description: "افحص موقع ويب أو API أو مضيفًا واحدًا طبقةً تلو الأخرى من Mac: الشبكة وVPN والوكيل وDNS وقواعد Kilobat وIPv4 وIPv6 وTLS واستجابة الخادم."
---

وصفة

# اكتشف سبب تعذر اتصال موقع أو 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`. للعملاء الآخرين، راجع [الوثائق](https://kilobat.app/ar/docs/agents#agents). يمكن للوكيل بعدها استدعاء هذه الأدوات. تطلب الأدوات التي تغيّر الإعدادات من الوكيل سؤالك أولًا.

| الأداة والوسائط | وظيفته |
|---|---|
| `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، لكن لا تستطيع تلك الخوادم الوصول إليه.

## المصادر

- [وثائق Kilobat: عندما يتعذّر اتصال شيء ما](https://kilobat.app/ar/docs/health#why)
- [مهارة Kilobat: mac-network-troubleshooting](https://github.com/seifip/kilobat-skills/tree/main/skills/mac-network-troubleshooting)
- [Kilobat llms.txt: مرجع CLI وMCP](https://kilobat.app/llms.txt)

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

## أدلة ذات صلة

- [موقع يعمل على هاتفك ولا يعمل على Mac](https://kilobat.app/ar/guides/site-works-on-phone-not-mac): عندما يفتح الموقع على هاتفك ولا يفتح على Mac، تكون المشكلة عادةً على Mac.
- [إعدادات الوكيل تمنع التطبيقات من الاتصال على Mac](https://kilobat.app/ar/guides/proxy-settings-breaking-apps): يرسل إعداد الوكيل حركة البيانات عبر خادم آخر.
- [مشكلات IPv6 على Mac](https://kilobat.app/ar/guides/ipv6-problems-mac): تمنح معظم الشبكات Mac عنوانَي IPv4 وIPv6.
- [لا تستطيع حاوية الوصول إلى localhost على Mac](https://kilobat.app/ar/guides/localhost-from-container): لكل حاوية مكدس شبكة خاص بها.