Поиск
Справочник

Как создать службу systemd для своего приложения

Служба systemd запускает программу в фоне, следит за ней и запускает снова после перезагрузки сервера. Чтобы сделать службой своё приложение, создайте один файл в папке /etc/systemd/system, перечитайте настройки и включите службу.

≈ 6 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Узнайте полный путь к программе, которая запускает приложение. Для Node.js: command -v node, для Python в виртуальном окружении — путь вида /home/ivan/myapp/venv/bin/python.
  3. Создайте файл службы. Вместо myapp — короткое имя латиницей: sudo nano /etc/systemd/system/myapp.service. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  4. Вставьте шаблон из раздела ниже и поменяйте в нём пользователя, папку и команду.
  5. Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
  6. Перечитайте настройки и включите службу:
sudo systemctl daemon-reload
sudo systemctl enable --now myapp
  1. Проверьте: 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.jsExecStart=/usr/bin/node app.js
Python в venvExecStart=/home/ivan/myapp/venv/bin/python app.py
gunicorn в venvExecStart=/home/ivan/myapp/venv/bin/gunicorn -b 127.0.0.1:8000 app:app
свой скрипт bashExecStart=/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

Как изменить службу

  1. Откройте файл: sudo nano /etc/systemd/system/myapp.service и поправьте строку.
  2. Сохраните: Ctrl+O, Enter, Ctrl+X.
  3. Перечитайте настройки и перезапустите службу:
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 255 — эта версия стоит в Ubuntu 24.04.

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше