Type= в systemd: simple, exec, forking, oneshot и notify — какой выбрать
Type= говорит systemd, как понять, что программа запустилась. Для сайта или бота на Node.js и Python ставьте Type=exec, для скрипта, который выполняется и заканчивается, — Type=oneshot. Из-за неверного типа служба сразу останавливается или висит на запуске.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите тип службы. Вместо myapp — имя своей службы:
systemctl show myapp -p Type. - Выберите тип по таблице ниже.
- Если тип нужно поменять:
sudo systemctl edit myapp. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. Откроется редактор nano. Между строками### Anything between here…и### Edits below this comment will be discardedвпишите:
[Service]
Type=exec- Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
- Перезапустите службу:
sudo systemctl restart myappи проверьте:systemctl status myapp. Выйти — клавиша Q.
Какой тип выбрать
| Что за программа | Тип | Что увидите в systemctl status |
|---|---|---|
| сайт, бот, API на Node.js, Python, Go — работает, пока её не остановят | exec | active (running) |
| скрипт, который выполняется и заканчивается: резервная копия, очистка | oneshot | после работы — inactive (dead) |
| скрипт, который один раз что-то настраивает при запуске сервера | oneshot и RemainAfterExit=yes | active (exited) |
| программа, которая сама уходит в фон и оставляет вместо себя другой процесс | forking и PIDFile= | active (running) |
| программа, которая сама сообщает systemd о готовности | notify | active (running) |
Если строки Type= нет, а ExecStart= есть, действует Type=simple. Если нет обеих, действует Type=oneshot.
simple и exec
Оба типа — для программ, которые работают, пока их не остановят. Разница в том, когда systemd считает запуск успешным:
simple— сразу, как только создал процесс, ещё до запуска самой программы. Если программы нет или нет пользователя изUser=, командаsystemctl startвсё равно ответит успехом, а служба упадёт следом.exec— когда программа действительно запустилась. Если её нет,systemctl startсразу сообщит об ошибке.
Справка systemd советует exec для долгих служб. Чтобы не гадать, почему служба «запустилась» и пропала, ставьте exec.
oneshot и RemainAfterExit=
Type=oneshot — для команды, которая делает дело и заканчивается. systemd ждёт, пока она закончит, и только тогда считает запуск завершённым.
[Unit]
Description=Очистка старых файлов
[Service]
Type=oneshot
ExecStart=/usr/bin/find /home/ivan/app/tmp -type f -mtime +7 -deleteЧто важно:
- После работы такая служба показывает
inactive (dead)— это не ошибка, команда просто закончилась. - С
RemainAfterExit=yesслужба после работы показываетactive (exited): systemd помнит, что она уже выполнена. Так делают для настроек, которые применяют один раз при запуске сервера. - Только у
oneshotможно написать несколько строкExecStart=— они выполнятся по порядку. - У
oneshotнет ограничения на время запуска: долгая команда не прервётся через 90 секунд.
Запускать такую службу по расписанию помогает таймер — Таймеры systemd.
forking и PIDFile=
Есть программы, которые при запуске создают свою копию, уходят в фон, а первый процесс завершается. Для них нужен Type=forking: systemd считает службу запущенной, когда первый процесс завершился.
[Service]
Type=forking
PIDFile=/run/myapp.pid
ExecStart=/usr/local/bin/myapp --daemonPIDFile= — файл, куда программа пишет номер своего главного процесса. По нему systemd следит за программой и перезапускает её после сбоя. Где программа хранит этот файл, смотрите в её документации.
Справка systemd не советует forking. Если у программы есть режим работы без ухода в фон — флаг вроде --foreground, -f или настройка в её конфигурации, — включите его и ставьте Type=exec.
notify
Type=notify — для программ, которые сами сообщают systemd «я готова». Так работает, например, служба redis-server в Ubuntu. Ставить этот тип своей программе можно, только если в её документации написано, что она умеет так сообщать.
Если программа не сообщает о готовности, systemd ждёт 90 секунд, затем останавливает её и пишет в журнал Failed with result 'timeout'.
Ошибки и как их исправить
| Что видите | Что значит и что делать |
|---|---|
служба сразу после запуска inactive (dead), в журнале нет ошибок, а программа должна работать | программа ушла в фон, а systemd решил, что она закончила работу, и остановил службу вместе с её процессами — включите у программы режим без ухода в фон или поставьте Type=forking |
activating (start) долго, затем Failed with result 'timeout' | Type=notify у программы, которая не сообщает о готовности, или forking у программы, которая не уходит в фон — поставьте Type=exec |
systemctl start прошёл без ошибки, а служба упала | у Type=simple ошибка запуска видна только после — смотрите systemctl status myapp и поставьте Type=exec |
Service has more than one ExecStart= setting… | несколько строк ExecStart= можно только у Type=oneshot — как заменить ExecStart= |
| служба не запускается | Job for … failed — как найти причину |
Источники
- Справка systemd.service(5) в Ubuntu 24.04 — на английском: все значения Type=, совет exec для долгих служб, forking не советуют, RemainAfterExit=, PIDFile=, тайм-аут у oneshot.
- Справка systemd.kill(5) в Ubuntu 24.04 — на английском: при остановке службы systemd завершает все её процессы.
- Файл службы redis-server в Ubuntu 24.04 — строка Type=notify.
- systemd 255: systemd-system.conf — на английском: 90 секунд на запуск службы по умолчанию.
Справка сверена с systemd 255 — эта версия стоит в Ubuntu 24.04.
Сверено 23 октября 2026 года.
Что почитать дальше
- Как создать службу systemdшаблон файла службы.
- Restart=автоперезапуск после сбоя.
- Таймеры systemdзапуск по расписанию.
- Настройки systemdвсе настройки служб.