Restart= в systemd: как сделать, чтобы служба перезапускалась после сбоя
По умолчанию systemd не перезапускает упавшую программу: Restart=no. Строка Restart=on-failure в разделе [Service] заставит его запускать программу снова после сбоя, а RestartSec= задаст паузу перед новым запуском.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, что стоит сейчас. Вместо myapp — имя своей службы:
systemctl show myapp -p Restart -p RestartUSec. ОтветRestart=noзначит, что после сбоя служба останется остановленной. - Откройте файл-дополнение:
sudo systemctl edit myapp. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Откроется редактор nano. Между строками
### Anything between here…и### Edits below this comment will be discardedвпишите:
[Service]
Restart=on-failure
RestartSec=5- Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
- Перезапустите службу:
sudo systemctl restart myapp. - Проверьте:
systemctl show myapp -p Restart— должно бытьRestart=on-failure.
Если служба своя и файл лежит в /etc/systemd/system/myapp.service, можно вписать эти две строки прямо в раздел [Service] этого файла. Тогда после правки выполните sudo systemctl daemon-reload и sudo systemctl restart myapp.
Какое значение выбрать
| Значение | Когда перезапускает | Кому подходит |
|---|---|---|
no | не перезапускает — так по умолчанию | скриптам, которые выполняются один раз |
on-failure | программа вышла с ошибкой, её убил сигнал или она не ответила вовремя | сайтам, ботам, приложениям — справка systemd советует его для долгих служб |
on-abnormal | её убил сигнал или она не ответила вовремя, но не при выходе с ошибкой | программам, которые сами решают закончить работу |
always | после любого выхода, даже без ошибки | программам, которые должны работать без остановок |
on-success | только после выхода без ошибки | программам, которые после выхода без ошибки должны запуститься снова |
Выход без ошибки — это код 0 или остановка сигналом SIGHUP, SIGINT, SIGTERM или SIGPIPE. У служб с Type=oneshot выход без ошибки — только код 0. Любой другой код выхода — ошибка.
После sudo systemctl stop myapp служба не перезапускается ни при каком значении: systemd понимает, что вы остановили её сами. После перезагрузки сервера служба запустится, только если она включена командой sudo systemctl enable myapp.
Пауза перед перезапуском: RestartSec=
RestartSec= — сколько ждать после сбоя перед новым запуском. По умолчанию 100 миллисекунд. Значение пишут в секундах или с единицами:
| Строка | Пауза |
|---|---|
RestartSec=5 | 5 секунд |
RestartSec=500ms | полсекунды |
RestartSec=1min 30s | полторы минуты |
Пауза в несколько секунд полезна, когда программа падает из-за того, что ещё не готово другое: база данных не запустилась или сеть не поднялась.
Почему служба перестала перезапускаться
systemd ограничивает число запусков: по умолчанию не больше 5 за 10 секунд. Если служба упала и перезапустилась 5 раз за 10 секунд, systemd больше её не трогает и пишет в журнал Start request repeated too quickly. Как это исправить, рассказано на странице Start request repeated too quickly.
С паузой по умолчанию в 100 миллисекунд пять запусков проходят меньше чем за секунду. С RestartSec=5 за 10 секунд успевает пройти не больше трёх запусков, и предел не срабатывает: systemd будет перезапускать службу снова и снова.
По справке systemd предел задают в разделе [Unit]:
[Unit]
StartLimitIntervalSec=60
StartLimitBurst=10
[Service]
Restart=on-failure
RestartSec=5Здесь служба может запуститься 10 раз за 60 секунд. Значение StartLimitIntervalSec=0 отключает предел совсем. Предел считает все запуски службы, в том числе ваши команды systemctl start и systemctl restart.
Как проверить, что перезапуск работает
- Узнайте номер главного процесса службы:
systemctl show myapp -p MainPID --value- Завершите этот процесс принудительно, как при сбое. Вместо 12345 — номер из ответа:
sudo kill -9 12345- Подождите время из
RestartSec=и проверьте:systemctl status myapp. В строкеActive:сноваactive (running), а номер в строкеMain PID:новый. Выйти — клавиша Q.
Что программа писала перед сбоем, смотрите в журнале: sudo journalctl -u myapp -n 50 --no-pager. Автоперезапуск не лечит причину сбоя — он только запускает программу снова.
Ошибки и как их исправить
| Что видите | Что делать |
|---|---|
служба упала и не поднялась, хотя Restart=on-failure | проверьте, что настройка действует: systemctl show myapp -p Restart; после ручной правки файла нужен sudo systemctl daemon-reload |
Start request repeated too quickly | служба падает сразу после запуска — найдите причину |
| служба перезапускается по кругу | программа падает сразу после старта — причина в sudo journalctl -u myapp (как читать журнал) |
Источники
- Справка systemd.service(5) в Ubuntu 24.04 — на английском: значения Restart= и таблица причин выхода, выход без ошибки, RestartSec= и 100 мс по умолчанию, совет on-failure для долгих служб.
- Справка systemd.unit(5) в Ubuntu 24.04 — на английском: StartLimitIntervalSec= и StartLimitBurst= в разделе [Unit], значение 0.
- Справка systemd-system.conf(5) в Ubuntu 24.04 — на английском: по умолчанию 5 запусков за 10 секунд.
- Справка systemctl(1) в Ubuntu 24.04 — на английском: команды show, edit, reset-failed.
- Описание свойств systemd 255 — на английском: свойство MainPID.
Справка сверена с systemd 255 — эта версия стоит в Ubuntu 24.04.
Сверено 23 октября 2026 года.
Что почитать дальше
- Как создать службу systemdшаблон файла службы.
- systemctl editкак менять настройки службы из пакета.
- Job for … failedслужба не запускается.
- Настройки systemdвсе настройки служб.