systemd 服務狀態顯示 active 但 daemon 已終止
當 systemd 服務顯示 active 但 daemon 已消失,通常是 Type 設定錯誤導致。本文解析 simple、forking、notify 與 oneshot 的差異,教您正確定義主 PID 以解決狀態誤判問題。
為什麼 systemd 在處理程序終止時仍顯示單元為 active
systemd 服務單元會保持 active 狀態,只要 systemd 所定義的主處理程序(main process)仍在執行,而 Type= 區段中的 [Service] 設定決定了該處理程序為何。若設定值錯誤,systemd 將會監控 shell 包裝器或生命週期短暫的父處理程序,而您實際關注的 daemon 卻在同一個單元內終止。該單元所顯示的狀態,反映了它被指定監控的處理程序之真實情況。
更改重啟策略對此無濟於事。Restart= 僅在主處理程序退出時才會觸發,因此只要主 PID(處理程序識別碼)仍屬於某個執行中的處理程序,Restart=always 就不會執行。請先修正 Type=。至於主處理程序真正退出後 systemd 的行為,則是另一項決策,詳見 Restart= 與 RestartSec= 指南。
Type= 參數的實際作用為何
每個 Type= 的值會同時回答兩個問題:systemd 何時認定此單元已啟動,以及哪一個行程是主行程。
第一個答案控制執行順序。在 After= 中指定您的單元的其他單元,會等待直到 systemd 呼叫您的單元並將其標記為已啟動。若 Type= 過早回報「已啟動」,會導致相依單元在您的服務準備就緒前就先行執行。
第二個答案控制監控機制。systemd 會將單元衍生的所有行程放入 cgroup (control group) 中;這是一項核心功能,能將行程分組以便統一限制或終止。cgroup 是 systemctl stop 進行清理的方式:KillMode= 預設為 control-group,因此停止單元時會對其中的所有行程發送訊號。主 PID (Main PID) 的定義則較為狹窄。它是唯一一個其結束會導致單元終止,且其結束狀態會成為單元執行結果的行程。將 cgroup 誤認為主 PID,正是混亂的根源。
Type=simple 會在二進位檔執行前回報服務已啟動
當設定了 ExecStart=,且未指定 Type= 與 BusName=,且該單元未使用任何憑證時,預設值為 Type=simple。若單元載入了憑證(例如透過 LoadCredential=),則會隱含使用 Type=exec。在 simple 模式下,systemd 會建立處理程序,立即視該單元為已啟動,並將該處理程序視為主要 PID。後續的單元會立即開始執行,甚至在服務的二進位檔尚未執行前就已啟動。
最後這個細節解釋了一個常見的意外情況。若 ExecStart= 路徑拼字錯誤,啟動任務仍會顯示成功,而錯誤會在稍後執行失敗時才出現。systemd 會將此類情況記錄為結束代碼 203,其內部表格將其命名為 EXEC,定義為執行服務二進位檔失敗。因此,systemctl start 回傳無錯誤並不代表您的二進位檔確實存在。
對於留在前景且不會自行轉入背景的程式,請使用 simple。這適用於大多數現代的 daemon 以及您自行編寫的絕大多數程式。
Type=exec 會等待程式實際啟動
Type=exec 是 simple 的進階版本。systemd 僅在 fork 與二進位檔執行皆成功後,才會將該單元視為已啟動。若二進位檔遺失或 User= 無法解析,啟動作業會直接失敗,而非回報成功後再於稍後靜默崩潰。
Type=exec 於 systemd 240 版本引入,因此目前所有基於 systemd 的伺服器發行版皆已支援。截至 2026 年 10 月,Ubuntu 24.04 搭載 systemd 255,Debian 13 則搭載 systemd 257。請使用 systemctl --version 檢查您的版本。
此設定的代價是啟動時會多出一個同步步驟,但優點是能從 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 僅在該單元結束後才會將其視為已啟動,這使得 oneshot 成為其他單元必須等待之任務的正確設定方式。當單元未指定 Type= 或 ExecStart= 時,這也是預設的行為。
oneshot 有兩種特定行為。它是唯一接受多行 ExecStart= 指令的類型,且這些指令會依序執行。其啟動逾時預設為停用,因此若 oneshot 發生掛起,除非您自行設定 TimeoutStartSec=,否則它會無限期等待。
處理程序結束後,該單元會回到非活動狀態。RemainAfterExit=yes 可使其保持 active 狀態,且無需執行任何處理程序。這是本頁開頭所述症狀的刻意版本,當單元的工作是留下狀態而非維持某個程序執行時(例如載入防火牆規則集或啟動容器堆疊),此設定是正確的。這也是 重開機後自動恢復的 Docker Compose 堆疊 背後的模式,其中單元執行 compose 指令後隨即結束,但因為它啟動的容器生命週期比單元本身更長,所以該單元仍保持活動狀態。oneshot 單元也是排程觸發的對象,這是 使用 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:當主程序結束時,該單元即被視為已停止。若設定為 ExitType=cgroup,則只要該 cgroup 中的任何程序仍在執行,該單元就會被視為執行中。
[Service]
Type=simple
ExitType=cgroup
ExecStart=/opt/app/launcher此設定解決了一個特定問題。在 ExitType=main 下,若啟動器(launcher)啟動了實際工作後隨即結束,systemd 會將該單元視為已停止並殺掉剩餘的程序。使用 ExitType=cgroup,該單元會追蹤整個程序群組的狀態。
請務必釐清此設定無法解決的問題。ExitType=cgroup 只要有至少一個程序存活就會保持單元為啟用狀態,因此若一個單元包含兩個 daemon,其中一個死亡後該單元仍會保持啟用。它僅修正了啟動器的案例,並不會將單一單元變成多個獨立程序的監控器。此外,ExitType= 無法與 Type=oneshot 同時使用。
cgroup 同時也是資源統計的依據,因此無論 Type= 對主 PID 的定義為何,諸如 MemoryMax= 與 CPUQuota= 等限制皆會套用於該單元所產生的所有程序。關於此部分的詳細說明,請參閱 使用 systemd 限制服務的記憶體與 CPU。
如何找出 systemd 實際監控的處理程序
請依照順序在您正在偵錯的單元(unit)上執行下列步驟。先讀取 systemd 載入的設定,再讀取其追蹤的內容,最後與處理程序表進行比對。
systemctl cat app.service
systemctl show -p Type,ExitType,GuessMainPID,PIDFile,MainPID,RemainAfterExit app.servicesystemctl cat 會列印出單元檔案以及所有套用的 drop-in 設定,確保您讀取的是 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 會列出該單元 cgroup 中的所有處理程序。ps 行描述了 systemd 所監控的單一處理程序。請將兩者對照閱讀。若 MainPID 為 0,表示 systemd 未追蹤任何主處理程序,即使 systemd-cgls 仍列出該單元 cgroup 中的處理程序。若 MainPID 指向一個 shell,而 cgroup 中同時包含您的 daemon,則屬於上述的封裝(wrapper)情況。若 cgroup 中的處理程序數量超出預期,則代表涉及啟動器(launcher)或分叉(forking)型 daemon。
systemctl status app.service
journalctl -u app.service -bsystemctl status 會同時列印狀態行與 cgroup 樹狀結構,通常能一次回答上述兩個問題。journalctl -u 加上 -b 參數可限制顯示本次開機的紀錄,呈現 systemd 為該單元記錄的啟動與停止事件,以及它所偵測到的結束代碼。若 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 從磁碟重新讀取單元檔案。修改後的 Type= 不會自動套用到已執行的單元,因此重啟是必須的,而非選用。
接著測試變更。從 systemd-cgls 取得您實際關注的處理程序 PID 並將其 kill。隨後立即執行 systemctl is-active app.service。若 Type= 設定正確,該單元應會離開 active 狀態。若它仍保持 active,表示 systemd 仍在監控其他處理程序。
應該使用哪種 systemd 服務 Type=
- 保持在前台執行的程式:
Type=exec。 - 支援就緒通知的程式:
Type=notify;若同時支援確認重新載入,則使用notify-reload。 - 強制轉入後台執行的常駐程式:搭配
PIDFile=使用Type=forking,或使用其前台執行參數搭配Type=exec。 - 執行完畢後退出的腳本:
Type=oneshot;若目的是為了保留狀態,則加上RemainAfterExit=yes。 - 啟動後即退出但子行程持續執行的啟動器:搭配
ExitType=cgroup使用Type=simple。
若不確定第三方常駐程式所需的類型,請先閱讀其封裝的 unit file。對發行版提供的 unit 執行 systemctl cat,即可查看上游選擇的 Type=,該選擇已經過比您更廣泛的測試。
FAQ
為什麼我的 systemd unit 在處理程序終止後仍顯示為 active?
因為 systemd 視為主程序的處理程序仍然存活。systemd 針對每個服務僅監控單一 PID(依據 Type= 選定),而非該 unit cgroup 中的所有處理程序。通常是因為使用了 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 建立處理程序後即視為啟動,此時二進位檔尚未執行,因此若 ExecStart= 路徑錯誤,仍會顯示啟動成功後隨即失敗。Type=exec 則會等待執行成功,因此啟動任務本身會直接回報失敗。兩者皆將相同的處理程序視為主 PID。Type=exec 需要 systemd 240 或更新版本。
使用 Type=forking 時仍需要 PIDFile= 嗎?
是的,只要 daemon 會寫入 PID 檔案就需要。若無此設定,systemd 會退而求其次使用 GuessMainPID=,這僅是推測,且僅對穩定維持單一處理程序的服務才可靠。當推測錯誤或無法推測時,該 unit 的失敗偵測與自動重啟功能將無法可靠運作。請將 PIDFile= 指向 daemon 寫入的確切路徑,通常位於 /run 下。
何時該使用 RemainAfterExit=yes?
當 unit 的目的是變更系統狀態而非維持處理程序執行時。例如一個 Type=oneshot unit 若用於載入防火牆規則或啟動容器堆疊,工作完成後即會結束。若無 RemainAfterExit=yes,unit 會直接從啟動狀態進入停止狀態,導致任何 ExecStop= 清理動作在工作完成後立即執行,而非在您選擇停止 unit 時執行,且 systemctl stop 也將無物可停。設定此選項後,unit 會在無處理程序的情況下保持 active,這正是此類情境的預期行為。
變更 Type= 是否需要執行 daemon-reload?
是的,且必須重啟該 unit。systemctl daemon-reload 會讓 systemd 重新讀取磁碟上的 unit 檔案,但執行中的實例仍會保留其啟動時的 Type=。測試前請務必執行 sudo systemctl daemon-reload 並接著執行 sudo systemctl restart app.service,否則您觀察到的仍是舊有的監控行為。