SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

systemd Type=: simple, forking чи notify

Unit має статус active, але daemon зник? Дізнайтеся, коли обирати simple, exec, forking, oneshot або notify, і як знайти справжній головний PID.

Чому systemd повідомляє, що unit активний, коли процес завершив роботу

За стандартних ExitType=main і RemainAfterExit=no unit служби systemd залишається active, доки працює єдиний процес, який systemd вважає головним. Параметр Type= у секції [Service] визначає цей процес. Якщо вибрати неправильне значення, systemd стежитиме за оболонкою-обгорткою або короткоживучим батьківським процесом, тоді як потрібний вам daemon завершиться в межах того самого unit. Unit достовірно повідомляє стан процесу, за яким йому наказано стежити.

Зміна політики перезапуску тут не допоможе. Restart= реагує на завершення процесів і помилки, зокрема тайм-аути, але не виявляє завершення фонового daemon, якщо головний PID (ідентифікатор процесу) належить процесу, який усе ще працює. Спочатку виправте Type=. Дія systemd після фактичного завершення головного процесу — це окреме рішення, описане в посібнику щодо Restart= і RestartSec=.

Що саме визначає Type=

Кожне значення Type= одночасно відповідає на два запитання. Коли systemd може вважати цей unit запущеним і який процес є головним.

Перша відповідь визначає порядок запуску. Unit, у якому ваш unit указано в After=, очікує, доки systemd не вважатиме ваш unit запущеним. Type=, який повідомляє про стан «запущено» надто рано, дає змогу залежним unit запускатися ще до того, як ваш сервіс зможе відповідати на їхні запити.

Друга відповідь визначає нагляд. systemd розміщує кожен процес, запущений unit, у cgroup (control group) — функцію ядра, яка об’єднує процеси, щоб їх можна було обмежувати та завершувати разом. Саме cgroup використовує systemctl stop для очищення: KillMode= типово має значення control-group, тому під час зупинки unit отримує сигнал кожен процес усередині нього. Головний PID має вужче призначення. За стандартних ExitType=main і RemainAfterExit=no це єдиний процес, завершення якого завершує unit і чий код завершення враховується в результаті роботи unit. Плутанина виникає, коли cgroup сприймають як головний PID.

Type=simple повідомляє про запуск до виконання бінарного файла

Type=simple є значенням за замовчуванням, якщо задано ExecStart=, відсутні і Type=, і BusName=, а unit не використовує облікові дані. Unit, який завантажує облікові дані, наприклад за допомогою LoadCredential=, натомість неявно отримує Type=exec. У режимі simple systemd створює процес, одразу вважає unit запущеним і призначає цей процес головним PID. Залежні unit запускаються негайно, ще до виконання бінарного файла сервісу.

Саме це часто спричиняє несподівану поведінку. Навіть друкарська помилка в шляху ExecStart= не заважає успішному завершенню start job. Помилка виникає трохи пізніше, коли виконання не вдається. systemd фіксує такий випадок із кодом завершення 203. У власній таблиці systemd називає його EXIT_EXEC і визначає як помилку фактичного запуску процесу. Тому успішне повернення systemctl start не доводить, що ваш бінарний файл існує.

Використовуйте simple для програми, яка працює у foreground і не переводить себе у background. Це стосується більшості сучасних daemon і майже всіх програм, які ви пишете самостійно.

Type=exec очікує фактичного запуску програми

Type=exec — це simple з додатковим кроком. systemd вважає unit запущеним лише після успішного виконання fork і запуску бінарного файлу. Якщо бінарний файл відсутній або User= неможливо розв’язати, тепер помилка виникає безпосередньо під час запуску, а не після повідомлення про успіх із подальшим непомітним завершенням через мить.

Type=exec з’явився у висхідному коді systemd 240, але дистрибутиви підтримують його через backport у старіших версіях: RHEL 8 додав його у systemd-239-15.el8. У сумісних старих випусках він усе ще може бути відсутній: Ubuntu 18.04 залишатиметься під ESM до April 2028, а в його довідці systemd 237 exec не зазначено як підтримуваний тип. Ubuntu 24.04 постачається із systemd 255, а Debian 13 — із systemd 257, станом на October 2026. Перевірте свою версію за допомогою systemctl --version і довідки дистрибутива щодо systemd.service.

Під час запуску це потребує одного додаткового кроку синхронізації. Перевага — коректний код завершення від systemctl start. Для програми, що працює у foreground, використовуйте exec замість simple.

Type=forking і як втрачається основний PID

Type=forking повідомляє systemd, що процес із ExecStart= створить дочірній процес, а потім навмисно завершиться. systemd чекає, доки цей перший процес завершиться, і лише після цього вважає unit запущеним. Залишений дочірній процес є daemon. Така схема походить з епохи SysV, коли після завершення init script за daemon уже ніхто не стежив, а PID file був єдиним записом про запущений процес. Це обмеження є однією з основних причин чому systemd замінив init scripts.

Проблема полягає в ідентифікації. Процес, запущений systemd, уже завершився, тому systemd має визначити, який із процесів, що залишилися, є основним. Задайте PIDFile= як файл, у який daemon записує PID, зазвичай шлях під /run, і systemd прочитає PID із цього файлу. Якщо власником цього файлу є непривілейований користувач, systemd також перевіряє, чи належить указаний у ньому PID процесу, який уже входить до складу цього сервісу. Тому застарілий або підроблений файл із PID стороннього процесу буде відхилено, а не використано без перевірки.

Без PIDFile= застосовується GuessMainPID=, значення якого за замовчуванням — yes. Це припущення надійне лише тоді, коли сервіс працює як один процес. У документації це обмеження сформульовано прямо: якщо daemon складається з кількох процесів, systemd може неправильно визначити основний процес. Якщо основний PID неможливо визначити, виявлення збоїв і автоматичний перезапуск не працюватимуть надійно. Unit також може отримати основний PID 0. Це означає, що systemd не відстежує жодного основного процесу, навіть якщо процеси daemon усе ще працюють у cgroup цього unit.

Більшість daemon, які створюють дочірні процеси, також мають параметр для роботи у foreground. Використовуйте цей параметр із Type=exec і видаліть рядок PIDFile=. Менше складових означає менше способів втратити PID.

Type=oneshot для завдань, які завершуються

Type=oneshot очікує, що процес запуститься й завершиться. systemd вважає unit запущеним лише після завершення процесу, тому oneshot підходить для всього, чого має дочекатися інший unit. Це також неявне значення за замовчуванням, якщо в unit не вказано ні Type=, ні ExecStart=.

Для oneshot характерні дві особливості. Це єдиний тип, який допускає більше одного рядка ExecStart=; ці рядки виконуються послідовно. Тайм-аут запуску для нього також за замовчуванням вимкнено, тому oneshot, який завис, чекатиме безкінечно, якщо явно не встановити TimeoutStartSec=.

Після завершення процесу unit повертається до стану inactive. RemainAfterExit=yes залишає його у стані active, хоча жоден процес не запущений. Це навмисний варіант симптому, описаного на початку цієї сторінки. Він правильний, якщо завданням unit було зберегти певний стан, а не підтримувати роботу процесу: завантажити набір правил firewall або запустити стек контейнерів. Саме за таким принципом працює стек Docker Compose, який відновлюється після перезавантаження: unit виконує команду compose, завершується та залишається active, оскільки запущені ним контейнери продовжують працювати після його завершення. Unit типу oneshot також підходить для завдань, які запускаються за розкладом. Це інша частина сценарію запуску завдання за таймером systemd замість cron.

Type=notify дає змогу сервісу повідомити, коли він готовий

Type=notify передає це рішення сервісу. systemd утримує завдання запуску відкритим, доки процес не надішле READY=1 через Unix-сокет, шлях до якого він отримує зі змінної середовища NOTIFY_SOCKET. Інтерфейс C — sd_notify(3), і багато серверів уже його підтримують.

Це точна відповідь на запитання «чи запущений сервіс». simple і exec повідомляють про запуск до того, як сервіс прочитає конфігурацію або відкриє сокет для прослуховування. Через це залежний unit може запуститися надто рано й завершитися з помилкою під час першого підключення. notify повідомляє про запуск у момент, коли сам сервіс повідомляє про готовність.

systemd приймає це повідомлення лише від головного процесу. Саме це означає NotifyAccess=main, а Type=notify передбачає таку поведінку. Якщо повідомлення надходить від дочірнього процесу або допоміжної програми, установіть NotifyAccess=all. Shell-скрипт може викликати systemd-notify --ready. Якщо він має відповідні права, systemd-notify надсилає повідомлення з PID батьківського процесу. Тому скрипт, який сам є головним процесом, передає NotifyAccess=main. В іншому разі використовується власний PID, і для unit потрібен NotifyAccess=all. За замовчуванням програма очікує, доки systemd обробить повідомлення, перш ніж завершитися. Тому не вказуйте --no-block, оскільки він вимикає це очікування. Сервіс, який сам підтримує цей протокол, працює надійніше.

Варто знати ще два пов’язані параметри. Type=notify-reload, доступний починаючи з systemd 253, поширює той самий механізм підтвердження на перезавантаження конфігурації. Тому systemctl reload повертається після повідомлення сервісу про завершення перезавантаження конфігурації, а не одразу після надсилання сигналу. Починаючи з systemd 262, випущеного у вересні 2026 року, сервіс із notify-reload, який надсилає READY=1, не перехоплюючи й не блокуючи сигнал перезавантаження конфігурації (SIGHUP, якщо ReloadSignal= не вказує інше), не запускається та завершується з помилкою протоколу. Без цього механізму під час першого перезавантаження конфігурації процес завершився б під дією цього сигналу. WatchdogSec= просить сервіс із підтримкою сповіщень надсилати keep-alive повідомлення через заданий інтервал, а systemd вважає пропущений дедлайн помилкою.

Type=dbus і Type=idle

Type=dbus очікує, доки сервіс зареєструє ім’я в D-Bus — шині повідомлень, через яку системні та графічні служби взаємодіють між собою. Для нього потрібен BusName=. Він стає типовим значенням, щойно встановлено BusName=. Використовуйте його лише для сервісу, який справді реєструє ім’я на шині.

Type=idle працює як simple, але відкладає запуск програми, доки всі завдання в черзі не буде передано на виконання, із максимальним очікуванням 5 секунд. Цей тип потрібен, щоб вивід консолі під час завантаження не змішувався з повідомленнями про стан. Він не призначений для керування порядком запуску і не має використовуватися для звичайного сервісу.

Чому wrapper script залишає systemd із неправильним PID

Ось схема, яка спричиняє початкову проблему.

[Service]
Type=simple
ExecStart=/opt/app/run.sh
#!/bin/bash
export APP_ENV=production
/opt/app/bin/server --config /etc/app.yaml &
/opt/app/bin/exporter --port 9101

systemd записує shell як основний PID. Shell залишається активним, поки exporter працює у foreground. Якщо server завершується аварійно, shell цього не помічає. Тому основний PID і далі активний, unit залишається у стані active, а Restart= не має на що реагувати. Обидва процеси весь цей час перебувають у cgroup unit, тому systemctl stop і далі коректно виконує очищення. Зламався нагляд за процесом, а не очищення.

Виправлення залежить від кількості довготривалих процесів, які фактично запускає unit.

Якщо процес один, замініть shell цим процесом.

#!/bin/bash
export APP_ENV=production
exec /opt/app/bin/server --config /etc/app.yaml

exec замінює shell вказаною програмою та зберігає той самий PID. Тому PID, який записав systemd, тепер належить daemon. Ще краще — видаліть wrapper. Environment= і EnvironmentFile= передають змінні, а ExecStartPre= виконує крок підготовки. Завдяки цьому systemd може безпосередньо запустити daemon і відразу знати його PID.

Якщо процесів два, жоден окремий PID не представляє весь unit. Розділіть їх на два unit і впорядкуйте їх за допомогою After= і Wants=. По одному unit на процес — це схема, яку systemd добре контролює. Лише так кожен процес отримує власну політику перезапуску.

Що змінює ExitType=cgroup

ExitType= додано в systemd 250. Значення за замовчуванням — main: unit вважається зупиненим, коли завершується головний процес. Із ExitType=cgroup unit вважається активним, доки працює хоча б один процес у його cgroup.

[Service]
Type=simple
ExitType=cgroup
ExecStart=/opt/app/launcher

Це вирішує одну конкретну проблему. Launcher, який запускає основну роботу, а потім завершується, за умови ExitType=main змусить systemd вважати unit зупиненим і завершити процеси, що залишилися. За умови ExitType=cgroup unit натомість відстежує всю групу.

Важливо розуміти, чого це не вирішує. ExitType=cgroup залишає unit активним, доки працює хоча б один процес. Тому unit із двома daemon-процесами залишатиметься активним після завершення одного з них. Це виправляє випадок із launcher. Але це не перетворює один unit на supervisor для кількох незалежних процесів. ExitType=cgroup також не можна поєднувати з Type=oneshot.

У cgroup також виконується облік ресурсів. Тому обмеження на кшталт MemoryMax= і CPUQuota= застосовуються до кожного процесу, запущеного unit, незалежно від того, що Type= визначає щодо головного PID. Цю тему розглянуто в розділі обмеження споживання пам’яті та CPU сервісом за допомогою systemd.

Як знайти процес, за яким systemd фактично стежить

Виконуйте ці дії послідовно для unit, який ви налагоджуєте. Спочатку прочитайте файли unit, потім перевірте, що відстежує systemd, а далі порівняйте це зі списком процесів.

systemctl cat app.service
systemctl show -p Type,ExitType,GuessMainPID,PIDFile,MainPID,RemainAfterExit app.service

systemctl cat виводить файл unit разом із усіма drop-in-файлами, які застосовуються до нього з диска. Вони можуть відрізнятися від того, що завантажив systemd, якщо файли змінили без виконання daemon-reload. systemctl show виводить фактичні значення, зокрема стандартні, які ви явно не задавали. Перед переходом далі запишіть значення MainPID.

systemd-cgls --unit=app.service
ps -o pid,ppid,stat,etime,args -p "$(systemctl show -p MainPID --value app.service)"

systemd-cgls виводить усі процеси в cgroup unit. Рядок ps описує єдиний процес, за яким стежить systemd. Розглядайте ці два результати разом. Значення MainPID, що дорівнює 0, означає, що systemd не відстежує жодного головного процесу, навіть якщо systemd-cgls і далі показує процеси в cgroup unit. Якщо MainPID вказує на shell, а cgroup також містить ваш daemon, це описаний вище випадок із wrapper. Якщо в cgroup більше процесів, ніж ви очікували, задіяний launcher або daemon, який створює дочірні процеси.

systemctl status app.service
journalctl -u app.service -b

systemctl status одночасно виводить рядок стану та дерево cgroup, тому часто одразу відповідає на обидва запитання. journalctl -u з обмеженням до цього завантаження за допомогою -b показує події запуску й зупинки, які systemd записав для unit, разом із кодами завершення, які він отримав. Якщо daemon записує дані у власний файл журналу, а не в journal, прочитайте також цей файл, оскільки systemd може записати лише те, що до нього надійшло.

Після зміни Type= виконайте reload і restart.

systemd-analyze verify /etc/systemd/system/app.service
sudo systemctl daemon-reload
sudo systemctl restart app.service

systemd-analyze verify аналізує файл і повідомляє про параметри, які не може прийняти. daemon-reload змушує systemd повторно прочитати файли unit із диска. Змінений Type= не застосовується до вже запущеного unit, тому restart є обов’язковим.

Потім перевірте зміну. Візьміть PID потрібного вам процесу з systemd-cgls і завершіть його. Одразу після цього виконайте systemctl is-active app.service. За використання ExitType=main і RemainAfterExit=no завершення головного процесу припиняє цей запущений екземпляр, хоча політика restart може запустити його знову до того, як ви виконаєте перевірку. Якщо unit залишається активним без restart, перевірте, чи systemd не стежить за іншим процесом і чи unit не використовує ExitType=cgroup або RemainAfterExit=yes.

Який параметр Type= systemd слід використовувати

  • Програма, яка працює у foreground: Type=exec.
  • Програма, що підтримує сповіщення про готовність: Type=notify, а notify-reload — якщо вона також підтверджує перезавантаження конфігурації.
  • Демон, який наполягає на переході у background: Type=forking разом із PIDFile= або його перемикачем для роботи у foreground із Type=exec.
  • Скрипт, який виконує роботу та завершується: Type=oneshot, а RemainAfterExit=yes — якщо потрібно було залишити стан.
  • Програма запуску, яка завершується, тоді як її дочірні процеси продовжують працювати: Type=simple разом із ExitType=cgroup.

Якщо ви не впевнені, який параметр потрібен сторонньому демону, спочатку прочитайте його unit-файл, що постачається з пакетом. Виконання systemctl cat для unit-файлу, який постачається дистрибутивом, показує вибране в пакеті Type= разом із локальними перевизначеннями.

FAQ

Чому мій unit systemd залишається активним, коли процес завершився?

Для стандартних ExitType=main і RemainAfterExit=no це відбувається тому, що процес, який systemd вважає головним, усе ще працює. За цих параметрів systemd відстежує один головний PID для кожного сервісу, визначений відповідно до Type=. Зазвичай причиною є скрипт-обгортка, запущений через Type=simple: оболонка є головним PID, тому unit залишається активним, коли daemon, запущений оболонкою у фоновому режимі, завершується. Виконайте systemctl show -p MainPID app.service, потім виведіть cgroup unit за допомогою systemd-cgls --unit=app.service і порівняйте результати.

Яка різниця між Type=simple і Type=exec?

Type=simple вважає unit запущеним одразу після створення процесу systemd, ще до виконання binary-файлу. Тому неправильний шлях у ExecStart= спочатку дає успішне виконання завдання запуску, а потім помилку. Type=exec очікує успішного виконання, тому цю помилку саме завдання запуску і повідомляє. В обох випадках той самий процес вважається головним PID. Type=exec додали у systemd 240, але дистрибутиви можуть перенести цю функцію у старіші версії, як це зробив RHEL 8 у systemd-239-15.el8.

Чи потрібен мені PIDFile= з Type=forking?

Так, якщо daemon записує такий файл. Без нього systemd використовує GuessMainPID=. Це лише припущення, яке надійне тільки для сервісу, що переходить до роботи в одному процесі. Якщо припущення неправильне або його неможливо зробити, виявлення помилок і автоматичний перезапуск цього unit працюють ненадійно. Вкажіть у PIDFile= точний шлях, за яким daemon записує файл, зазвичай у /run.

Коли слід використовувати RemainAfterExit=yes?

Коли призначення unit полягає у зміні стану системи, а не в підтриманні роботи процесу. Unit Type=oneshot, який завантажує правила firewall або запускає стек контейнерів, завершується одразу після виконання своєї роботи. Без RemainAfterExit=yes unit одразу переходить зі стану запуску до стану зупинки. Тому будь-яке очищення ExecStop= виконується відразу після завершення роботи, а не тоді, коли ви вирішите зупинити unit, і systemctl stop вже немає чого зупиняти. З цим параметром unit залишається активним без процесів, і саме така поведінка тут потрібна.

Чи потребує зміна Type= виконання daemon-reload?

Так, а також перезапуску unit. systemctl daemon-reload змушує systemd повторно прочитати unit-файли з диска, але запущений екземпляр продовжує використовувати Type=, з яким його було запущено. Виконайте sudo systemctl daemon-reload, а потім sudo systemctl restart app.service перед тестуванням. Інакше ви й далі спостерігатимете стару поведінку нагляду за процесом.

Чи була ця стаття корисною?