تطبيق Node.js يتوقف بعد إعادة تشغيل الخادم: خدمة systemd
باختصار: إذا كان الخادم الخلفي لتطبيقك أو نظام الحجز مكتوباً بـ Node.js ويعمل لأن أحدهم كتب node server.js في الطرفية، فسيتوقف عند أول خطأ قاتل أو أول إعادة تشغيل للخادم، ولن يعيده أحد. الحل المستقر على خوادم Linux الحديثة هو ملف خدمة systemd: يشغّل التطبيق عند الإقلاع، ويعيد تشغيله إذا انهار بفضل Restart=on-failure، ويحدد المستخدم ومجلد العمل وملف المتغيرات. ثم تتابع حالته وسجلاته بأوامر systemctl بدل البحث عن نافذة طرفية منسية.
كيف تبدأ المشكلة
شركة ناشئة في عمّان بنت تطبيق توصيل أو تطبيق حجز لصالونات، والواجهة الخلفية خادم Node.js صغير على خادم خاص. في الأسابيع الأولى شغّله المطور يدوياً، أو داخل جلسة طرفية تبقى مفتوحة، أو بأمر يضعه في الخلفية. يعمل كل شيء، حتى يأتي يوم من هذه الأيام:
- مزود الاستضافة يعيد تشغيل الخادم لتحديث أمني، فيعود الخادم دون التطبيق.
- طلب غير متوقع يسبب خطأ لم يُعالَج، فتنتهي العملية.
- المطور الذي يعرف كيف شُغّل التطبيق ترك الشركة.
النتيجة واحدة: التطبيق على هواتف الزبائن يعرض «تعذر الاتصال»، ولا أحد يعرف إلا عندما تتراكم الشكاوى. وقد يمر وقت طويل قبل ذلك إذا حدث التوقف ليلاً أو في عطلة نهاية الأسبوع، حين لا يراقب أحد من الفريق.
لماذا لا يكفي التشغيل اليدوي
العملية التي تبدأها من طرفية مرتبطة بك أنت وبجلستك. لا شيء في النظام يعرف أنها مهمة، ولا شيء يراقبها. إذا انتهت، انتهت. وإذا أعيد تشغيل الخادم، فلا يوجد ما يخبر النظام بأن عليه إعادتها.
مدير الخدمات في النظام، وهو systemd على معظم توزيعات Linux الحالية، مصمم لهذه الوظيفة تحديداً: تعرّفه بخدمتك مرة واحدة، فيبدأها عند الإقلاع، ويراقبها، ويعيدها إذا سقطت، ويجمع مخرجاتها في السجل.
ملف خدمة بسيط
أنشئ ملفاً باسم التطبيق في مجلد خدمات النظام، مثلاً booking-api.service:
[Unit]
Description=Booking API
After=network.target
[Service]
Type=exec
User=bookingapp
WorkingDirectory=/srv/booking-api
EnvironmentFile=/srv/booking-api/.env
ExecStart=/usr/bin/node server.js
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
ما معنى كل سطر، بحسب توثيق systemd:
- ExecStart هو الأمر الذي يشغّل التطبيق. استخدم المسار الكامل لبرنامج node، لأن الخدمة لا تقرأ إعدادات طرفيتك.
- Type: يذكر التوثيق أن simple هي الافتراضية إذا وُجد ExecStart، وأن exec غالباً الخيار الأفضل. ويوصي باستخدام notify أو simple حيث أمكن بدل الأنواع التي تحتاج ملفات PID.
- User يحدد مستخدم النظام الذي تعمل به العمليات. لا تشغّل التطبيق كمستخدم root، بل أنشئ مستخدماً خاصاً به.
- WorkingDirectory يحدد مجلد العمل للعمليات. ويذكر التوثيق أنه إذا لم يُحدد فالافتراضي هو المجلد الجذر عند تشغيل systemd كمدير للنظام، وهذا سبب شائع لتطبيق لا يجد ملفاته.
- EnvironmentFile يقرأ متغيرات البيئة من ملف نصي، سطر لكل متغير، ويتجاهل الأسطر الفارغة وأسطر التعليق. ضع فيه منفذ التطبيق وعنوان قاعدة البيانات بدل كتابتها في ملف الخدمة.
إعادة التشغيل التلقائي
بحسب التوثيق، الخيار Restart يحدد إن كانت الخدمة ستُعاد عند خروج العملية أو قتلها أو تجاوز مهلة ما، والقيمة الافتراضية no، أي لا إعادة. ومع on-failure تُعاد الخدمة إذا خرجت العملية برمز خروج غير صفري، أو أُنهيت بإشارة غير الإشارات الاعتيادية، أو انتهت مهلة عملية مثل إعادة التحميل. ويقول التوثيق إن on-failure هو الخيار الموصى به للخدمات طويلة التشغيل لزيادة الاعتمادية عبر محاولة التعافي التلقائي من الأخطاء.
وRestartSec يحدد مدة الانتظار قبل إعادة التشغيل، والافتراضي 100 ملي ثانية. انتظار بضع ثوانٍ يعطي قاعدة البيانات أو الخدمة الخارجية فرصة للعودة. ويذكر التوثيق أيضاً أن إعادة التشغيل تخضع لحد معدل البدء المضبوط بـ StartLimitIntervalSec وStartLimitBurst، فإذا انهار التطبيق مرات كثيرة متتالية، يتوقف النظام عن المحاولة. هذا مقصود: تطبيق ينهار كل ثانيتين يحتاج إصلاحاً، لا إعادة لا نهائية.
ويوضح التوثيق أنه عندما يكون توقف العملية نتيجة عملية من systemd نفسه، مثل أمر إيقاف أو إعادة تشغيل، فلن تُعاد الخدمة تلقائياً. أي أنك تستطيع إيقافها متعمداً دون أن تعود رغماً عنك.
التفعيل والمتابعة
بعد إنشاء الملف أو تعديله:
- أعد تحميل إعدادات مدير الخدمات بأمر daemon-reload.
- فعّل الخدمة وشغّلها: الأمر enable ينشئ الروابط المكتوبة في قسم Install، فتبدأ الخدمة عند الإقلاع.
- افحص الحالة بأمر status، أو بأمر is-active الذي يعيد رمز خروج 0 إذا كانت الخدمة تعمل، وهذا مفيد في سكربتات المراقبة.
- اقرأ مخرجات التطبيق في سجل النظام بدل ملفات تكتبها يدوياً.
ثم اختبر ما يهمك فعلاً: أعد تشغيل الخادم كله، وتأكد أن التطبيق عاد دون تدخل. وأوقف العملية بالقوة من الطرفية، وتأكد أنها عادت بعد ثوانٍ.
إعادة التشغيل ليست إصلاحاً
ملف الخدمة يخفف أثر الانهيار، لكنه لا يعالج سببه. إذا رأيت في السجل أن الخدمة تُعاد عدة مرات في اليوم، فهناك خطأ في الكود أو تسرب في الذاكرة أو اتصال يُقطع. استخدم السجل لمعرفة آخر ما كتبه التطبيق قبل كل توقف، وعالج الأخطاء غير الملتقطة بدل الاعتماد على العودة التلقائية. وأضف مراقبة خارجية بسيطة تطلب صفحة صحة من التطبيق كل دقيقة، وتنبهك إذا لم تُجب، لأن الخدمة قد تعمل والتطبيق عالق.
ماذا عن أدوات إدارة العمليات الخاصة بـ Node
بعض الفرق تستخدم مدير عمليات مخصصاً لـ Node بدلاً من ذلك أو فوقه. لا بأس بذلك، بشرط أن يكون هو نفسه مضبوطاً ليعود بعد إعادة تشغيل الخادم، وإلا عادت المشكلة نفسها بطبقة إضافية. لخادم واحد وتطبيق أو اثنين، ملف systemd واحد أبسط وأقل اعتماداً على أدوات إضافية، ويفهمه أي مسؤول خوادم يأتي بعدك.
مثال توضيحي: تطبيق حجز يعود وحده
هذا مثال توضيحي لطريقة المعالجة، وليس حالة حقيقية. شركة صغيرة تدير تطبيق حجز لصالونات، وخادمه الخلفي يتوقف بعد كل إعادة تشغيل للخادم. ينشئ المطور مستخدماً خاصاً بالتطبيق، ويكتب ملف خدمة فيه مجلد العمل وملف المتغيرات وRestart=on-failure مع انتظار 5 ثوانٍ، ثم يفعّلها. يعيد تشغيل الخادم فيعود التطبيق وحده. بعد أسبوع يرى في السجل ثلاث عمليات إعادة بسبب خطأ في معالجة طلب معين، فيصلحه في الكود.
أسئلة شائعة
ليش تطبيق Node بيوقف لما السيرفر يعمل ريستارت؟
لأنه شُغّل يدوياً من طرفية، ولا شيء في النظام يعرف أن عليه إعادة تشغيله عند الإقلاع.
شو الفرق بين on-failure وalways؟
on-failure يعيد الخدمة عند الخروج بخطأ أو إشارة غير اعتيادية، ويوصي به التوثيق للخدمات طويلة التشغيل. always يعيدها في كل الحالات تقريباً.
التطبيق بيشتغل يدوي وبالخدمة ما بيلاقي ملفاته، ليش؟
غالباً لأن مجلد العمل غير محدد في ملف الخدمة. أضف WorkingDirectory ومسار node الكامل.
وين بشوف أخطاء التطبيق؟
في سجل النظام الخاص بالخدمة، ومع أمر status الذي يعرض آخر الأسطر وحالة الخدمة.
إذا كان الخادم الخلفي لتطبيقك يتوقف ولا يعود إلا بتدخل يدوي، حدثنا عنه ونجعله يعمل كخدمة مستقرة تعود وحدها ونراقب أسباب توقفه.