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

Type= в systemd: simple, exec, forking, oneshot и notify — какой выбрать

Type= говорит systemd, как понять, что программа запустилась. Для сайта или бота на Node.js и Python ставьте Type=exec, для скрипта, который выполняется и заканчивается, — Type=oneshot. Из-за неверного типа служба сразу останавливается или висит на запуске.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите тип службы. Вместо myapp — имя своей службы: systemctl show myapp -p Type.
  3. Выберите тип по таблице ниже.
  4. Если тип нужно поменять: sudo systemctl edit myapp. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. Откроется редактор nano. Между строками ### Anything between here… и ### Edits below this comment will be discarded впишите:
[Service]
Type=exec
  1. Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
  2. Перезапустите службу: sudo systemctl restart myapp и проверьте: systemctl status myapp. Выйти — клавиша Q.

Какой тип выбрать

Что за программаТипЧто увидите в systemctl status
сайт, бот, API на Node.js, Python, Go — работает, пока её не остановятexecactive (running)
скрипт, который выполняется и заканчивается: резервная копия, очисткаoneshotпосле работы — inactive (dead)
скрипт, который один раз что-то настраивает при запуске сервераoneshot и RemainAfterExit=yesactive (exited)
программа, которая сама уходит в фон и оставляет вместо себя другой процессforking и PIDFile=active (running)
программа, которая сама сообщает systemd о готовностиnotifyactive (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 --daemon

PIDFile= — файл, куда программа пишет номер своего главного процесса. По нему 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 255 — эта версия стоит в Ubuntu 24.04.

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

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

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