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

Restart= в systemd: как сделать, чтобы служба перезапускалась после сбоя

По умолчанию systemd не перезапускает упавшую программу: Restart=no. Строка Restart=on-failure в разделе [Service] заставит его запускать программу снова после сбоя, а RestartSec= задаст паузу перед новым запуском.

≈ 5 мин чтения
Содержание 8

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите, что стоит сейчас. Вместо myapp — имя своей службы: systemctl show myapp -p Restart -p RestartUSec. Ответ Restart=no значит, что после сбоя служба останется остановленной.
  3. Откройте файл-дополнение: sudo systemctl edit myapp. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  4. Откроется редактор nano. Между строками ### Anything between here… и ### Edits below this comment will be discarded впишите:
[Service]
Restart=on-failure
RestartSec=5
  1. Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
  2. Перезапустите службу: sudo systemctl restart myapp.
  3. Проверьте: 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=55 секунд
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.

Как проверить, что перезапуск работает

  1. Узнайте номер главного процесса службы:
systemctl show myapp -p MainPID --value
  1. Завершите этот процесс принудительно, как при сбое. Вместо 12345 — номер из ответа:
sudo kill -9 12345
  1. Подождите время из 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 255 — эта версия стоит в Ubuntu 24.04.

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

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

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