Lorixen.
AR

Address already in use: من يشغل منفذ خادمك وكيف تحل التعارض

باختصار: رسالة «Address already in use»، أو EADDRINUSE في Node.js، تعني أن برنامجاً آخر على الخادم نفسه يشغل المنفذ الذي تحاول تشغيل خدمتك عليه، فيفشل تشغيلها. الحل ليس إعادة تشغيل الخادم على أمل أن تختفي المشكلة، بل أن تعرف أي برنامج يمسك المنفذ بأمر ss -ltnp، ثم تقرر: توقفه وتعطله إن كان زائداً، أو تنقل إحدى الخدمتين إلى منفذ آخر، أو تجعل إحداهما خلف الأخرى كوكيل.

كيف تظهر المشكلة

مطور يعمل لصالح سلسلة مخابز في عمّان ينقل موقعها إلى خادم افتراضي جديد. ثبّت nginx ليقدم الموقع، لكنه عند تشغيله يرى رسالة فشل، وفي السجل سطراً يذكر أن الربط على المنفذ 80 فشل لأن العنوان مستخدم. وفي مشروع آخر، يشغل تطبيق Node.js للطلبات على المنفذ 3000 فيتوقف فوراً برسالة EADDRINUSE.

في الحالتين لم يتلف شيء. الخادم يعمل، والإعداد صحيح غالباً. المشكلة أن مكاناً واحداً يريده برنامجان.

ماذا تعني الرسالة بالضبط

يشرح توثيق Node.js الخطأ EADDRINUSE بأنه فشل في ربط خادم، سواء net أو http أو https، بعنوان محلي، لأن خادماً آخر على النظام المحلي يشغل هذا العنوان بالفعل. والعنوان هنا يعني مجموعة عنوان IP ورقم المنفذ.

كل منفذ على كل عنوان يمكن أن يستمع عليه برنامج واحد في الوقت نفسه في الحالة العادية. إذا كان Apache يستمع على المنفذ 80، فلن يستطيع nginx أن يستمع عليه أيضاً، والعكس.

الخطوة الأولى: اعرف من يشغل المنفذ

أداة ss موجودة على أغلب توزيعات لينكس الحديثة. بحسب دليلها:

  • الخيار ‎-l‎ يعرض المقابس المستمعة فقط.
  • الخيار ‎-t‎ يعرض مقابس TCP.
  • الخيار ‎-n‎ لا يحاول تحويل الأرقام إلى أسماء خدمات.
  • الخيار ‎-p‎ يعرض العمليات التي تستخدم المقابس.

اجمعها في أمر واحد، وشغّله بصلاحيات المدير حتى ترى أسماء العمليات التي لا تملكها:

sudo ss -ltnp | grep ':80 '

سترى سطراً يذكر العنوان والمنفذ واسم البرنامج ورقم عمليته. هذه الخطوة وحدها تحول المشكلة من لغز إلى سؤال واضح: ماذا يفعل هذا البرنامج هنا؟

الأسباب الشائعة

خادم ويب آخر مثبت مسبقاً: بعض صور الخوادم الجاهزة تأتي مع Apache مثبتاً ومفعلاً. عندما تثبت nginx فوقه، يجد المنفذ 80 مشغولاً. وأحياناً تثبت لوحة تحكم استضافة خادم ويب خاصاً بها.

نسخة قديمة من تطبيقك ما زالت تعمل: شغلت تطبيق Node.js يدوياً في جلسة سابقة، أو بأداة إدارة عمليات، ثم حاولت تشغيله من جديد كخدمة. النسخة القديمة ما زالت تمسك المنفذ.

خدمتان تريدان المنفذ نفسه بالإعداد الافتراضي: تطبيقان على Node.js كلاهما مضبوط على 3000، أو أداة مراقبة تأخذ منفذاً يستخدمه تطبيقك.

الخدمة نفسها تعمل مرتين: مثلاً ملف إعداد مكرر في nginx يحاول الاستماع على العنوان نفسه بطريقتين.

إذا لم يظهر أي برنامج يمسك المنفذ

أحياناً تشغل الأمر فلا ترى شيئاً، ومع ذلك تبقى الرسالة. أسباب تستحق الفحص:

  • نسيت صلاحيات المدير: دون sudo قد لا تظهر أسماء العمليات التي لا تملكها، فيبدو السطر ناقصاً.
  • المنفذ مكتوب بشكل آخر: قد يكون البرنامج يستمع على عنوان IPv6 مثل ‎[::]:80‎، فلا يطابق بحثك إذا كتبته بطريقة ضيقة. ابحث عن رقم المنفذ وحده.
  • الإعداد نفسه يطلب المنفذ مرتين: في nginx، ملفان في مجلد المواقع المفعلة يستمعان على العنوان نفسه بإعدادات متعارضة. شغّل nginx -t ليفحص الإعداد قبل التشغيل.
  • حاوية تحجز المنفذ: إذا كنت تستخدم حاويات، فقد تكون إحداها قد نشرت المنفذ نفسه على الخادم.

وإذا ظهر الخطأ لحظة إعادة تشغيل التطبيق فقط ثم اختفى بعد ثوانٍ، فالأرجح أن النسخة القديمة لم تكن قد أغلقت بعد. اجعل أداة التشغيل تنتظر توقف النسخة القديمة قبل تشغيل الجديدة.

الخطوة الثانية: قرر ماذا تفعل

إذا كان البرنامج زائداً: مثل Apache لا تحتاجه، فأوقفه وعطله حتى لا يعود بعد إعادة التشغيل. يذكر دليل systemctl أن أمر disable يزيل روابط تفعيل الوحدة، لكنه لا يوقف الوحدة العاملة ضمنياً، وأن الخيار ‎--now‎ يجمع الإيقاف مع التعطيل:

sudo systemctl disable --now apache2

اسم الخدمة يختلف بين التوزيعات، فتأكد منه أولاً. وإذا كانت حزمة ما تعيد تفعيل الخدمة، فيذكر الدليل أمر mask الذي يربط ملف الوحدة بـ ‎/dev/null‎ فيستحيل تشغيلها.

إذا كانت نسخة قديمة من تطبيقك: أوقفها من الأداة التي شغلتها بها، لا بقتل العملية عشوائياً، ثم اجعل للتطبيق طريقة تشغيل واحدة فقط، كخدمة systemd مثلاً، حتى لا تتكرر المشكلة.

إذا كنت تحتاج الخدمتين: انقل إحداهما إلى منفذ آخر. وإذا كانت الخدمتان تقدمان مواقع على الويب، فالأفضل أن يستمع nginx وحده على 80 و443، ويمرر الطلبات إلى التطبيقات الأخرى على منافذ داخلية مثل 3000 و3001.

لماذا لا تنقل كل شيء إلى منفذ عشوائي

قد يغريك أن تشغل nginx على 8080 لأن 80 مشغول. سيعمل الموقع، لكن على رابط فيه رقم المنفذ، وهذا لا يناسب موقع شركة. الزوار والمتصفحات ومحركات البحث تتوقع 80 لـ http و443 لـ https. حل التعارض من جذره أفضل من الالتفاف عليه.

اجعل التطبيقات الداخلية لا تُرى من الخارج

عندما تشغل تطبيق Node.js خلف nginx، اجعله يستمع على العنوان المحلي 127.0.0.1 لا على كل العناوين. هكذا لا يصل إليه أحد مباشرة من الإنترنت متجاوزاً nginx، ولا يتعارض مع خدمة أخرى تستمع على عنوان مختلف. والأمر ss -ltnp نفسه يعرض لك على أي عنوان يستمع كل برنامج، فإذا رأيت 0.0.0.0 بجانب منفذ تطبيق داخلي، فهو مكشوف للعالم.

مثال توضيحي: موقع مخابز على خادم جديد

هذا مثال توضيحي لطريقة المعالجة، وليس حالة حقيقية. مطور المخابز يرى فشل nginx على المنفذ 80. يشغل ss -ltnp فيجد أن Apache يستمع على 80، وقد جاء مع صورة الخادم. لا يحتاجه، فيوقفه ويعطله بأمر واحد، ثم يشغل nginx بنجاح. بعدها يشغل تطبيق الطلبات على 3000 على العنوان المحلي فقط، ويجعل nginx يمرر إليه مسار الطلبات.

أسئلة شائعة

شو معنى Address already in use لما أشغل السيرفر؟

يعني أن برنامجاً آخر على الخادم يستمع على المنفذ نفسه، فلا تستطيع خدمتك أن تأخذه.

كيف بعرف مين ماسك البورت 80؟

شغّل sudo ss -ltnp وابحث عن ‎:80‎. سيظهر اسم البرنامج ورقم عمليته.

وقفت Apache ورجع اشتغل بعد إعادة التشغيل، ليش؟

لأن الإيقاف وحده لا يعطل التشغيل التلقائي. استخدم systemctl disable --now لإيقافه وتعطيله معاً.

هل بشغل الموقع على بورت 8080 وبخلص؟

لا يناسب موقع شركة لأن الرقم سيظهر في الرابط. اجعل nginx وحده على 80 و443 ومرر الباقي إلى منافذ داخلية.

إذا كانت خدمات موقعك تتعارض على الخادم ولا تعرف ترتيبها الصحيح، احكِ لنا ونرتب معك من يستمع على ماذا قبل أن ينقطع الموقع.

المصادر

WhatsAppاحجز مكالمة