---
title: "«npm error code ENOTFOUND» على Mac · أدلة Kilobat"
url: "https://kilobat.app/ar/guides/npm-enotfound"
description: "يتوقف npm install على Mac مع npm error code ENOTFOUND. لم يُحلّ اسم السجل. افحص DNS وإعداد السجل وVPN والوكيل."
---

# «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](https://kilobat.app/ar/guides/dns-server-not-found).
2. صحّح السجل.

   ```
   npm config set registry https://registry.npmjs.org/
   ```
3. صِل VPN لسجل شركة.
4. امسح ذاكرة DNS المؤقتة. راجع [مسح ذاكرة DNS المؤقتة على Mac](https://kilobat.app/ar/guides/flush-dns-cache-mac).

## باستخدام Kilobat

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

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. فحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام `diagnose_connection` و`diagnose_network`. راجع [معرفة سبب تعذّر اتصال موقع أو API واحد](https://kilobat.app/ar/guides/recipes/why-cant-it-connect).

## الأسئلة

**هل ENOTFOUND هو نفسه EAI_AGAIN؟**

لا. يبلّغ EAI_AGAIN عن فشل مؤقت في البحث. راجع [EAI_AGAIN على Mac](https://kilobat.app/ar/guides/eai-again).

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

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

## المصادر

- [وثائق 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 ETIMEDOUT» على Mac](https://kilobat.app/ar/guides/npm-etimedout): يعني ETIMEDOUT أن الطرف الآخر لم يرد في الوقت المحدد.
- [EAI_AGAIN على Mac](https://kilobat.app/ar/guides/eai-again): يشير EAI_AGAIN إلى تعذّر ترجمة اسم في الوقت الحالي.
- [«curl: (6) Could not resolve host» على Mac](https://kilobat.app/ar/guides/curl-could-not-resolve-host): يعني رمز خروج curl رقم 6 أن curl لم يتمكن من الحصول على عنوان لاسم المضيف.
