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

رفض localhost الاتصال (ERR_CONNECTION_REFUSED)

ما قد تراه

لا يفتح المتصفح localhost:3000
تبدو الطرفية سليمة

السبب الأرجح

خادم التطوير لا يعمل أو يعمل على منفذ آخر أو يستمع على عنوان مختلف.

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

انظر إلى الطرفية: هل تقول Ready وتطبع عنواناً؟ استخدم هذا العنوان بالضبط.
هل ما زالت الطرفية تعمل أم توقفت بخطأ؟

أمر الإصلاح

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

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

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

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

لغة الأمر

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

المشكلة
رفض localhost الاتصال (ERR_CONNECTION_REFUSED)

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

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

السبب الأرجح
خادم التطوير لا يعمل أو يعمل على منفذ آخر أو يستمع على عنوان مختلف.

نفّذ هذه الخطوات بهذا الترتيب
1. تحقق هل خادم التطوير يعمل وأي عنوان ومنفذ يطبع.
2. جرّب localhost و127.0.0.1 والمنفذ المطبوع؛ وإن كان لا بد أن يصل إليه هاتف فاشرح عنوان الشبكة المحلية وخيار المضيف.
3. إن توقف فاقرأ آخر خطأ وأصلحه.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- يعرض المتصفح التطبيق عند العنوان المطبوع.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

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

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

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

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

الخطوات

تحقق هل خادم التطوير يعمل وأي عنوان ومنفذ يطبع.
جرّب localhost و127.0.0.1 والمنفذ المطبوع؛ وإن كان لا بد أن يصل إليه هاتف فاشرح عنوان الشبكة المحلية وخيار المضيف.
إن توقف فاقرأ آخر خطأ وأصلحه.

لا تفعل هذا

لا تشارك رابط localhost مع العملاء؛ انشر معاينة بدلاً من ذلك.
لا تفتح منافذ الجدار الناري للإنترنت.