همه مقالات تخصصی

نوشتن یک سرویس systemd برای اپلیکیشن: ری‌استارت، لاگ و پیش‌فرض‌های امن

برای یک اپلیکیشن سرویس systemd بسازید با کاربر اختصاصی، سیاست ری‌استارت، فایل متغیر محیطی، لاگ و سخت‌سازی پایه و آن را بسنجید.

نوشتن یک سرویس systemd برای اپلیکیشن: ری‌استارت، لاگ و پیش‌فرض‌های امن

اجرای اپ در ترمینال یا نشست screen با خروج شما یا ری‌بوت سرور متوقف می‌شود. سرویس systemd این را درست می‌کند: اپ را در بوت اجرا می‌کند، بعد از کرش دوباره بالا می‌آورد، با کاربر محدود اجرا می‌کند و خروجی را به journal می‌فرستد. این راهنما یک فایل unit کوچک و امن می‌سازد، نشان می‌دهد چطور بارگذاری و بررسی شود و اشتباه‌هایی را که باعث «دستی کار می‌کند ولی به‌صورت سرویس نه» می‌شوند فهرست می‌کند.

۱. یک فایل unit حداقلی

اول یک کاربر اختصاصی بسازید، بعد فایل unit را در /etc/systemd/system/ بنویسید. مثال زیر یک اپ Node را اجرا می‌کند اما ساختار برای هر برنامه‌ای می‌خورد:

# /etc/systemd/system/myapp.service
[Unit]
Description=My web app
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=myapp
Group=myapp
WorkingDirectory=/opt/myapp
EnvironmentFile=/etc/myapp.env
ExecStart=/usr/bin/node /opt/myapp/server.js
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target

در ExecStart همیشه مسیر مطلق بنویسید، چون systemd از PATH شل شما استفاده نمی‌کند. رازها را در فایل متغیر محیطی با دسترسی محدود نگه دارید نه در خود unit.

۲. بارگذاری، بررسی و شروع

بعد از هر تغییر در فایل unit، systemd را reload کنید تا فایل‌ها را دوباره بخواند. سپس پیش از شروع نحو را بسنجید:

sudo systemctl daemon-reload
sudo systemd-analyze verify /etc/systemd/system/myapp.service
sudo systemctl enable --now myapp
systemctl status myapp --no-pager

enable --now سرویس را همین حالا و در هر بوت اجرا می‌کند.

۳. خواندن لاگ و وضعیت

journal خروجی استاندارد و خطاها را جمع می‌کند، پس در موارد ساده به فایل لاگ جدا نیاز ندارید:

journalctl -u myapp -n 50 --no-pager
journalctl -u myapp -f
systemctl show myapp -p ExecMainStatus -p NRestarts
sudo systemctl cat myapp

شمارندهٔ ری‌استارت کمک می‌کند حلقهٔ کرشی را ببینید که وگرنه مثل سرویس سالم به نظر می‌رسد.

۴. سیاست ری‌استارت و وابستگی‌ها

Restart=on-failure بعد از کرش ری‌استارت می‌کند ولی بعد از توقف عادی نه. RestartSec را اضافه کنید تا اپ خراب CPU را نکوبد. برای وابستگی‌های واقعی مثل شبکه یا پایگاه داده از After= و Wants= استفاده کنید. اگر اپ منتظر پایگاه داده است، خودش دوباره تلاش کند و فقط به ترتیب شروع تکیه نکند. برای زمان‌بندی کارها به جای سرویس‌های همیشه‌فعال راهنمای تایمرهای systemd را ببینید.

۵. اشتباه‌های رایج

خطاهای معمول در زیر آمده‌اند. رفع آن‌ها بیشتر شکست‌هایی را که فقط زیر systemd پیش می‌آیند حل می‌کند:

ExecStart=node server.js      # relative path, may not be found
User=root                    # runs everything as root
Restart=always               # hides a crash loop without RestartSec

همچنین پوشهٔ کاری، مالکیت فایل‌ها و دسترسی خواندن کاربر به فایل‌های اپ را بررسی کنید. متغیرهای محیطی که در شل خود گذاشته‌اید در سرویس وجود ندارند.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید اپی (ساختگی) با node server.js در ترمینال کار می‌کند ولی به‌صورت سرویس شکست می‌خورد. journal «node: command not found» نشان می‌دهد چون unit دستور نسبی داشت. تغییر به مسیر مطلق و اجرای daemon-reload حلش می‌کند. حلقهٔ ری‌استارت دوم معلوم می‌شود فایل محیطی گمشده بوده که در خروجی status دیده می‌شود.

۷. اشتباه‌های رایج

  • فراموشی daemon-reload بعد از ویرایش unit.
  • مسیر نسبی در ExecStart.
  • اجرای سرویس با root بدون نیاز.
  • گذاشتن رازها مستقیم در فایل unit.
  • Restart=always بدون RestartSec.
  • فرض وجود متغیرهای محیطی شل.

۸. پرسش‌های متداول

فایل unit خودم را کجا بگذارم؟ در /etc/systemd/system/. بسته‌ها از /usr/lib/systemd/system/ استفاده می‌کنند.

چطور بفهمم چرا شکست خورده؟ systemctl status و journalctl -u را با نام unit اجرا کنید.

فرق enable و start چیست؟ start همین حالا اجرا می‌کند. enable آن را در بوت فعال می‌کند. enable –now هر دو را انجام می‌دهد.

می‌توانم unit بسته را امن تغییر دهم؟ به جای ویرایش اصل، با systemctl edit یک drop-in بسازید.

۹. چک‌لیست سریع

  1. کاربر اختصاصی بسازید.
  2. unit را با مسیرهای مطلق بنویسید.
  3. daemon-reload بزنید.
  4. systemd-analyze verify اجرا کنید.
  5. سرویس را enable و start کنید.
  6. status و journal را ببینید.
  7. ری‌بوت یا کرش اجباری را تست کنید.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

systemd.service manual · systemd.unit manual · systemd-analyze manual · journalctl manual