«npm error code ECONNREFUSED» على Mac
يشير ECONNREFUSED إلى اتصال مرفوض. تقول وثائق Node.js: «No connection could be made because the target machine actively refused it.»
يواجه Mac لديّ هذه المشكلة: «npm error code ECONNREFUSED» على Mac. اقرأ https://kilobat.app/ar/guides/npm-econnrefused.md وتابعه معي. ثبّت Kilobat CLI إن لم يكن مثبتًا: brew install seifip/kilobat/kilobat. شغّل بنفسك فحوصات Terminal وkilobat الواردة في الدليل وأخبرني بما تجده. اذكر الخطوات التي لا يستطيع تنفيذها غيري. اسألني قبل أن تغيّر أي إعداد.
الأعراض
- يتوقف
npm installأو برنامج نصي معnpm error code ECONNREFUSED. - يذكر السطر التالي عنوانًا ومنفذًا، مثل
127.0.0.1:8080. - يأتي غالبًا بعد إعداد وكيل أو سجل.
الأسباب المحتملة
- إعداد وكيل يشير إلى لا شيء. ضُبط وكيل على
127.0.0.1أو مضيف آخر، لكن لا يعمل وكيل هناك. - سجل محلي مطفأ. مرآة أو ذاكرة مؤقتة محلية متوقفة.
- خدمة غير نشطة. تقول وثائق Node.js إن هذا ينتج عادةً من خدمة غير نشطة على المضيف البعيد.
- برنامج نصي يستدعي خادمًا محليًا. قد تستدعي خطوة اختبار أو بناء خادمًا لم يبدأ.
كيفية التحقق
اقرأ العنوان والمنفذ في الخطأ.
اعرض وكيل npm والسجل.
npm config get proxy npm config get https-proxy npm config get registryاختبر ذلك المنفذ.
nc -vz 127.0.0.1 8080اعرض متغيرات الوكيل.
env | grep -i proxy
كيفية الإصلاح
احذف إعداد وكيل لا تحتاج إليه.
npm config delete proxy npm config delete https-proxyشغّل السجل المحلي أو الخادم الذي يذكره العنوان.
ألغِ ضبط متغيّرات الوكيل الخاطئة.
unset https_proxy http_proxyأعد التثبيت.
الأسئلة
هل ECONNREFUSED هو نفسه ECONNRESET؟
لا. ECONNREFUSED رفض عند البداية. أما ECONNRESET فيغلق اتصالًا مفتوحًا. راجع «npm error code ECONNRESET» على Mac.
لماذا يذكر 127.0.0.1؟
جرّب npm عنوانًا محليًا، غالبًا من إعداد وكيل أو سجل.
المصادر
تم التحقق في 29 أكتوبر 2026.