«npm error code ENOTFOUND» على Mac
يشير ENOTFOUND إلى فشل بحث DNS. تسميه وثائق Node.js «DNS lookup failed»، أي فشل EAI_NODATA أو EAI_NONAME.
يواجه Mac لديّ هذه المشكلة: «npm error code ENOTFOUND» على Mac. اقرأ https://kilobat.app/ar/guides/npm-enotfound.md وتابعه معي. ثبّت Kilobat CLI إن لم يكن مثبتًا: brew install seifip/kilobat/kilobat. شغّل بنفسك فحوصات Terminal وkilobat الواردة في الدليل وأخبرني بما تجده. اذكر الخطوات التي لا يستطيع تنفيذها غيري. اسألني قبل أن تغيّر أي إعداد.
الأعراض
- يتوقف
npm installمع ظهورnpm error code ENOTFOUND. - يذكر السطر التالي مضيفًا، مثل
registry.npmjs.org. - قد تعمل المتصفحات.
الأسباب المحتملة
- لا اتصال أو DNS. لا يستطيع Mac الوصول إلى خادم DNS.
- سجل خاطئ. يذكر إعداد سجل npm مضيفًا غير موجود أو يحتاج إلى VPN.
- VPN بـ DNS خاص به. لا تُحلّ سجلات الشركات إلا أثناء تشغيل VPN.
- وكيل لا يستخدمه npm. على الشبكات التي لا تعمل إلا عبر وكيل، يحتاج npm إلى إعدادات الوكيل.
كيفية التحقق
اعرض السجل الذي يستخدمه npm.
npm config get registryحلّ اسم المضيف عبر macOS.
dscacheutil -q host -a name registry.npmjs.orgاسأل السجل مباشرة.
npm pingاعرض إعدادات الوكيل.
npm config get https-proxy
كيفية الإصلاح
إذا فشل البحث في macOS، فأصلح DNS. راجع تعذر حل DNS على Mac.
صحّح السجل.
npm config set registry https://registry.npmjs.org/صِل VPN لسجل شركة.
امسح ذاكرة DNS المؤقتة. راجع مسح ذاكرة DNS المؤقتة على Mac.
باستخدام Kilobat
يختبر طبيب الاتصال في Kilobat العنوان طبقة بعد طبقة: الشبكة والوكيل وDNS والقواعد وIPv4 وIPv6 وTLS والخادم. ويسمّي الطبقة التي فشلت.
kilobat why https://registry.npmjs.org/فحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام
diagnose_connectionوdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.
الأسئلة
هل ENOTFOUND هو نفسه EAI_AGAIN؟
لا. يبلّغ EAI_AGAIN عن فشل مؤقت في البحث. راجع EAI_AGAIN على Mac.
هل اسم الحزمة خاطئ؟
نادرًا. يتعلق ENOTFOUND باسم مضيف، لا باسم حزمة.
المصادر
تم التحقق في 29 أكتوبر 2026.