Статья 138 из 141
Гайды
Свой сервис systemd: unit-файл для Python, Node.js или бинарника, автозапуск и логи
Если бот или веб-приложение запущены через python3 app.py в screen, они упадут при первой ошибке и не поднимутся после перезагрузки. Служба systemd решает это: приложение стартует вместе с сервером, перезапускается при сбое, а логи собираются в одном месте. Примеры проверены на Ubuntu 24.04 (systemd 255), на 22.04 всё работает так же.
Пример приложения
Заголовок раздела «Пример приложения»Возьмём простой Python-сервер, который читает порт из переменной окружения. Для Node.js или Go-бинарника меняется только строка ExecStart.
import osfrom 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()Шаг 1. Отдельный пользователь
Заголовок раздела «Шаг 1. Отдельный пользователь»Не запускайте приложение от root. Создайте системного пользователя без входа в систему:
useradd --system --no-create-home --shell /usr/sbin/nologin myappchown -R myapp:myapp /opt/myappШаг 2. Файл с переменными
Заголовок раздела «Шаг 2. Файл с переменными»Секреты (токены, пароли БД) держите в отдельном файле, а не в unit-файле:
mkdir -p /etc/myappnano /etc/myapp/myapp.envchmod 600 /etc/myapp/myapp.envPORT=8000APP_NAME=myappBOT_TOKEN=ВАШ_ТОКЕНФормат: КЛЮЧ=значение, без export и без пробелов вокруг =.
Шаг 3. Unit-файл
Заголовок раздела «Шаг 3. Unit-файл»nano /etc/systemd/system/myapp.service[Unit]Description=My Python appAfter=network-online.targetWants=network-online.target
[Service]Type=simpleUser=myappGroup=myappWorkingDirectory=/opt/myappEnvironmentFile=/etc/myapp/myapp.envExecStart=/usr/bin/python3 /opt/myapp/app.pyRestart=on-failureRestartSec=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.jsExecStart=/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-бота.
Шаг 4. Запуск и автозапуск
Заголовок раздела «Шаг 4. Запуск и автозапуск»systemd-analyze verify /etc/systemd/system/myapp.servicesystemctl daemon-reloadsystemctl enable --now myappsystemctl status myappverify ничего не выводит, если ошибок нет. 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 # убрать из автозапуска и остановитьШаг 5. Логи
Заголовок раздела «Шаг 5. Логи»Всё, что приложение пишет в 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 myappjournalctl -u myapp -n 6systemd[1]: myapp.service: Main process exited, code=killed, status=9/KILLsystemd[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.
Изменение настроек через systemctl edit
Заголовок раздела «Изменение настроек через systemctl edit»Unit-файлы из пакетов (/usr/lib/systemd/system/) редактировать нельзя: обновление их перезапишет. Для них и для своих служб есть drop-in файлы:
systemctl edit myappОткроется редактор. Пишите строки между комментариями в начале файла:
[Service]RestartSec=2LimitNOFILE=65535После сохранения systemd создаст /etc/systemd/system/myapp.service.d/override.conf и сам выполнит daemon-reload. Перезапустите службу. Итоговую конфигурацию со всеми дополнениями показывает systemctl cat myapp:
[Service]RestartSec=2LimitNOFILE=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=yesPrivateTmp=yesProtectSystem=strictProtectHome=yesReadWritePaths=/opt/myapp/dataProtectKernelTunables=yesProtectKernelModules=yesProtectControlGroups=yesRestrictSUIDSGID=yesProtectSystem=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.
Таймер вместо cron
Заголовок раздела «Таймер вместо cron»Для периодических задач создайте пару файлов: службу типа oneshot и таймер с тем же именем.
[Unit]Description=Daily report
[Service]Type=oneshotUser=myappExecStart=/opt/myapp/report.sh[Unit]Description=Run report daily at 03:00
[Timer]OnCalendar=*-*-* 03:00:00Persistent=trueRandomizedDelaySec=300
[Install]WantedBy=timers.targetsystemctl daemon-reloadsystemctl enable --now report.timersystemctl list-timers report.timerNEXT LEFT LAST PASSED UNIT ACTIVATESThu 2026-11-19 03:04:10 UTC 11h - - report.timer report.servicePersistent=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 |