Перейти к содержимому

Статья 138 из 141

Гайды

Свой сервис systemd: unit-файл для Python, Node.js или бинарника, автозапуск и логи

Если бот или веб-приложение запущены через python3 app.py в screen, они упадут при первой ошибке и не поднимутся после перезагрузки. Служба systemd решает это: приложение стартует вместе с сервером, перезапускается при сбое, а логи собираются в одном месте. Примеры проверены на Ubuntu 24.04 (systemd 255), на 22.04 всё работает так же.

Возьмём простой Python-сервер, который читает порт из переменной окружения. Для Node.js или Go-бинарника меняется только строка ExecStart.

/opt/myapp/app.py
import os
from http.server import HTTPServer, BaseHTTPRequestHandler
class H(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.end_headers()
self.wfile.write(f"hello from {os.environ.get('APP_NAME', 'app')}\n".encode())
port = int(os.environ.get("PORT", "8000"))
print(f"listening on 127.0.0.1:{port}", flush=True)
HTTPServer(("127.0.0.1", port), H).serve_forever()

Не запускайте приложение от root. Создайте системного пользователя без входа в систему:

Окно терминала
useradd --system --no-create-home --shell /usr/sbin/nologin myapp
chown -R myapp:myapp /opt/myapp

Секреты (токены, пароли БД) держите в отдельном файле, а не в unit-файле:

Окно терминала
mkdir -p /etc/myapp
nano /etc/myapp/myapp.env
chmod 600 /etc/myapp/myapp.env
PORT=8000
APP_NAME=myapp
BOT_TOKEN=ВАШ_ТОКЕН

Формат: КЛЮЧ=значение, без export и без пробелов вокруг =.

Окно терминала
nano /etc/systemd/system/myapp.service
[Unit]
Description=My Python app
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=myapp
Group=myapp
WorkingDirectory=/opt/myapp
EnvironmentFile=/etc/myapp/myapp.env
ExecStart=/usr/bin/python3 /opt/myapp/app.py
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
Параметр Что делает
After, Wants запуск после того, как поднимется сеть
User, Group от чьего имени работает процесс
WorkingDirectory текущий каталог, от него считаются относительные пути
EnvironmentFile переменные из файла
ExecStart команда запуска, всегда с полным путём
Restart=on-failure перезапуск при падении. always перезапускает и при нормальном выходе
RestartSec пауза перед перезапуском
WantedBy=multi-user.target автозапуск при загрузке

ExecStart для других типов приложений:

# Python в виртуальном окружении
ExecStart=/opt/myapp/venv/bin/python /opt/myapp/app.py
# Node.js
ExecStart=/usr/bin/node /opt/myapp/server.js
# скомпилированный бинарник
ExecStart=/opt/myapp/myapp --config /etc/myapp/config.yaml

Узнать полный путь к программе: which node. Если Node.js установлен через nvm, путь будет внутри домашнего каталога пользователя, например /home/user/.nvm/versions/node/v22.11.0/bin/node. Подробнее про установку: Node.js, деплой Telegram-бота.

Окно терминала
systemd-analyze verify /etc/systemd/system/myapp.service
systemctl daemon-reload
systemctl enable --now myapp
systemctl status myapp

verify ничего не выводит, если ошибок нет. daemon-reload нужен после каждого изменения unit-файла. enable --now включает автозапуск и сразу запускает службу.

● myapp.service - My Python app
Loaded: loaded (/etc/systemd/system/myapp.service; enabled; preset: enabled)
Active: active (running) since Wed 2026-11-18 15:14:04 UTC; 1s ago
Main PID: 2508 (python3)
Tasks: 1 (limit: 2863)
Memory: 9.4M (peak: 9.6M)
Nov 18 15:14:04 server systemd[1]: Started myapp.service - My Python app.
Nov 18 15:14:05 server python3[2508]: listening on 127.0.0.1:8000

Основные команды:

Окно терминала
systemctl restart myapp # перезапуск после обновления кода
systemctl stop myapp # остановить
systemctl disable myapp # убрать из автозапуска
systemctl disable --now myapp # убрать из автозапуска и остановить

Всё, что приложение пишет в stdout и stderr, попадает в журнал:

Окно терминала
journalctl -u myapp -f # следить в реальном времени
journalctl -u myapp -n 100 # последние 100 строк
journalctl -u myapp --since "1 hour ago"
journalctl -u myapp -b # с последней загрузки

В Python выводите логи с flush=True или запускайте с python3 -u, иначе строки появятся в журнале с задержкой.

Проверка автоперезапуска: убиваем процесс и смотрим журнал.

Окно терминала
systemctl kill -s SIGKILL myapp
journalctl -u myapp -n 6
systemd[1]: myapp.service: Main process exited, code=killed, status=9/KILL
systemd[1]: myapp.service: Failed with result 'signal'.
systemd[1]: myapp.service: Scheduled restart job, restart counter is at 1.
systemd[1]: Started myapp.service - My Python app.
python3[2646]: listening on 127.0.0.1:8000

Через 5 секунд (RestartSec=5) служба снова работает. Счётчик перезапусков: systemctl show myapp -p NRestarts.

Unit-файлы из пакетов (/usr/lib/systemd/system/) редактировать нельзя: обновление их перезапишет. Для них и для своих служб есть drop-in файлы:

Окно терминала
systemctl edit myapp

Откроется редактор. Пишите строки между комментариями в начале файла:

[Service]
RestartSec=2
LimitNOFILE=65535

После сохранения systemd создаст /etc/systemd/system/myapp.service.d/override.conf и сам выполнит daemon-reload. Перезапустите службу. Итоговую конфигурацию со всеми дополнениями показывает systemctl cat myapp:

/etc/systemd/system/myapp.service.d/override.conf
[Service]
RestartSec=2
LimitNOFILE=65535

Чтобы заменить ExecStart, сначала очистите его пустой строкой, иначе systemd выдаст ошибку:

[Service]
ExecStart=
ExecStart=/opt/myapp/venv/bin/python /opt/myapp/app.py --debug

Отменить все дополнения: systemctl revert myapp.

Учтите приоритет переменных: значения из EnvironmentFile перекрывают Environment=. Мы проверили: Environment=APP_NAME=... в override.conf не сработал, пока такая же переменная была в env-файле. Меняйте переменные там, где они заданы.

Несколько строк ограничивают, что может сделать приложение, если его взломают. Добавьте их через systemctl edit myapp:

[Service]
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
ReadWritePaths=/opt/myapp/data
ProtectKernelTunables=yes
ProtectKernelModules=yes
ProtectControlGroups=yes
RestrictSUIDSGID=yes

ProtectSystem=strict делает всю файловую систему доступной только для чтения. Запись разрешена только в каталоги из ReadWritePaths. Попытка записать в /etc под такой защитой:

touch[2798]: /usr/bin/touch: cannot touch '/etc/x': Read-only file system

Если приложение после этого не стартует, смотрите journalctl -u myapp: обычно ему нужен ещё один каталог в ReadWritePaths. Оценить защиту помогает systemd-analyze security myapp. В нашем примере оценка улучшилась с 9.2 UNSAFE до 7.4 MEDIUM.

Для периодических задач создайте пару файлов: службу типа oneshot и таймер с тем же именем.

/etc/systemd/system/report.service
[Unit]
Description=Daily report
[Service]
Type=oneshot
User=myapp
ExecStart=/opt/myapp/report.sh
/etc/systemd/system/report.timer
[Unit]
Description=Run report daily at 03:00
[Timer]
OnCalendar=*-*-* 03:00:00
Persistent=true
RandomizedDelaySec=300
[Install]
WantedBy=timers.target
Окно терминала
systemctl daemon-reload
systemctl enable --now report.timer
systemctl list-timers report.timer
NEXT LEFT LAST PASSED UNIT ACTIVATES
Thu 2026-11-19 03:04:10 UTC 11h - - report.timer report.service

Persistent=true запустит пропущенное задание, если сервер был выключен в 03:00. Запустить вручную: systemctl start report.service, лог: journalctl -u report. Проверить расписание: systemd-analyze calendar "*:0/15". Сравнение с cron: Cron: задачи по расписанию.

Симптом Причина / решение
status=203/EXEC Неверный путь в ExecStart, нет права на выполнение или нет строки #! в скрипте
status=200/CHDIR Каталога из WorkingDirectory нет или у пользователя нет к нему доступа
Permission denied в журнале Файлы принадлежат root. Выполните chown -R myapp:myapp /opt/myapp
Изменения в unit-файле не применились Забыли systemctl daemon-reload и restart
Start request repeated too quickly Приложение падает сразу после старта. Причину ищите в journalctl -u myapp, затем systemctl reset-failed myapp
Нет переменных окружения Они заданы в .bashrc. Перенесите их в EnvironmentFile
Служба не запустилась после перезагрузки Не выполнили systemctl enable
Логи появляются с задержкой Буферизация вывода. Для Python: python3 -u или PYTHONUNBUFFERED=1