---
title: "«npm error code ECONNREFUSED» على Mac · أدلة Kilobat"
url: "https://kilobat.app/ar/guides/npm-econnrefused"
description: "يتوقف npm install على Mac مع npm error code ECONNREFUSED. رفض مضيف الاتصال. افحص السجل والوكيل والخدمات المحلية."
---

# «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](https://kilobat.app/ar/guides/npm-econnreset).

**لماذا يذكر 127.0.0.1؟**

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

## المصادر

- [وثائق Node.js: أخطاء النظام الشائعة](https://nodejs.org/api/errors.html#common-system-errors)
- [وثائق npm: الأخطاء الشائعة](https://docs.npmjs.com/common-errors)

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

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

- [«npm error code ECONNRESET» على Mac](https://kilobat.app/ar/guides/npm-econnreset): يشير ECONNRESET إلى إعادة تعيين الاتصال قسرًا.
- [«npm error code ENOTFOUND» على Mac](https://kilobat.app/ar/guides/npm-enotfound): يشير ENOTFOUND إلى فشل بحث DNS.
- [ERR_CONNECTION_REFUSED في Chrome على Mac](https://kilobat.app/ar/guides/err-connection-refused): ERR_CONNECTION_REFUSED خطأ شبكة في Chrome.
- [إعدادات الوكيل تمنع التطبيقات من الاتصال على Mac](https://kilobat.app/ar/guides/proxy-settings-breaking-apps): يرسل إعداد الوكيل حركة البيانات عبر خادم آخر.
