SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

systemd Type: simple, forking, notify – jak wybrać?

Dowiedz się, jak poprawnie skonfigurować dyrektywę Type w systemd, aby uniknąć błędnego statusu active. Wyjaśniamy różnice między simple, forking i notify dla procesów.

Dlaczego systemd zgłasza jednostkę jako aktywną, mimo że proces zakończył działanie

Przy domyślnych ustawieniach ExitType=main i RemainAfterExit=no, jednostka usługi systemd pozostaje w stanie active, dopóki żyje proces, który systemd uznaje za główny, a dyrektywa Type= w sekcji [Service] określa, który to proces. Wybór błędnej wartości powoduje, że systemd monitoruje skrypt powłoki lub krótkotrwały proces nadrzędny, podczas gdy właściwy demon wewnątrz tej samej jednostki kończy działanie. Jednostka przekazuje informacje o procesie, który została skonfigurowana do monitorowania.

Zmiana polityki restartu w tym przypadku nie pomoże. Restart= reaguje na zakończenie procesu oraz błędy, takie jak przekroczenie limitu czasu, ale nie wykrywa zakończenia działania demona w tle, jeśli główny PID (identyfikator procesu) należy do elementu, który nadal pracuje. W pierwszej kolejności należy poprawić Type=. Działanie systemd po faktycznym zakończeniu głównego procesu jest odrębną kwestią, omówioną w przewodniku po Restart= oraz RestartSec=.

Co określa dyrektywa Type=

Każda wartość Type= odpowiada jednocześnie na dwa pytania. Kiedy systemd uznaje jednostkę za uruchomioną oraz który proces jest procesem głównym.

Pierwsza odpowiedź kontroluje kolejność startu. Jednostka, która wskazuje Twoją w After=, czeka, aż systemd uzna Twoją za uruchomioną. Type=, który zgłasza stan "uruchomiono" zbyt wcześnie, pozwala jednostkom zależnym na start, zanim Twoja usługa będzie w stanie je obsłużyć.

Druga odpowiedź kontroluje nadzór. systemd umieszcza każdy proces wywołany przez jednostkę w cgroup (grupie kontrolnej). Jest to funkcja jądra grupująca procesy w celu wspólnego ograniczania zasobów i kończenia ich działania. cgroup jest mechanizmem, dzięki któremu systemctl stop czyści zasoby: KillMode= domyślnie przyjmuje control-group, więc zatrzymanie jednostki wysyła sygnał do wszystkich procesów wewnątrz niej. Główny PID ma węższe znaczenie. Przy domyślnych ExitType=main oraz RemainAfterExit=no jest to pojedynczy proces, którego zakończenie kończy działanie jednostki, a którego kod wyjścia wpływa na wynik jednostki. Zamienne traktowanie cgroup i głównego PID jest źródłem nieporozumień.

Typ=simple zgłasza uruchomienie przed wykonaniem pliku binarnego

Type=simple jest wartością domyślną, gdy ustawiono ExecStart=, nie podano Type= ani BusName=, a jednostka nie korzysta z poświadczeń. Jednostka ładująca poświadczenia, na przykład za pomocą LoadCredential=, otrzymuje w zamian domyślne Type=exec. W trybie simple systemd tworzy proces, uznaje jednostkę za uruchomioną natychmiast i traktuje ten proces jako główny PID. Kolejne jednostki startują niezwłocznie, jeszcze zanim plik binarny usługi zostanie wykonany.

Ten ostatni szczegół wyjaśnia częste zaskoczenie. Literówka w ścieżce ExecStart= nadal skutkuje zadaniem startowym, które kończy się powodzeniem, a błąd pojawia się chwilę później, gdy wykonanie procesu zawodzi. systemd rejestruje taki przypadek z kodem wyjścia 203, który w jego własnej tabeli nosi nazwę EXIT_EXEC i jest definiowany jako błąd wykonania właściwego procesu. Zatem zakończenie systemctl start bez błędu nie stanowi dowodu na istnienie pliku binarnego.

Używaj simple dla programów, które pozostają na pierwszym planie i nie przenoszą się samodzielnie w tło. Dotyczy to większości nowoczesnych demonów oraz niemal wszystkiego, co tworzy się samodzielnie.

Type=exec oczekuje na faktyczne uruchomienie programu

Type=exec to simple z dodatkowym krokiem. systemd uznaje jednostkę za uruchomioną dopiero po pomyślnym zakończeniu procesu fork oraz wykonaniu pliku binarnego. Brak pliku binarnego lub User=, którego nie można rozwiązać, powoduje teraz niepowodzenie zadania startowego, zamiast zgłaszania sukcesu i cichego wyłączenia się chwilę później.

Type=exec trafiło do głównej gałęzi systemd w wersji 240, ale backporty dystrybucyjne zapewniają wsparcie w starszych wersjach: RHEL 8 dodało to w systemd-239-15.el8. Wspierane starsze wydania mogą nadal nie posiadać tej funkcji: Ubuntu 18.04 pozostaje w ramach ESM do kwietnia 2028, a jego dokumentacja systemd 237 nie wymienia exec jako wspieranego typu. Ubuntu 24.04 dostarcza systemd 255, a Debian 13 dostarcza systemd 257, według stanu na październik 2026. Sprawdź swoją wersję za pomocą systemctl --version oraz dokumentacji systemd.service danej dystrybucji.

Koszt to jeden dodatkowy krok synchronizacji podczas startu. Zyskiem jest rzetelny kod wyjścia z systemctl start. W przypadku programów działających na pierwszym planie, preferuj exec zamiast simple.

Type=forking i problem utraty głównego PID

Type=forking informuje systemd, że proces określony w ExecStart= utworzy proces potomny (fork), a następnie celowo zakończy działanie. systemd czeka na zakończenie tego pierwszego procesu i dopiero wtedy uznaje jednostkę za uruchomioną. Pozostały proces potomny jest właściwym daemonem. Ten nawyk wywodzi się z ery SysV, kiedy żaden mechanizm nie nadzorował daemona po zakończeniu skryptu startowego, a plik PID był jedynym zapisem działającej usługi. To ograniczenie leży u podstaw dlaczego systemd zastąpił skrypty init.

Trudność polega na identyfikacji. Proces uruchomiony przez systemd już nie istnieje, więc systemd musi ustalić, który z pozostałych procesów jest główny. Należy ustawić PIDFile= na plik, do którego daemon zapisuje PID, zazwyczaj jest to ścieżka w /run, z którego systemd odczyta wartość. Gdy właścicielem pliku jest użytkownik bez uprawnień roota, systemd sprawdza również, czy PID w nim zawarty odnosi się do procesu należącego do tej usługi. Dzięki temu przestarzały lub podłożony plik wskazujący na niepowiązany proces zostaje odrzucony, zamiast być uznany za wiarygodny.

Bez PIDFile= stosowane jest GuessMainPID=, którego domyślną wartością jest yes. Zgadywanie jest wiarygodne tylko wtedy, gdy usługa ogranicza się do pojedynczego procesu. Dokumentacja jasno określa ograniczenie: zgadywanie może prowadzić do błędnych wniosków, jeśli daemon składa się z więcej niż jednego procesu. Jeśli nie można ustalić głównego PID, wykrywanie awarii i automatyczne restartowanie nie będą działać poprawnie. Jednostka może również otrzymać główny PID o wartości 0, co oznacza, że systemd nie śledzi żadnego głównego procesu, nawet jeśli procesy daemona nadal działają w cgroup danej jednostki.

Większość daemonów, które korzystają z forkowania, posiada również przełącznik utrzymujący je w pierwszym planie (foreground). Należy użyć tego przełącznika w Type=exec i usunąć linię PIDFile=. Mniejsza liczba elementów składowych oznacza mniejsze ryzyko utraty PID.

Type=oneshot dla zadań kończących się

Type=oneshot oczekuje, że proces zostanie uruchomiony i zakończy działanie. systemd uznaje jednostkę za uruchomioną dopiero po jej zakończeniu, co czyni oneshot właściwym wyborem dla wszystkiego, na co musi oczekiwać inna jednostka. Jest to również domyślny typ, gdy jednostka nie określa ani Type=, ani ExecStart=.

Dwa zachowania są specyficzne dla oneshot. Jest to jedyny typ, który akceptuje więcej niż jedną linię ExecStart=, a linie te są wykonywane w kolejności. Limit czasu uruchomienia jest również domyślnie wyłączony, więc oneshot, który zawiesza się, będzie oczekiwał w nieskończoność, chyba że samodzielnie ustawisz TimeoutStartSec=.

Po zakończeniu procesu jednostka powraca do stanu nieaktywnego. RemainAfterExit=yes utrzymuje ją jako active, mimo że żaden proces nie jest uruchomiony. Jest to zamierzona wersja objawu opisanego na początku tej strony i jest to poprawne zachowanie, gdy zadaniem jednostki było pozostawienie określonego stanu, a nie utrzymywanie czegoś w działaniu: ładowanie zestawu reguł firewalla lub uruchamianie stosu kontenerów. Jest to wzorzec stojący za stosem Docker Compose, który powraca po restarcie, gdzie jednostka wykonuje polecenie compose, kończy działanie i pozostaje aktywna, ponieważ uruchomione przez nią kontenery działają nadal. Jednostka typu oneshot sprawdza się również w przypadku zadań wyzwalanych harmonogramem, co stanowi drugą połowę uruchamiania zadania za pomocą systemd timer zamiast cron.

Typ Type=notify pozwala usłudze zasygnalizować gotowość do pracy

Type=notify przenosi decyzję o gotowości na samą usługę. systemd wstrzymuje zadanie uruchomienia do momentu, gdy proces wyśle READY=1 przez gniazdo Unix, którego ścieżkę otrzymuje w zmiennej środowiskowej NOTIFY_SOCKET. Interfejs C to sd_notify(3) i wiele serwerów obsługuje go natywnie.

Jest to precyzyjna odpowiedź na pytanie, czy usługa została uruchomiona. simple oraz exec zgłaszają uruchomienie, zanim usługa odczyta konfigurację lub otworzy gniazdo nasłuchujące, co może prowadzić do zbyt wczesnego startu jednostek zależnych i błędów połączenia. notify zgłasza uruchomienie w momencie, gdy sama usługa potwierdzi gotowość.

systemd akceptuje ten komunikat wyłącznie od procesu głównego, co oznacza NotifyAccess=main, a Type=notify to implikuje. Jeśli komunikat pochodzi od procesu potomnego lub pomocniczego, należy ustawić NotifyAccess=all. Skrypt powłoki może wywołać systemd-notify --ready. Jeśli posiada odpowiednie uprawnienia, systemd-notify wysyła komunikat z PID procesu nadrzędnego, więc skrypt będący procesem głównym przekazuje NotifyAccess=main; w przeciwnym razie używany jest własny PID i jednostka wymaga NotifyAccess=all. Domyślnie systemd czeka na przetworzenie komunikatu przed zakończeniem działania, więc należy pominąć --no-block, który wyłącza to oczekiwanie. Usługa obsługująca protokół samodzielnie jest bardziej niezawodna.

Warto znać dwa powiązane ustawienia. Type=notify-reload, dostępne od systemd 253, rozszerza ten sam mechanizm na przeładowania, dzięki czemu systemctl reload kończy działanie dopiero po zgłoszeniu przez usługę zakończenia przeładowania, zamiast zaraz po wysłaniu sygnału. Od wersji systemd 262, wydanej we wrześniu 2026, usługa notify-reload wysyłająca READY=1 bez przechwycenia lub zablokowania sygnału przeładowania (SIGHUP, chyba że ReloadSignal= stanowi inaczej) kończy się błędem protokołu zamiast zostać przerwaną przez ten sygnał przy pierwszym przeładowaniu. WatchdogSec= wymusza na usłudze wysyłanie komunikatu podtrzymującego w określonych odstępach czasu, a przekroczenie terminu systemd traktuje jako awarię.

Type=dbus oraz Type=idle

Type=dbus czeka, aż usługa zarejestruje nazwę w D-Bus, czyli magistrali komunikatów używanej przez usługi systemowe i desktopowe do komunikacji między sobą. Wymaga to BusName= i staje się ustawieniem domyślnym, gdy tylko BusName= zostanie zdefiniowane. Należy używać tego typu tylko dla usług, które faktycznie rejestrują nazwę w magistrali.

Type=idle działa podobnie do simple, ale opóźnia uruchomienie programu do momentu przetworzenia zakolejkowanych zadań, z limitem czasowym wynoszącym pięć sekund. Mechanizm ten istnieje, aby dane wyjściowe konsoli podczas startu systemu nie mieszały się z komunikatami o statusie. Nie jest to narzędzie służące do ustalania kolejności i nie powinno być stosowane w standardowych usługach.

Dlaczego skrypt opakowujący powoduje, że systemd śledzi niewłaściwy PID

Oto struktura, która wywołuje ten objaw.

[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 rejestruje powłokę jako główny PID. Powłoka pozostaje aktywna, podczas gdy exporter działa na pierwszym planie. Jeśli server ulegnie awarii, powłoka tego nie zauważy, więc główny PID nadal istnieje, jednostka jest nadal w stanie active, a Restart= nie ma na co reagować. Oba procesy przez cały czas znajdują się w cgroup jednostki, więc systemctl stop nadal poprawnie czyści zasoby. Zepsuł się nadzór, a nie czyszczenie.

Rozwiązanie zależy od tego, ile długo działających procesów faktycznie posiada jednostka.

Jeśli jest tylko jeden, należy zastąpić nim powłokę.

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

exec zastępuje powłokę wskazanym programem i zachowuje ten sam PID, dzięki czemu PID zarejestrowany przez systemd należy teraz do demona. Jeszcze lepiej jest usunąć skrypt opakowujący. Environment= i EnvironmentFile= przekazują zmienne, a ExecStartPre= realizuje krok konfiguracji, więc systemd może uruchomić demona bezpośrednio i znać jego PID z samej definicji.

Jeśli procesy są dwa, żaden pojedynczy PID nie reprezentuje jednostki. Należy rozdzielić je na dwie jednostki i uporządkować je za pomocą After= oraz Wants=. Jedna jednostka na proces to układ, który systemd nadzoruje poprawnie i jest to jedyny sposób, aby każdy proces miał własne zachowanie przy restarcie.

Zmiany w ExitType=cgroup

ExitType= wprowadzono w systemd 250. Wartością domyślną jest main: jednostka jest uznawana za zatrzymaną, gdy kończy się główny proces. Przy ExitType=cgroup jednostka pozostaje w stanie uruchomienia tak długo, jak żyje jakikolwiek proces w jej cgroup.

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

Rozwiązuje to konkretny problem. W przypadku launchera, który uruchamia właściwe zadanie i kończy działanie, przy ExitType=main systemd uznaje jednostkę za zatrzymaną i przerywa działanie pozostałych procesów. Dzięki ExitType=cgroup jednostka monitoruje całą grupę.

Należy wyraźnie określić, czego to rozwiązanie nie naprawia. ExitType=cgroup utrzymuje jednostkę jako aktywną, dopóki żyje przynajmniej jeden proces, więc jednostka obsługująca dwa demony pozostanie aktywna nawet po awarii jednego z nich. Rozwiązuje to problem launchera. Nie zmienia to jednak jednostki w nadzorcę kilku niezależnych procesów. ExitType=cgroup nie może być również łączone z Type=oneshot.

Cgroup jest również miejscem, w którym odbywa się rozliczanie zasobów, więc limity takie jak MemoryMax= oraz CPUQuota= mają zastosowanie do każdego procesu uruchomionego przez jednostkę, niezależnie od tego, co Type= mówi o głównym PID. Ten aspekt został opisany w ograniczanie pamięci i procesora usługi za pomocą systemd.

Jak odnaleźć proces monitorowany przez systemd

Należy wykonać poniższe kroki na jednostce, która jest diagnozowana. Najpierw należy odczytać pliki jednostki, następnie sprawdzić, co monitoruje systemd, a na końcu porównać to z tablicą procesów.

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

systemctl cat wyświetla plik jednostki wraz ze wszystkimi plikami typu drop-in, które są stosowane z dysku; mogą one różnić się od tego, co załadował systemd, jeśli pliki zostały zmienione bez wykonania daemon-reload. systemctl show drukuje efektywne wartości, w tym wartości domyślne, które nie zostały jawnie zdefiniowane. Przed przejściem dalej należy zanotować wartość MainPID.

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

systemd-cgls wymienia wszystkie procesy w cgroup jednostki. Wiersz ps opisuje pojedynczy proces nadzorowany przez systemd. Należy przeanalizować oba te elementy łącznie. Wartość MainPID równa 0 oznacza, że systemd nie monitoruje żadnego głównego procesu, nawet jeśli systemd-cgls nadal wyświetla procesy w cgroup jednostki. Wartość MainPID, która wskazuje na powłokę (shell), podczas gdy w cgroup znajduje się również demon, oznacza przypadek użycia skryptu opakowującego (wrapper). Cgroup zawierająca więcej procesów niż oczekiwano oznacza, że zaangażowany jest program uruchamiający lub demon typu forking.

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

systemctl status drukuje wiersz stanu wraz z drzewem cgroup, co często pozwala odpowiedzieć na oba pytania jednocześnie. journalctl -u ograniczone do bieżącego uruchomienia za pomocą -b pokazuje zdarzenia uruchomienia i zatrzymania zarejestrowane przez systemd dla jednostki wraz z zaobserwowanymi kodami wyjścia. Jeśli demon zapisuje dane do własnego pliku dziennika zamiast do journal, należy również odczytać ten plik, ponieważ systemd może zarejestrować tylko to, co do niego dotarło.

Po zmianie Type= należy przeładować konfigurację i zrestartować jednostkę.

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

systemd-analyze verify analizuje plik i zgłasza ustawienia, których nie może zaakceptować. daemon-reload powoduje, że systemd ponownie odczytuje pliki jednostek z dysku. Zmieniona wartość Type= nie ma zastosowania do już uruchomionej jednostki, dlatego restart jest wymagany, a nie opcjonalny.

Następnie należy przetestować zmianę. Należy pobrać PID procesu, który jest istotny, za pomocą systemd-cgls i zakończyć go (kill). Bezpośrednio po tym należy uruchomić systemctl is-active app.service. W przypadku ExitType=main oraz RemainAfterExit=no, zakończenie głównego procesu kończy działanie danej instancji, chociaż polityka restartu może przywrócić ją przed sprawdzeniem stanu. Jeśli jednostka pozostaje aktywna bez restartu, należy sprawdzić, czy systemd monitoruje coś innego lub czy jednostka korzysta z ExitType=cgroup albo RemainAfterExit=yes.

Który typ usługi systemd Type= należy wybrać

  • Program działający w pierwszym planie: Type=exec.
  • Program obsługujący powiadomienie o gotowości: Type=notify, oraz notify-reload, jeśli potwierdza również przeładowania.
  • Demon, który wymusza przejście w tło: Type=forking wraz z PIDFile= lub jego przełącznik pierwszego planu z Type=exec.
  • Skrypt, który wykonuje zadanie i kończy działanie: Type=oneshot, plus RemainAfterExit=yes, gdy celem było pozostawienie stanu.
  • Program uruchamiający, który kończy działanie, podczas gdy jego procesy potomne nadal pracują: Type=simple wraz z ExitType=cgroup.

W przypadku braku pewności, jakiego typu wymaga demon zewnętrznego dostawcy, należy najpierw przeczytać dostarczony plik jednostki. Uruchomienie systemctl cat na jednostce dostarczonej przez dystrybucję pokazuje wybrany typ Type= wraz z lokalnymi nadpisaniami.

FAQ

Dlaczego jednostka systemd pozostaje aktywna, mimo że proces zakończył działanie?

Przy domyślnych ustawieniach ExitType=main i RemainAfterExit=no dzieje się tak, ponieważ proces uznawany przez systemd za główny nadal żyje. W ramach tych ustawień systemd śledzi jeden główny PID na usługę, wybrany zgodnie z Type=. Skrypt opakowujący uruchomiony za pomocą Type=simple jest zazwyczaj przyczyną tego zjawiska: powłoka jest głównym PID-em, więc jednostka pozostaje aktywna, gdy demon uruchomiony przez tę powłokę w tle kończy pracę. Uruchom systemctl show -p MainPID app.service, a następnie wyświetl cgroup jednostki za pomocą systemd-cgls --unit=app.service i porównaj oba wyniki.

Jaka jest różnica między Type=simple a Type=exec?

Type=simple uznaje jednostkę za uruchomioną, gdy tylko systemd utworzy proces, jeszcze przed wykonaniem pliku binarnego, dlatego błędna ścieżka w ExecStart= nadal skutkuje udanym zadaniem startowym, po którym następuje błąd. Type=exec czeka, aż wykonanie się powiedzie, dzięki czemu błąd jest zgłaszany bezpośrednio przez zadanie startowe. Oba typy traktują ten sam proces jako główny PID. Type=exec zostało wprowadzone w wersji upstream systemd 240, ale dystrybucje mogą przenosić tę funkcjonalność do starszych wersji, tak jak zrobił to RHEL 8 w systemd-239-15.el8.

Czy nadal potrzebuję PIDFile= przy Type=forking?

Tak, zawsze gdy demon zapisuje taki plik. Bez niego systemd polega na GuessMainPID=, co jest jedynie szacowaniem i sprawdza się tylko w przypadku usługi, która stabilizuje się w jednym procesie. Gdy szacowanie jest błędne lub niemożliwe, wykrywanie awarii i automatyczne restarty nie działają poprawnie dla tej jednostki. Wskaż PIDFile= dokładną ścieżkę, do której zapisuje demon, zazwyczaj w /run.

Kiedy należy użyć RemainAfterExit=yes?

Gdy celem jednostki była zmiana stanu systemu, a nie utrzymywanie procesu w działaniu. Jednostka Type=oneshot, która ładuje reguły zapory sieciowej lub uruchamia stos kontenerów, kończy działanie, gdy tylko wykona swoje zadanie. Bez RemainAfterExit=yes jednostka przechodzi bezpośrednio ze stanu uruchamiania do zatrzymywania, więc wszelkie czyszczenie ExecStop= uruchamia się zaraz po zakończeniu pracy, a nie wtedy, gdy użytkownik zdecyduje się zatrzymać jednostkę, a systemctl stop nie ma już czego zatrzymywać. Dzięki tej opcji jednostka pozostaje aktywna bez żadnych procesów, co jest w tym przypadku zamierzonym zachowaniem.

Czy zmiana Type= wymaga wykonania daemon-reload?

Tak, a także restartu jednostki. systemctl daemon-reload sprawia, że systemd ponownie odczytuje pliki jednostek z dysku, ale uruchomiona instancja zachowuje Type=, z którym została uruchomiona. Przed testowaniem wykonaj sudo systemctl daemon-reload, a następnie sudo systemctl restart app.service, w przeciwnym razie nadal będziesz obserwować stare zachowanie nadzoru.

Czy ten artykuł był przydatny?