Как создать службу systemd для своего приложения
Служба systemd запускает программу в фоне, следит за ней и запускает снова после перезагрузки сервера. Чтобы сделать службой своё приложение, создайте один файл в папке /etc/systemd/system, перечитайте настройки и включите службу.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Узнайте полный путь к программе, которая запускает приложение. Для Node.js:
command -v node, для Python в виртуальном окружении — путь вида/home/ivan/myapp/venv/bin/python. - Создайте файл службы. Вместо myapp — короткое имя латиницей:
sudo nano /etc/systemd/system/myapp.service. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Вставьте шаблон из раздела ниже и поменяйте в нём пользователя, папку и команду.
- Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
- Перечитайте настройки и включите службу:
sudo systemctl daemon-reload
sudo systemctl enable --now myapp- Проверьте:
systemctl status myapp. В строкеActive:должно бытьactive (running). Выйти из просмотра — клавиша Q.
Если в строке Active: написано failed, посмотрите, что программа написала перед остановкой: sudo journalctl -u myapp -n 50 --no-pager. Что значат коды сбоя — в таблице ниже.
Шаблон файла службы
[Unit]
Description=Приложение сайта
After=network.target
[Service]
Type=exec
User=ivan
WorkingDirectory=/home/ivan/myapp
ExecStart=/usr/bin/node app.js
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target| Строка | Что поменять |
|---|---|
Description= | короткое название — его видно в systemctl status и в журнале |
User= | ваш пользователь на сервере, не root (почему) |
WorkingDirectory= | папка приложения |
ExecStart= | полный путь к программе и её аргументы |
Restart=on-failure | перезапускать после сбоя (подробно) |
RestartSec=5 | ждать 5 секунд перед перезапуском |
WantedBy=multi-user.target | запускать при загрузке сервера — оставьте как есть |
Type=exec значит, что программа работает, пока работает служба. Для скрипта, который выполняется и заканчивается, нужен другой тип — тип службы.
Примеры строки ExecStart=:
| Приложение | Строка |
|---|---|
| Node.js | ExecStart=/usr/bin/node app.js |
| Python в venv | ExecStart=/home/ivan/myapp/venv/bin/python app.py |
| gunicorn в venv | ExecStart=/home/ivan/myapp/venv/bin/gunicorn -b 127.0.0.1:8000 app:app |
| свой скрипт bash | ExecStart=/home/ivan/myapp/start.sh |
Полный путь к программе
В ExecStart= первым словом пишут полный путь к программе: /usr/bin/node, а не node. Короткое имя без пути systemd ищет только в стандартных папках вроде /usr/bin и /usr/local/bin. Если Node.js поставлен через nvm, он лежит в домашней папке, и по имени systemd его не найдёт.
Полный путь покажет команда:
command -v nodeВставьте её ответ в ExecStart= вместо /usr/bin/node.
В ExecStart= нет перенаправлений
Строка ExecStart= — не командная строка bash. Знаки >, >>, | и & в ней не работают: systemd их не понимает. Вывод программы и так попадает в журнал службы — его покажет sudo journalctl -u myapp.
Если нужна именно команда bash, запустите bash явно:
ExecStart=/bin/bash -c 'cd /home/ivan/myapp && exec ./run.sh --port 8000'Или вынесите команды в отдельный скрипт и укажите его в ExecStart=. Скрипт начинается строкой #!/bin/bash, и его надо сделать исполняемым: chmod +x /home/ivan/myapp/start.sh. Как писать вывод не в журнал, а в свой файл, рассказано на странице Вывод службы в файл.
Как проверить службу
| Что проверить | Команда |
|---|---|
| работает ли служба сейчас | systemctl status myapp |
| что программа пишет — в реальном времени | sudo journalctl -u myapp -f (выход — Ctrl+C) |
| включён ли автозапуск | systemctl is-enabled myapp — должно быть enabled |
| нет ли ошибок в файле | sudo systemd-analyze verify /etc/systemd/system/myapp.service |
| запустится ли после перезагрузки | когда это не помешает посетителям, выполните sudo reboot, снова подключитесь и наберите systemctl status myapp |
Как изменить службу
- Откройте файл:
sudo nano /etc/systemd/system/myapp.serviceи поправьте строку. - Сохраните: Ctrl+O, Enter, Ctrl+X.
- Перечитайте настройки и перезапустите службу:
sudo systemctl daemon-reload
sudo systemctl restart myappБез daemon-reload systemd не увидит правку и предупредит об этом (что значит предупреждение). Чтобы убрать службу совсем, смотрите Как удалить службу.
Ошибки и как их исправить
Код сбоя видно в systemctl status myapp, в строке Main PID: или Process: — например, (code=exited, status=203/EXEC).
| Что видите | Что значит | Что делать |
|---|---|---|
status=203/EXEC | программа из ExecStart= не найдена или не запускается | проверьте путь командой ls -l и права: скрипту нужен chmod +x |
status=217/USER | пользователя из User= нет | проверьте имя: id ivan |
status=200/CHDIR | папки из WorkingDirectory= нет или к ней нет доступа | проверьте путь: ls -ld /home/ivan/myapp |
Unit myapp.service not found | файла нет или он назван иначе | имя файла должно заканчиваться на .service — подробно |
Job for myapp.service failed | программа упала при запуске | причина в журнале — подробно |
Start request repeated too quickly | программа падала много раз подряд | подробно |
Address already in use в журнале | порт занят другой программой | подробно |
Источники
- Справка systemd.service(5) в Ubuntu 24.04 — на английском: ExecStart и поиск программы по короткому имени, отсутствие перенаправлений и конвейеров, Type=exec, Restart, RestartSec.
- Справка systemd.exec(5) в Ubuntu 24.04 — на английском: User, WorkingDirectory, коды 200, 203 и 217.
- Справка systemd.unit(5) в Ubuntu 24.04 — на английском: Description, After, WantedBy.
- Справка systemctl(1) в Ubuntu 24.04 — на английском: enable --now, daemon-reload, is-enabled.
- Исходный код systemd 255: systemctl-show.c — как systemctl status показывает код сбоя.
- Исходный код systemd 255: exit-status.c — названия кодов EXEC, USER, CHDIR.
Справка сверена с systemd 255 — эта версия стоит в Ubuntu 24.04.
Сверено 23 октября 2026 года.
Что почитать дальше
- Настройки systemdгде лежат файлы служб и как их менять.
- Автоперезапуск службыRestart= и RestartSec=.
- Переменные окружения службыпорт, ключи, режим работы.
- Как разместить сайт на VPSnginx перед приложением.