«npm error code ENOTFOUND» على Mac

يشير ENOTFOUND إلى فشل بحث DNS. تسميه وثائق Node.js «DNS lookup failed»، أي فشل EAI_NODATA أو EAI_NONAME.

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

يواجه Mac لديّ هذه المشكلة: «npm error code ENOTFOUND» على Mac. اقرأ https://kilobat.app/ar/guides/npm-enotfound.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 ENOTFOUND.
  • يذكر السطر التالي مضيفًا، مثل registry.npmjs.org.
  • قد تعمل المتصفحات.

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

  • لا اتصال أو DNS. لا يستطيع Mac الوصول إلى خادم DNS.
  • سجل خاطئ. يذكر إعداد سجل npm مضيفًا غير موجود أو يحتاج إلى VPN.
  • VPN بـ DNS خاص به. لا تُحلّ سجلات الشركات إلا أثناء تشغيل VPN.
  • وكيل لا يستخدمه npm. على الشبكات التي لا تعمل إلا عبر وكيل، يحتاج npm إلى إعدادات الوكيل.

كيفية التحقق

  1. اعرض السجل الذي يستخدمه npm.

    npm config get registry
  2. حلّ اسم المضيف عبر macOS.

    dscacheutil -q host -a name registry.npmjs.org
  3. اسأل السجل مباشرة.

    npm ping
  4. اعرض إعدادات الوكيل.

    npm config get https-proxy

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

  1. إذا فشل البحث في macOS، فأصلح DNS. راجع تعذر حل DNS على Mac.

  2. صحّح السجل.

    npm config set registry https://registry.npmjs.org/
  3. صِل VPN لسجل شركة.

  4. امسح ذاكرة DNS المؤقتة. راجع مسح ذاكرة DNS المؤقتة على Mac.

باستخدام Kilobat

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

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

الأسئلة

هل ENOTFOUND هو نفسه EAI_AGAIN؟

لا. يبلّغ EAI_AGAIN عن فشل مؤقت في البحث. راجع EAI_AGAIN على Mac.

هل اسم الحزمة خاطئ؟

نادرًا. يتعلق ENOTFOUND باسم مضيف، لا باسم حزمة.

المصادر

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