systemdのType= simple、forking、notifyの違い
systemdのunitがactiveなのにdaemonが終了する原因を解説します。Type= simple、exec、forking、oneshot、notifyの違いと、実際のmain PIDを特定する方法が分かります。
systemd がプロセスの終了後も unit を active と報告する理由
デフォルトの ExitType=main と RemainAfterExit=no では、systemd がメインプロセスと判断した 1 つのプロセスが存続している間、systemd のサービス unit は active のままです。どのプロセスをメインプロセスとするかは、[Service] セクションの Type= で決まります。値を誤ると、systemd はシェルラッパーや短時間で終了する親プロセスを監視し、対象のデーモンが同じ unit 内で終了しても検知できません。unit は、監視するよう指定されたプロセスについて正しい状態を報告しています。
ここで再起動ポリシーを変更しても解決しません。Restart= は、タイムアウトなどのプロセス終了や失敗に反応します。しかし、メイン PID(プロセス識別子)が実行中の別のプロセスに割り当てられている場合、バックグラウンドデーモンの終了は検知しません。まず Type= を修正してください。メインプロセスが実際に終了した後に systemd が行う処理は別の判断であり、Restart= と RestartSec= のガイドで説明しています。
Type= が実際に決めること
すべての Type= の値は、2 つの問いに同時に答えます。この unit を systemd が起動済みと見なせるのはいつか。そして、どのプロセスをメインプロセスとするかです。
1 つ目の答えは、起動順序を制御します。After= で自分の unit を指定する unit は、systemd が自分の unit を起動済みと判断するまで待機します。早すぎる段階で「起動済み」を報告する Type= では、サービスが応答可能になる前に依存 unit が実行を開始します。
2 つ目の答えは、監視方法を制御します。systemd は、unit が起動するすべてのプロセスを cgroup(control group)に配置します。cgroup は、プロセスをグループ化して、まとめて制限したり終了させたりできるカーネル機能です。systemctl stop は cgroup を使ってクリーンアップします。KillMode= のデフォルトは control-group なので、unit を停止すると、その内部にあるすべてのプロセスにシグナルが送られます。メイン PID は、これより対象が限定されます。デフォルトの ExitType=main と RemainAfterExit=no では、メイン PID は、そのプロセスの終了によって unit が終了し、その終了ステータスが unit の結果に反映される、単一のプロセスです。cgroup をメイン PID と同じものとして扱うと、混乱が始まります。
Type=simple はバイナリの実行前に起動済みと報告する
Type=simple は、ExecStart= が設定され、Type= と BusName= のどちらも存在せず、unit が認証情報を使用しない場合のデフォルトです。たとえば LoadCredential= で認証情報を読み込む unit では、代わりに Type=exec が暗黙的に指定されます。simple では、systemd がプロセスを作成すると直ちに unit を起動済みとみなし、そのプロセスをメイン PID として扱います。後続の unit は、サービスバイナリが実行される前に直ちに起動します。
この点が、よくある意外な動作の原因です。ExecStart= のパスに誤字があっても、起動ジョブは成功します。その直後、実行に失敗した時点でエラーになります。systemd はこのケースを終了コード 203 で記録します。systemd 自身の表では、このコードを EXIT_EXEC として示し、実際のプロセス実行に失敗したことを表します。したがって、systemctl start がエラーなしで返ってきても、バイナリが存在することの証明にはなりません。
フォアグラウンドで動作し、バックグラウンドへ移行しないプログラムには simple を使用します。これは、現在のほとんどのデーモンと、自分で作成するほぼすべてのプログラムに適しています。
Type=exec はプログラムの実際の起動を待機します
Type=exec は simple にもう 1 つ手順を加えたものです。systemd は、fork とバイナリの実行が両方とも成功した後にのみ、unit が起動したと判断します。バイナリが存在しない場合や、解決できない User= がある場合、start ジョブ自体が失敗します。成功と報告した直後にひそかに失敗することはありません。
Type=exec は upstream の systemd 240 で導入されました。ただし、ディストリビューションによるバックポートにより、古いバージョンでも利用できる場合があります。RHEL 8 では systemd-239-15.el8 で追加されました。サポート対象の古いリリースでも、これに対応していない場合があります。Ubuntu 18.04 は 2028 年 4 月まで ESM の対象ですが、その systemd 237 のマニュアルには、サポートされる type として exec が記載されていません。2026 年 10 月時点で、Ubuntu 24.04 は systemd 255、Debian 13 は systemd 257 を採用しています。systemctl --version とディストリビューションの systemd.service マニュアルで、使用中のバージョンを確認してください。
起動時に同期手順が 1 つ増えることがコストです。一方、systemctl start から正確な終了ステータスを取得できます。フォアグラウンドで動作するプログラムには、simple より exec を優先してください。
Type=forking とメイン PID が失われる仕組み
Type=forking は、ExecStart= のプロセスが子プロセスをフォークしてから意図的に終了することを systemd に伝えます。systemd は最初のプロセスが終了するまで待機し、その後でユニットが起動したと判断します。残された子プロセスがデーモンです。この方式は SysV 時代に由来します。当時は init スクリプトが戻った後にデーモンを監視する仕組みがなく、実行中のプロセスを記録する手段は PID ファイルだけでした。これは systemd が init スクリプトに置き換わった理由の中心的な制約の 1 つです。
難しいのはプロセスの識別です。systemd が起動したプロセスはすでに終了しているため、systemd は残ったプロセスのうち、どれがメインプロセスかを判断する必要があります。PIDFile= にデーモンが書き込むファイルを指定します。通常は /run 配下のパスです。systemd はそのファイルから PID を読み取ります。このファイルを権限のないユーザーが所有している場合、systemd は、そこに記録された PID がすでにこのサービスに属するプロセスを指しているかどうかも確認します。そのため、無関係なプロセスを指す古い PID ファイルや偽装された PID ファイルは信頼されず、拒否されます。
PIDFile= がない場合は GuessMainPID= が適用され、デフォルト値は yes です。この推測が信頼できるのは、サービスが単一のプロセスに落ち着く場合だけです。マニュアルには制限が明記されています。デーモンが複数のプロセスで構成されている場合、推測を誤ることがあります。また、メイン PID を特定できない場合、障害検出と自動再起動は確実に機能しません。ユニットの cgroup 内でデーモンのプロセスが実行中であっても、ユニットのメイン PID が 0 になることがあります。これは systemd がメインプロセスを追跡していないことを意味します。
フォークするデーモンの多くには、フォアグラウンドで実行し続けるスイッチもあります。そのスイッチを Type=exec とともに使用し、PIDFile= の行を削除してください。構成要素が減れば、PID を失う可能性も減ります。
終了する処理には Type=oneshot
Type=oneshotは、プロセスが実行されて終了することを前提とします。systemd は、プロセスが終了した後にのみ unit を started とみなします。そのため、別の unit が完了を待つ必要がある処理には oneshotが適しています。Type=と ExecStart=のどちらも指定されていない unit では、これが暗黙のデフォルトにもなります。
oneshotには、固有の動作が2つあります。複数の ExecStart=行を指定できる唯一のタイプであり、それらの行は順番に実行されます。また、開始タイムアウトはデフォルトで無効です。そのため、ハングした oneshotは、TimeoutStartSec=を自分で設定しない限り永遠に待機します。
プロセスが終了すると、unit は inactive に戻ります。RemainAfterExit=yesを指定すると、実行中のプロセスがない状態でも activeのままになります。これは、このページ冒頭にある症状を意図的に実現する方法であり、unit の役割が何かを実行し続けることではなく、状態を残すことの場合に正しい動作です。たとえば、ファイアウォールのルールセットを読み込む処理や、コンテナのスタックを起動する処理が該当します。再起動後に復帰する Docker Compose スタックもこのパターンです。unit が compose コマンドを実行して終了し、起動したコンテナが unit より長く動作するため、unit は active のままになります。oneshot unit は、スケジュールによって起動する処理にも適しています。これは、cron ではなく systemd timer でジョブを実行する方法のもう一つの要素です。
Type=notify でサービスに準備完了を通知させる
Type=notify により、判断をサービス側に移します。systemd は、プロセスが Unix ソケット経由で READY=1 を送信するまで、起動ジョブを完了させずに待機します。このソケットのパスは、NOTIFY_SOCKET 環境変数でプロセスに渡されます。C インターフェースは sd_notify(3) で、多くのサーバーがすでに対応しています。
これは、「起動済みか」という問いに対する正確な判定です。simple と exec は、サービスが設定を読み込んだり、待ち受けソケットを開いたりする前に起動済みと報告します。そのため、依存ユニットが早く起動し、最初の接続に失敗することがあります。notify は、サービス自身が準備完了を通知した時点で起動済みと報告します。
systemd は、メインプロセスからの通知だけを受け付けます。これが NotifyAccess=main の意味であり、Type=notify もこれを示します。子プロセスまたはヘルパーから通知する場合は、NotifyAccess=all を設定します。シェルスクリプトからは systemd-notify --ready を呼び出せます。権限がある場合、systemd-notify は親プロセスの PID として通知を送信します。そのため、スクリプト自身がメインプロセスであれば NotifyAccess=main を渡します。それ以外の場合はスクリプト自身の PID にフォールバックするため、ユニットには NotifyAccess=all が必要です。デフォルトでは、systemd が通知を処理するまで終了を待機します。この待機を無効にする --no-block は省略してください。このプロトコルをサービス自身が実装する構成のほうが信頼性が高くなります。
関連する設定を 2 つ確認しておきます。systemd 253 以降で使用できる Type=notify-reload は、同じハンドシェイクをリロードにも適用します。そのため、systemctl reload はシグナルを送信した時点ではなく、サービスがリロード完了を通知した時点で戻ります。2026 年 9 月にリリースされた systemd 262 以降では、notify-reload サービスが、リロードシグナルを捕捉もブロックもせずに READY=1 を送信すると、プロトコルエラーで起動に失敗します。リロード時にそのシグナルで終了することはありません。デフォルトのリロードシグナルは SIGHUP ですが、ReloadSignal= で別のシグナルを指定できます。WatchdogSec= は、通知を行うサービスに一定間隔でキープアライブメッセージを送信するよう要求します。systemd は、期限までにメッセージを受信できない場合を失敗として扱います。
Type=dbus と Type=idle
Type=dbus は、system と desktop のサービスが相互通信に使用するメッセージバスである D-Bus 上で、サービスが名前を取得するまで待機します。BusName= が必要で、BusName= を設定するとデフォルトになります。実際にバス名を登録するサービスにのみ使用してください。
Type=idle は simple と同様に動作しますが、キューに入ったジョブのディスパッチが完了するまでプログラムの実行を遅延させます。待機時間の上限は 5 秒です。これは、ブート時のコンソール出力がステータスメッセージと混在しないようにするための機能です。順序制御には使用せず、通常のサービスにも設定しないでください。
ラッパースクリプトによって 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 9101systemd は shell をメイン PID として記録します。shell は exporter をフォアグラウンドで実行している間も生存します。server が終了しても shell はそれを検知しないため、メイン PID は生存したままです。unit は引き続き active であり、Restart= が処理すべき対象もありません。どちらのプロセスも終始 unit の cgroup に属しているため、systemctl stop によるクリーンアップは正常に機能します。壊れているのは監視であり、クリーンアップではありません。
修正方法は、unit が実際に実行する長時間稼働プロセスの数によって異なります。
1 つの場合は、shell をそのプロセスに置き換えます。
#!/bin/bash
export APP_ENV=production
exec /opt/app/bin/server --config /etc/app.yamlexec は shell を指定されたプログラムに置き換え、同じ PID を維持します。そのため、systemd が記録した PID は daemon の PID になります。さらによい方法は、wrapper 自体を削除することです。Environment= と EnvironmentFile= で変数を渡し、ExecStartPre= でセットアップ処理を実行すれば、systemd は daemon を直接起動でき、構造上その PID を把握できます。
2 つの場合は、unit を単一の PID で表すことはできません。2 つの unit に分割し、After= と Wants= で起動順序を指定します。1 プロセスにつき 1 unit とする構成は、systemd が適切に監視できる方法です。また、各プロセスに個別の再起動動作を持たせる唯一の方法でもあります。
ExitType=cgroup で変わること
ExitType= は systemd 250 で追加されました。デフォルトは main です。メインプロセスが終了すると、unit は停止したと見なされます。ExitType=cgroup を指定すると、cgroup 内のいずれかのプロセスが生存している間、unit は実行中と見なされます。
[Service]
Type=simple
ExitType=cgroup
ExecStart=/opt/app/launcherこれは、特定の問題を解決します。実際の処理を開始した後に終了するランチャーは、ExitType=main では systemd に unit が停止したと判断させ、生き残ったプロセスも終了させます。ExitType=cgroup を指定すると、unit はプロセスグループ全体に従います。
解決しない問題も明確にしておきます。ExitType=cgroup では、少なくとも 1 つのプロセスが生存している間、unit は active のままです。そのため、2 つの daemon を保持する unit は、一方が終了しても active のままになります。これはランチャーのケースを解決します。ただし、1 つの unit が複数の独立したプロセスを監視する supervisor になるわけではありません。ExitType=cgroup は Type=oneshot とも併用できません。
cgroup はリソース使用量の計上先でもあります。そのため、MemoryMax= や CPUQuota= などの制限は、unit が起動したすべてのプロセスに適用されます。これは、Type= がメイン PID について何を示すかに関係ありません。この点については、systemd でサービスのメモリと CPU を制限するで説明しています。
systemd が実際に監視しているプロセスを確認する方法
デバッグ対象の unit で、次の手順を順番に実行します。まず unit ファイルを読み、次に systemd が追跡している内容を確認し、その後でプロセステーブルと比較します。
systemctl cat app.service
systemctl show -p Type,ExitType,GuessMainPID,PIDFile,MainPID,RemainAfterExit app.servicesystemctl cat は、ディスク上でその unit に適用されるすべての drop-in と unit ファイルを出力します。ファイルを変更した後に daemon-reload を実行していない場合、これらの内容は systemd が読み込んだ内容と異なることがあります。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 は、unit の cgroup に属するすべてのプロセスを一覧表示します。ps の行には、systemd が監視する単一のプロセスが示されます。2 つを合わせて確認してください。MainPID が 0 の場合、systemd-cgls が unit の cgroup 内のプロセスを一覧表示していても、systemd はメインプロセスを追跡していません。cgroup にデーモンも存在するのに、MainPID が shell を指している場合は、前述のラッパーのケースです。想定より多くのプロセスが cgroup に存在する場合は、ランチャーまたは fork するデーモンが関係しています。
systemctl status app.service
journalctl -u app.service -bsystemctl status は状態行と cgroup ツリーをまとめて出力するため、多くの場合、両方の疑問に一度に答えられます。journalctl -u を今回のブートに限定し、-b と組み合わせると、systemd が unit について記録した起動・停止イベントと、確認した終了コードが表示されます。デーモンが journal ではなく独自のログファイルに書き込む場合は、そのファイルも確認してください。systemd が記録できるのは、systemd に到達した内容だけだからです。
Type= を変更した場合は、reload してから restart します。
systemd-analyze verify /etc/systemd/system/app.service
sudo systemctl daemon-reload
sudo systemctl restart app.servicesystemd-analyze verify はファイルを解析し、受け付けられない設定を報告します。daemon-reload により、systemd はディスク上の unit ファイルを再読み込みします。変更した Type= は実行中の unit には適用されないため、restart は必須です。
次に、変更をテストします。systemd-cgls から、実際に確認したいプロセスの PID を取得して kill します。直後に systemctl is-active app.service を実行してください。ExitType=main と RemainAfterExit=no の設定では、メインプロセスを kill すると、その実行中のインスタンスが終了します。ただし、確認する前に restart policy によって再起動されることがあります。再起動せずに active のまま残る場合は、systemd が別のプロセスを監視していないか、unit が ExitType=cgroup または RemainAfterExit=yes を使用していないかを確認してください。
使用する systemd サービスの Type= はどれか
- フォアグラウンドで動作し続けるプログラム:
Type=exec。 - readiness 通知に対応するプログラム:
Type=notify。リロードも確認する場合はnotify-reload。 - バックグラウンドへの移行を必要とするデーモン:
PIDFile=と組み合わせたType=forking。または、Type=execでフォアグラウンドに切り替えます。 - 処理を実行して終了するスクリプト:
Type=oneshot。状態を残すことが目的の場合はRemainAfterExit=yesも使用します。 - 子プロセスの実行を継続したまま終了するランチャー:
ExitType=cgroupと組み合わせたType=simple。
サードパーティ製デーモンに必要な設定が不明な場合は、まずパッケージに含まれる unit ファイルを確認してください。ディストリビューションが提供した unit に対して systemctl cat を実行すると、パッケージで選択された Type= とローカルの上書き設定を確認できます。
FAQ
systemd の unit がプロセス終了後も active のままになるのはなぜですか?
デフォルトの ExitType=main と RemainAfterExit=no では、systemd がメインプロセスとして扱うプロセスがまだ生存しているためです。これらのデフォルトでは、systemd は Type= に基づいてサービスごとに 1 つのメイン PID を追跡します。Type=simple で起動したラッパースクリプトが、一般的な原因です。シェルがメイン PID になるため、シェルがバックグラウンドで起動したデーモンが終了しても、unit は active のままになります。systemctl show -p MainPID app.service を実行し、続いて systemd-cgls --unit=app.service で unit の cgroup を一覧表示して、2 つを比較してください。
Type=simple と Type=exec の違いは何ですか?
Type=simple では、systemd がプロセスを作成した時点で unit の起動完了とみなします。バイナリが実行される前の段階です。そのため、ExecStart= のパスが誤っていても、start job は成功した後に失敗します。Type=exec では、実行が成功するまで待機するため、その失敗は start job 自体によって報告されます。どちらも同じプロセスをメイン PID として扱います。Type=exec は upstream の systemd 240 で導入されましたが、ディストリビューションによっては古いバージョンへ backport されています。RHEL 8 では systemd-239-15.el8 に backport されています。
Type=forking でも PIDFile= は必要ですか?
デーモンが PID ファイルを書き込む場合は必要です。指定しないと、systemd は GuessMainPID= にフォールバックします。これは推測にすぎず、単一プロセスに収束するサービスでのみ信頼できます。推測が外れる場合や不可能な場合、その unit では失敗検出と自動再起動が安定して機能しません。PIDFile= には、デーモンが書き込む正確なパスを指定してください。通常は /run 配下です。
RemainAfterExit=yes はいつ使用すべきですか?
プロセスを実行し続けることではなく、システム状態を変更することが unit の目的である場合に使用します。ファイアウォールルールを読み込んだり、コンテナスタックを起動したりする Type=oneshot unit は、処理が完了すると終了します。RemainAfterExit=yes がない場合、unit は starting から stopping へ直ちに移行します。そのため、ExecStop= のクリーンアップは unit を停止したいタイミングではなく、処理の完了直後に実行されます。また、systemctl stop には停止対象が残りません。RemainAfterExit=yes を指定すると、プロセスがない状態でも unit は active のままになります。この動作がここでの意図です。
Type= を変更する場合、daemon-reload は必要ですか?
必要です。unit の再起動も必要です。systemctl daemon-reload は systemd にディスク上の unit ファイルを再読み込みさせますが、実行中のインスタンスは起動時に使用した Type= を保持します。テスト前に sudo systemctl daemon-reload を実行し、続いて sudo systemctl restart app.service を実行してください。そうしないと、古い監視動作を確認することになります。