«npm error code ECONNREFUSED» على Mac

يشير ECONNREFUSED إلى اتصال مرفوض. تقول وثائق Node.js: «No connection could be made because the target machine actively refused it.»

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

يواجه Mac لديّ هذه المشكلة: «npm error code ECONNREFUSED» على Mac. اقرأ https://kilobat.app/ar/guides/npm-econnrefused.md وتابعه معي. ثبّت Kilobat CLI إن لم يكن مثبتًا: brew install seifip/kilobat/kilobat. شغّل بنفسك فحوصات Terminal وkilobat الواردة في الدليل وأخبرني بما تجده. اذكر الخطوات التي لا يستطيع تنفيذها غيري. اسألني قبل أن تغيّر أي إعداد.

ينطبق على: npm 10 والإصدارات الأحدث تطبع «npm error». أما الإصدارات الأقدم فتطبع «npm ERR!». Node.js على جميع إصدارات macOS الحالية.تاريخ التحقق: 29 أكتوبر 2026

الأعراض

  • يتوقف npm install أو برنامج نصي مع npm error code ECONNREFUSED.
  • يذكر السطر التالي عنوانًا ومنفذًا، مثل 127.0.0.1:8080.
  • يأتي غالبًا بعد إعداد وكيل أو سجل.

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

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

كيفية التحقق

  1. اقرأ العنوان والمنفذ في الخطأ.

  2. اعرض وكيل npm والسجل.

    npm config get proxy
    npm config get https-proxy
    npm config get registry
  3. اختبر ذلك المنفذ.

    nc -vz 127.0.0.1 8080
  4. اعرض متغيرات الوكيل.

    env | grep -i proxy

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

  1. احذف إعداد وكيل لا تحتاج إليه.

    npm config delete proxy
    npm config delete https-proxy
  2. شغّل السجل المحلي أو الخادم الذي يذكره العنوان.

  3. ألغِ ضبط متغيّرات الوكيل الخاطئة.

    unset https_proxy http_proxy
  4. أعد التثبيت.

الأسئلة

هل ECONNREFUSED هو نفسه ECONNRESET؟

لا. ECONNREFUSED رفض عند البداية. أما ECONNRESET فيغلق اتصالًا مفتوحًا. راجع «npm error code ECONNRESET» على Mac.

لماذا يذكر 127.0.0.1؟

جرّب npm عنوانًا محليًا، غالبًا من إعداد وكيل أو سجل.

المصادر

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