كل المقالات التقنية

حل Restart Loop وstart-limit-hit في systemd

حل Restart Loop وstart-limit-hit في systemd عبر فحص Exit Code وJournal وUnit وDrop-in والتبعيات والصلاحيات وسياسة إعادة التشغيل وخطوات تحقق آمنة.

حل Restart Loop وstart-limit-hit في systemd

عندما تنهار خدمة فوراً ويعيد systemd تشغيلها باستمرار، يوقف Start Limit الحلقة. reset-failed يمسح العداد فقط؛ السبب الحقيقي يظهر في Exit Code أو Journal أو Dependency أو Permission أو إعداد Unit.

سجل Status وExit Code

سجل Result وExecMainStatus وتوقيت إعادة التشغيل قبل تعديل Unit.

systemctl status myapp.service --no-pager -l
systemctl show myapp.service -p Result -p ExecMainStatus -p NRestarts

اقرأ Journal من أول خطأ

السطر الأخير لا يكفي. افحص Boot الحالي والفترة قبل الوصول إلى Start Limit.

journalctl -u myapp.service -b --no-pager
journalctl -u myapp.service --since "30 min ago"

افحص Unit وOverride

قد يحول Restart=always خطأ الإعداد إلى Loop. راجع Unit المدمجة وكل Drop-in.

systemctl cat myapp.service
systemd-analyze verify /etc/systemd/system/myapp.service

امسح Limit بعد الإصلاح

بعد إصلاح الملف أو الصلاحيات أو Environment أو Dependency استخدم reset-failed ثم ابدأ مرة واحدة.

sudo systemctl daemon-reload
sudo systemctl reset-failed myapp.service
sudo systemctl start myapp.service

قائمة فحص systemd

  • سجل Status وExit Code.
  • اقرأ Journal للـBoot الحالي.
  • افحص Unit وDrop-in.
  • اختبر Dependency وPermission.
  • استخدم reset-failed بعد الإصلاح.

أسئلة شائعة

هل reset-failed يصلح الخدمة؟

لا؛ يمسح حالة Failed وعداد Rate Limit فقط.

لماذا يعمل الأمر يدوياً ويفشل مع systemd؟

قد يختلف User وEnvironment وWorkingDirectory وPATH والصلاحيات.

هل Restart=always مناسب؟

ليس لكل الأخطاء. on-failure مع Delay وStart Limit أكثر أماناً غالباً.

أدلة مرتبطة

المصادر الرسمية

آخر مراجعة للمصادر: ۳۰ سپتامبر ۲۰۲۶

كيف نتحقق من توقف Restart Loop؟

بعد إصلاح السبب استخدم reset-failed مرة واحدة ثم راقب NRestarts وJournal خلال مدة تتجاوز RestartSec وStartLimitIntervalSec. يجب أن تبقى العملية مستقرة ولا يظهر Exit Code جديد.

systemctl reset-failed myapp.service
systemctl start myapp.service
systemctl show myapp.service -p ActiveState -p NRestarts -p ExecMainStatus

المخاطر والتراجع

رفع StartLimit أو جعل Restart=always قد يحول الخطأ إلى Loop مستمر. احفظ Unit وDrop-in، اختبر systemd-analyze verify، وأعد الملف السابق إذا فشل التشغيل.

سيناريو مجهول

كانت الخدمة تبدأ ثم تتوقف بسبب Permission في مسار البيانات. كشف Journal السبب؛ تم تصحيح الملكية بدلاً من زيادة Restart، وبقي NRestarts ثابتاً بعد الاختبار.