systemd 服務狀態顯示 active 但 daemon 已終止
當 systemd 服務顯示 active 但 daemon 已消失,通常是 Type 設定錯誤導致。本文解析 simple、forking、notify 與 oneshot 的差異,教您正確定義主 PID 以解決狀態誤判問題。
systemd 為何在程序已結束時仍回報 unit 為 active
使用預設的 ExitType=main 與 RemainAfterExit=no 時,只要 systemd 所稱的主要程序仍在執行,systemd 服務 unit 就會維持 active;而 [Service] 區段中的 Type= 會決定該程序。若選錯值,systemd 可能會監控 shell wrapper 或短暫存在的父程序,而您關注的 daemon 卻在同一個 unit 內結束。這表示 unit 正確反映了系統要求它監控的程序狀態。
修改 restart policy 無法解決這個問題。Restart= 會處理程序結束和逾時等失敗情況,但當 main PID(process identifier)屬於仍在執行的程序時,它不會偵測背景 daemon 已結束。請先修正 Type=。主要程序確實結束後,systemd 應採取的動作是另一項設定,請參閱Restart= 與 RestartSec= 指南。
Type= 實際決定什麼
每個 Type= 值會同時回答兩個問題:systemd 何時可以將此單元視為已啟動,以及哪個程序是主要程序。
第一個答案控制啟動順序。在 After= 中指定此單元的單元,會等到 systemd 將此單元判定為已啟動後才繼續。若 Type= 太早回報「已啟動」,相依單元可能會在服務能夠回應請求前就開始執行。
第二個答案控制監督方式。systemd 會將單元建立的每個程序放入 cgroup(control group)。這是核心功能,可將程序分組,讓它們能一併受到限制並終止。systemctl stop 會透過 cgroup 清理程序:KillMode= 預設為 control-group,因此停止單元時會向其中的每個程序發出信號。主要 PID 的範圍較小。在預設的 ExitType=main 與 RemainAfterExit=no 設定下,主要 PID 是唯一一個其結束會使單元結束的程序,其結束狀態也會影響單元結果。將 cgroup 視為主要 PID,正是混淆的起點。
Type=simple 會在二進位檔執行前回報已啟動
Type=simple 是 ExecStart= 設定時的預設值,前提是未指定 Type= 或 BusName=,且該單元未使用任何認證資料。會載入認證資料的單元(例如使用 LoadCredential=)則會改用隱含的 Type=exec。在 simple 下,systemd 會建立程序,立即將該單元視為已啟動,並將該程序視為主要 PID。後續單元會立即開始,甚至早於服務二進位檔實際執行。
這項細節說明了一個常見的意外情況。即使 ExecStart= 路徑拼寫錯誤,啟動工作仍會先成功,稍後執行失敗時才會回報錯誤。systemd 會以結束代碼 203 記錄此情況;其自身的表格將此代碼命名為 EXIT_EXEC,並定義為實際程序執行失敗。因此,systemctl start 無錯誤返回,並不能證明你的二進位檔存在。
對於會在前景執行、且不會自行移到背景的程式,請使用 simple。大多數現代 daemon,以及幾乎所有自行撰寫的程式,都符合這種情況。
Type=exec 會等待程式實際啟動
Type=exec 與 simple 相同,但會多執行一個步驟。systemd 只有在 fork 和執行 binary 都成功後,才會將 unit 視為已啟動。若 binary 不存在,或 User= 目前無法解析,啟動工作本身就會失敗,而不是先回報成功,稍後才靜默失敗。
Type=exec 在 systemd 240 中加入上游版本,但發行版可能將其 backport 至較舊版本:RHEL 8 已在 systemd-239-15.el8 加入此功能。支援的舊版仍可能缺少此功能:Ubuntu 18.04 的 ESM 支援持續至 2028 年 4 月,而其 systemd 237 手冊未將 exec 列為支援的類型。截至 2026 年 10 月,Ubuntu 24.04 隨附 systemd 255,Debian 13 隨附 systemd 257。使用 systemctl --version 和該發行版的 systemd.service 手冊確認版本與支援狀態。
代價是啟動時多一個同步步驟。優點是 systemctl start 能回報可信的結束狀態。對於前景程式,請優先使用 exec,而不是 simple。
Type=forking 與主 PID 遺失的問題
Type=forking 用於告知 systemd,ExecStart= 中的處理程序會產生子處理程序(fork)後自行結束。systemd 會等待該初始處理程序結束,隨後才將該單元(unit)標記為已啟動。留下的子處理程序即為背景常駐程式(daemon)。這種習慣源自 SysV 時代,當時 init 腳本執行完畢後便無任何機制監控常駐程式,PID 檔案成為記錄執行狀態的唯一依據;這項限制正是 為何 systemd 取代 init 腳本 的核心原因之一。
其困難點在於識別身分。由於 systemd 啟動的處理程序已結束,systemd 必須判斷存活下來的處理程序中,哪一個才是主處理程序。請將 PIDFile= 設定為常駐程式寫入的檔案路徑(通常位於 /run 下),systemd 會從中讀取 PID。當該檔案由非特權使用者擁有時,systemd 還會檢查檔案中的 PID 是否確實屬於該服務,藉此拒絕使用過期或惡意植入、指向無關處理程序的檔案。
若未設定 PIDFile=,則會套用 GuessMainPID=,其預設值為 yes。此自動判斷機制僅在服務維持單一處理程序時才可靠。手冊明確指出其限制:若常駐程式包含多個處理程序,自動判斷可能會得出錯誤結論;若無法判定主 PID,失敗偵測與自動重啟功能將無法可靠運作。單元的主 PID 也可能變為 0,這代表 systemd 未追蹤任何主處理程序,即使該單元的 cgroup 中仍有常駐程式在執行。
大多數會進行 fork 的常駐程式都提供讓其維持在前台執行的參數。請搭配 Type=exec 使用該參數,並刪除 PIDFile= 行。減少運作中的變數,即能降低 PID 遺失的風險。
Type=oneshot 適用於完成後結束的工作
Type=oneshot 預期程序會執行後結束。systemd 會在該程序結束後,才將 unit 視為已啟動,因此 oneshot 適合用於任何其他 unit 必須等待的工作。若 unit 未指定 Type= 或 ExecStart=,也會隱含採用此預設值。
oneshot 有兩項特有行為。它是唯一允許使用多個 ExecStart= 行的類型,且這些行會依序執行。它的啟動逾時預設也已停用,因此除非自行設定 TimeoutStartSec=,否則卡住的 oneshot 會永遠等待。
程序結束後,unit 會回到 inactive。RemainAfterExit=yes 會讓它保持 active,即使完全沒有程序執行。這正是本頁開頭所述症狀的刻意版本;當 unit 的工作是留下狀態,而不是持續執行某項服務時,這種行為就是正確的,例如載入防火牆規則集,或啟動容器堆疊。重新開機後會恢復的 Docker Compose 堆疊 就採用這種模式:unit 執行 compose 命令後結束,但因為它啟動的容器仍在執行,所以 unit 會保持 active。oneshot unit 也適合執行由排程觸發的工作,這也是使用 systemd timer 執行工作,而不是使用 cron的另一半。
Type=notify 讓服務能自行回報就緒狀態
Type=notify 將決策權移交給服務本身。systemd 會暫停啟動作業,直到處理程序透過 Unix socket 發送 READY=1 為止;該 socket 路徑由 NOTIFY_SOCKET 環境變數提供。其 C 語言介面為 sd_notify(3),目前許多伺服器軟體皆已支援。
這是針對「服務是否已啟動」問題最準確的判斷方式。simple 與 exec 在服務尚未讀取設定檔或開啟監聽埠前就會回報已啟動,導致相依單元過早啟動並因連線失敗而崩潰。notify 則是在服務自身宣告就緒的當下回報已啟動。
systemd 僅接受來自主要處理程序的訊息,這正是 NotifyAccess=main 的定義,而 Type=notify 亦隱含此意。若訊息來自子處理程序或輔助程式,請設定 NotifyAccess=all。Shell script 可呼叫 systemd-notify --ready。若具備足夠權限,systemd-notify 會以父處理程序的 PID 發送訊息,因此若 script 本身即為主要處理程序,請傳入 NotifyAccess=main;否則它會退而求其次使用自身的 PID,此時單元需設定 NotifyAccess=all。預設情況下,systemd 會在處理完訊息後才結束執行,因此請勿加入 --no-block,該旗標會關閉此等待機制。自行實作此協定的服務可靠性更高。
有兩個相關設定值得了解。Type=notify-reload 自 systemd 253 起提供,將相同的交握機制擴展至重新載入(reload)作業,因此 systemctl reload 會在服務回報重新載入完成後才返回,而非發送訊號後立即返回。自 2026 年 9 月發布的 systemd 262 起,若 notify-reload 服務發送了 READY=1 卻未攔截或阻擋其重新載入訊號(除非 ReloadSignal= 另有指定,否則預設為 SIGHUP),則會在首次重新載入時因協定錯誤而啟動失敗,而非直接被該訊號終止。WatchdogSec= 要求通知型服務定期發送存活訊息(keep-alive),若錯過期限,systemd 將視為服務失敗。
Type=dbus 與 Type=idle
Type=dbus 會等待服務在 D-Bus 上取得名稱;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。當 exporter 在前景執行時,shell 會保持運作。若 server 終止,shell 無法察覺,因此主要 PID 依然存活,單元狀態仍為 active,且 Restart= 沒有任何處理對象。由於兩個處理程序始終位於該單元的 cgroup 中,systemctl stop 仍能正確執行清理。損壞的是監控機制,而非清理機制。
解決方案取決於該單元實際包含多少個長時間執行的處理程序。
若只有一個,請用該程式取代 shell。
#!/bin/bash
export APP_ENV=production
exec /opt/app/bin/server --config /etc/app.yamlexec 會以指定的程式取代 shell 並保留相同的 PID,因此 systemd 記錄的 PID 現在即為該 daemon。更好的做法是移除封裝腳本。Environment= 與 EnvironmentFile= 可用來傳遞變數,而 ExecStartPre= 可處理設定步驟,讓 systemd 能直接啟動 daemon 並在建立時即掌握其 PID。
若有兩個,則沒有單一 PID 能代表該單元。請將其拆分為兩個單元,並使用 After= 與 Wants= 進行排序。每個處理程序對應一個單元是 systemd 能妥善監控的配置,這也是讓每個處理程序擁有各自重啟行為的唯一方式。
ExitType=cgroup 的變更
ExitType= 在 systemd 250 中加入。預設值為 main:主要程序結束時,systemd 會將單位視為已停止。使用 ExitType=cgroup 時,只要其 cgroup 中仍有任何程序存活,systemd 就會將單位視為仍在執行。
[Service]
Type=simple
ExitType=cgroup
ExecStart=/opt/app/launcher這會解決一個特定問題。若啟動器啟動實際工作程序後便結束,在 ExitType=main 設定下,systemd 會將單位視為已停止,並終止仍在執行的程序。使用 ExitType=cgroup 時,單位會改為跟隨整個程序群組。
請明確了解它無法解決的問題。ExitType=cgroup 會在至少一個程序存活時保持單位為 active,因此包含兩個 daemon 的單位,在其中一個 daemon 結束後仍會保持 active。它能修正啟動器的情境,但不會讓一個單位變成多個獨立程序的 supervisor。ExitType=cgroup 也無法與 Type=oneshot 搭配使用。
cgroup 也會接收資源 accounting,因此 MemoryMax= 和 CPUQuota= 等限制會套用至單位啟動的每個程序,不受 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 檔案,以及所有套用到該 unit 的 drop-in 檔案;如果檔案在未執行 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 監看的單一程序。請一起查看這兩項內容。MainPID 為 0 表示 systemd 沒有追蹤任何主要程序,即使 systemd-cgls 仍列出 unit cgroup 中的程序。若 MainPID 顯示為 shell,而 cgroup 同時包含您的 daemon,這就是前述的 wrapper 情況。若 cgroup 中的程序數量超出預期,表示其中涉及 launcher 或會 fork 的 daemon。
systemctl status app.service
journalctl -u app.service -bsystemctl status 會同時列出狀態行與 cgroup 樹狀結構,因此通常能一次回答這兩個問題。使用 -b 限定在本次開機,再執行 journalctl -u,即可查看 systemd 為該 unit 記錄的啟動與停止事件,以及它看到的結束碼。如果 daemon 將內容寫入自己的 log 檔案,而不是 journal,也要一併讀取該檔案,因為 systemd 只能記錄傳送到它的內容。
變更 Type= 後,請重新載入並重新啟動。
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,因此重新啟動是必要步驟,不能省略。
接著測試變更。從 systemd-cgls 取得實際關心之程序的 PID,然後將它終止。緊接著執行 systemctl is-active app.service。搭配 ExitType=main 和 RemainAfterExit=no 時,終止主要程序會結束該執行個體,但 restart policy 可能會在您檢查前將它重新啟動。如果它保持 active 且未重新啟動,請檢查 systemd 是否正在監看其他項目,或該 unit 是否使用 ExitType=cgroup 或 RemainAfterExit=yes。
應使用哪個 systemd 服務 Type=
- 會在前景持續執行的程式:
Type=exec。 - 支援就緒通知的程式:
Type=notify;若也會確認重新載入,則使用notify-reload。 - 必須切換至背景執行的 daemon:搭配
PIDFile=使用Type=forking,或搭配Type=exec使用其前景模式選項。 - 執行工作後結束的指令碼:
Type=oneshot;若目的是留下狀態,則再加上RemainAfterExit=yes。 - 結束後仍讓子程序持續執行的啟動器:搭配
ExitType=cgroup使用Type=simple。
如果不確定第三方 daemon 需要哪一種設定,請先讀取其套件提供的 unit 檔案。對發行版提供的 unit 執行 systemctl cat,即可查看套件採用的 Type= 選擇以及本機覆寫設定。
FAQ
為什麼程序已結束,我的 systemd unit 仍保持 active?
使用預設的 ExitType=main 與 RemainAfterExit=no 時,這是因為 systemd 視為主要程序的程序仍在執行。在這些預設設定下,systemd 會依據 Type=,為每個服務追蹤單一主要 PID。以 Type=simple 啟動的 wrapper script 是最常見的原因:shell 會成為主要 PID,因此當 shell 在背景啟動的 daemon 結束時,unit 仍保持 active。執行 systemctl show -p MainPID app.service,接著使用 systemd-cgls --unit=app.service 列出該 unit 的 cgroup,再比對兩者。
Type=simple 與 Type=exec 有什麼差異?
Type=simple 會在 systemd 建立程序後立即視為 unit 已啟動,此時 binary 尚未執行。因此,即使 ExecStart= 中的路徑錯誤,啟動工作仍會先成功,之後才失敗。Type=exec 會等到執行成功後才完成啟動,因此該失敗會直接由啟動工作回報。兩者都會將同一個程序視為主要 PID。Type=exec 在 systemd 240 中由 upstream 引入,但各發行版可以將其 backport 至較舊版本,例如 RHEL 8 在 systemd-239-15.el8 中的作法。
使用 Type=forking 時,仍需要 PIDFile= 嗎?
需要,只要 daemon 會寫入 PIDFile。若未設定,systemd 會改用 GuessMainPID=。這是推測值,只有在服務最終穩定為單一程序時才可靠。若推測錯誤或無法推測,該 unit 的失敗偵測與自動重新啟動都無法可靠運作。將 PIDFile= 指向 daemon 寫入的確切路徑,通常位於 /run 下。
何時應使用 RemainAfterExit=yes?
當 unit 的用途是變更系統狀態,而不是持續執行某個程序時。例如,載入防火牆規則或啟動容器 stack 的 Type=oneshot unit,會在工作完成後立即結束。若沒有 RemainAfterExit=yes,unit 會直接從 starting 進入 stopping,因此任何 ExecStop= cleanup 都會在工作完成後立即執行,而不是在你選擇停止 unit 時執行;systemctl stop 也沒有任何項目可以停止。設定後,unit 會在沒有程序的狀態下保持 active,這正是此處預期的行為。
變更 Type= 後需要執行 daemon-reload 嗎?
需要,也需要重新啟動該 unit。systemctl daemon-reload 會讓 systemd 重新讀取磁碟上的 unit 檔案,但正在執行的 instance 仍會保留啟動時使用的 Type=。測試前先執行 sudo systemctl daemon-reload,再執行 sudo systemctl restart app.service;否則你仍在觀察舊的 supervision 行為。