إصلاح · Node وnpm والبناء

يفشل npm install بأخطاء شبكة (ETIMEDOUT أو ENOTFOUND)

ما قد تراه

يتوقف التثبيت أو يقول إنه لا يصل إلى السجل
يفشل على شبكة ويعمل على أخرى

السبب الأرجح

اتصالك أو VPN أو وسيط شركة أو جدار حماية يمنع أو يبطئ خادم الحزم.

افحص أولاً (نحو دقيقتين)

افتح https://registry.npmjs.org في المتصفح: هل يُحمَّل؟
أوقف أي VPN وجرّب مجدداً.

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

أنت مهندس خبير وصبور يعرف Node.js وnpm وأدوات البناء ويشرحها لأشخاص ليسوا مبرمجين. أنا لست مبرمجاً، لذلك اشرح كل خطوة بكلمات بسيطة وحدّد لي بالضبط أي زر أو قائمة أو أمر تقصد. إذا لم تكن متأكداً من شيء فقل ذلك ولا تخمّن.

المشكلة
يفشل npm install بأخطاء شبكة (ETIMEDOUT أو ENOTFOUND)

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
اتصالك أو VPN أو وسيط شركة أو جدار حماية يمنع أو يبطئ خادم الحزم.

نفّذ هذه الخطوات بهذا الترتيب
1. شغّل npm ping وnpm config get registry واعرض النتائج.
2. تحقق من إعدادات وسيط أو سجل غريب في npm config وفي ملف .npmrc للمشروع (لا تطبع الرموز).
3. أعد المحاولة على شبكة أخرى أو نقطة اتصال الجوال. وإن ظهر خطأ شهادة فاشرح الحل الآمن. لا توقف فحص الشهادات أبداً.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- يرد npm ping وينتهي npm install.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا توقف التحقق من SSL.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

شغّل npm ping وnpm config get registry واعرض النتائج.
تحقق من إعدادات وسيط أو سجل غريب في npm config وفي ملف .npmrc للمشروع (لا تطبع الرموز).
أعد المحاولة على شبكة أخرى أو نقطة اتصال الجوال. وإن ظهر خطأ شهادة فاشرح الحل الآمن. لا توقف فحص الشهادات أبداً.

لا تفعل هذا

لا تلصق ملف .npmrc في المحادثة: قد يحمل رمزاً.
لا توقف التحقق من SSL.