«curl: (7) Failed to connect» على Mac

يشير رمز الخروج 7 في curl إلى خطوة فاشلة. تقول وثائق curl: «Failed to connect() to host or proxy.»

أصلحها مع وكيلكينسخ طلبًا لـ Claude Code أو Codex أو أي وكيل يستطيع استخدام الطرفية.

يواجه Mac لديّ هذه المشكلة: «curl: (7) Failed to connect» على Mac. اقرأ https://kilobat.app/ar/guides/curl-7-failed-to-connect.md وتابعه معي. ثبّت Kilobat CLI إن لم يكن مثبتًا: brew install seifip/kilobat/kilobat. شغّل بنفسك فحوصات Terminal وkilobat الواردة في الدليل وأخبرني بما تجده. اذكر الخطوات التي لا يستطيع تنفيذها غيري. اسألني قبل أن تغيّر أي إعداد.

ينطبق على: curl المرفق مع macOS وcurl الخاص بـ Homebrew، على جميع إصدارات macOS الحالية.تاريخ التحقق: 29 أكتوبر 2026

الأعراض

  • يعرض Terminal curl: (7) Failed to connect to host port 443.
  • يضيف النص غالبًا «Couldn't connect to server» أو «Connection refused».
  • تتوقف البرامج النصية وبرامج التثبيت برمز الخروج 7.

الأسباب المحتملة

  • لا شيء يستمع على المنفذ. الخدمة متوقفة، أو تستخدم منفذًا آخر.
  • جدار حماية أو وكيل. قد يرفض جدار الحماية الاتصال. ويفشل curl أيضًا عندما يُضبط وكيل ولا يمكن الوصول إليه.
  • عنوان خاطئ. المضيف أو المنفذ في العنوان خاطئ. وقد يكون متغيّر في برنامج نصي فارغًا.
  • مسار IPv6 أو VPN. قد يجرّب curl عنوانًا لا تستطيع الشبكة الوصول إليه.

كيفية التحقق

  1. اطبع العنوان الدقيق. وافحص المضيف والمنفذ.

  2. شغّل curl مع التفاصيل. تُظهر الأسطر الأولى العنوان الذي فشل.

    curl -v https://example.com
  3. اختبر المنفذ.

    nc -vz example.com 443
  4. اعرض متغيرات الوكيل.

    env | grep -i proxy

كيفية الإصلاح

  1. شغّل الخدمة إذا كانت لك. واستخدم المنفذ الذي تطبعه.

  2. أجبر استخدام IPv4 لاختبار عطل في IPv6.

    curl -4 -v https://example.com
  3. ألغِ ضبط وكيل خاطئ.

    unset https_proxy http_proxy
  4. أوقف VPN لاختبار قصير. ثم شغّله من جديد.

باستخدام Kilobat

  1. يختبر طبيب الاتصال في Kilobat العنوان طبقة بعد طبقة: الشبكة والوكيل وDNS والقواعد وIPv4 وIPv6 وTLS والخادم. ويسمّي الطبقة التي فشلت.

    kilobat why https://example.com
  2. فحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام diagnose_connection وdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.

الأسئلة

هل يعني رمز الخروج 7 أن المضيف متوقف؟

ليس دائمًا. لم يستطع curl الاتصال بالمضيف أو بالوكيل. اعرف أيهما باستخدام curl -v.

ما الفرق عن (6)؟

يعني رمز الخروج 6 أن اسم المضيف لم يُحلّ. ويعني الرمز 7 أن الاتصال فشل. راجع «curl: (6) Could not resolve host» على Mac.

المصادر

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