رسائل الأخطاء

«npm error code ETIMEDOUT» على Mac

تحدد وثائق npm قيمة fetch-timeout الافتراضية عند 300000 ms، أي خمس دقائق، وقيمة fetch-retries عند 2.

يعني ETIMEDOUT أن الطرف الآخر لم يستجب في الوقت المحدد. تقول وثائق Node.js: «لم يستجب الطرف المتصل بشكل صحيح بعد فترة من الوقت».

ينطبق على: يعرض npm 10 والإصدارات الأحدث «npm error». تعرض الإصدارات الأقدم «npm ERR!». جميع إصدارات macOS الحالية.تاريخ التحقق: 29 أكتوبر 2026

الأعراض

وكيل لا يعرفه npm. في شبكة تحتاج إلى وكيل، يحتاج npm إلى إعدادَي proxy وhttps-proxy.
سجل لا يمكنك الوصول إليه. قد يشير إعداد registry قديم إلى خادم خاص.
اتصال بطيء أو يفقد الحزم. قد تنتهي مهلة الحزم الكبيرة على Wi-Fi ضعيفة أو نقطة اتصال.
مسار IPv6 معطّل. للسجل عنوان IPv6، ولا يعمل IPv6 على شبكتك.

اعرض إعدادات سجل npm والوكيل.

npm config get registry
npm config get proxy
npm config get https-proxy

اطلب استجابة من السجل.
```
npm ping
```
اختبر السجل باستخدام curl وIPv4 فقط.
```
curl -4 -I https://registry.npmjs.org/
```
قس الاتصال.
```
networkQuality
```

إذا كانت الشبكة تحتاج إلى وكيل، فعيّنه لـ npm.
```
npm config set https-proxy http://proxy.example.com:8080
```
أزل إعداد سجل قديمًا ليستخدم npm الإعداد الافتراضي.
```
npm config delete registry
```
زد عدد محاولات npm على اتصال بطيء.
```
npm config set fetch-retries 5
```
أعد تشغيل التثبيت على شبكة أسرع إن أمكن.

يختبر طبيب الاتصال في Kilobat السجل طبقةً بطبقة: الشبكة والوكيل وDNS والقواعد وIPv4 وIPv6 وTLS والخادم. ويحدد الطبقة التي فشلت.
```
kilobat why https://registry.npmjs.org/
```
تحقق مما إذا كانت الشبكة محدودة البيانات أو تستخدم VPN أو بطيئة قبل تثبيت كبير.
```
kilobat conditions
```
فحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام diagnose_connection وdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.

كم ينتظر npm؟

تحدد وثائق npm قيمة fetch-timeout الافتراضية عند 300000 ms، أي خمس دقائق، و2 من fetch-retries.

هل يمكن أن يؤثر إعداد الوكيل في تنزيلات npm؟

نعم. لدى npm إعدادات للوكيل، وقد يمنع وكيل غير صحيح أو يتعذر الوصول إليه الاتصال بالسجل.

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