systemd Type=simple、exec、forking、notify 怎么选
systemd 单元显示 active 但守护进程已退出?本文解析 Type=simple、exec、forking、oneshot、notify 的主 PID 识别、启动时机与常见误配置。
为什么 systemd 会在进程已退出时仍报告单元处于 active 状态
使用默认的 ExitType=main 和 RemainAfterExit=no 时,只要 systemd 称为主进程的那个进程仍在运行,systemd 服务单元就会保持 active 状态;[Service] 部分中的 Type= 决定该进程。选择错误的值后,systemd 可能会监控 shell 包装进程或很快退出的父进程,而您关注的守护进程则在同一单元中退出。该单元反映的是 systemd 被配置为监控的进程状态。
修改重启策略无法解决此问题。Restart= 会响应进程退出和超时等故障,但如果主 PID(进程标识符)属于仍在运行的进程,它不会检测后台守护进程的退出。请先修复 Type=。主进程真正退出后 systemd 应执行的操作是另一个独立决策,详见Restart= 和 RestartSec= 指南。
Type=实际决定什么
每个 Type= 值会同时回答两个问题:systemd 何时可以认为此单元已启动,以及哪个进程是主进程。
第一个答案控制启动顺序。在 After= 中声明依赖于该单元的单元,会等到 systemd 调用该单元已启动后再继续。若 Type= 过早报告“已启动”,依赖单元就可能在服务能够响应请求之前运行。
第二个答案控制监控方式。systemd 会将单元派生的每个进程放入 cgroup(控制组)。cgroup 是内核提供的进程分组机制,可统一限制并终止这些进程。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。大多数现代守护进程以及几乎所有自行编写的程序都属于此类。
Type=exec 会等待程序实际启动
Type=exec 与 simple 相同,但多执行一步。systemd 只有在 fork 和二进制文件执行均成功后,才会将单元视为已启动。二进制文件缺失,或无法解析的 User=,现在会直接导致启动作业失败,而不是先报告成功,再在片刻后静默失败。
Type=exec 在 systemd 240 中由上游引入,但发行版的回移植版本也会在更早版本中提供该功能:RHEL 8 在 systemd-239-15.el8 中加入了它。受支持的旧版本仍可能缺少该功能:Ubuntu 18.04 的 ESM 支持持续到 April 2028,其 systemd 237 手册没有将 exec 列为受支持的类型。截至 October 2026,Ubuntu 24.04 提供 systemd 255,Debian 13 提供 systemd 257。使用 systemctl --version 和发行版的 systemd.service 手册进行检查。
代价是启动时增加一次同步步骤。收益是 systemctl start 能返回准确的退出状态。对于前台程序,优先使用 exec,而不是 simple。
Type=forking 与主 PID 丢失问题
Type=forking 用于告知 systemd,ExecStart= 中指定的进程会派生出一个子进程,随后主动退出。systemd 会等待该初始进程退出,之后才将单元标记为已启动。留下的子进程即为守护进程。这种做法源于 SysV 时代,当时 init 脚本执行完毕后,没有任何机制监控守护进程,PID 文件是记录运行状态的唯一手段。这一局限性正是 systemd 取代 init 脚本的原因 的核心所在。
难点在于身份识别。由于 systemd 启动的初始进程已经结束,它必须确定哪个存活进程才是主进程。将 PIDFile= 设置为守护进程写入的文件路径(通常位于 /run 下),systemd 就会从中读取 PID。当该文件由非特权用户所有时,systemd 还会校验其中的 PID 是否确实属于该服务,从而拒绝使用陈旧或被恶意篡改的 PID 文件,避免误将无关进程识别为主进程。
若未设置 PIDFile=,则会应用 GuessMainPID=,其默认值为 yes。这种猜测机制仅在服务最终稳定为单一进程时才可靠。手册对此有明确限制:如果守护进程包含多个进程,猜测可能会得出错误结论;一旦无法确定主 PID,故障检测和自动重启功能将无法可靠运行。单元甚至可能出现主 PID 为 0 的情况,这意味着 systemd 无法追踪任何主进程,即使守护进程的子进程仍在单元的 cgroup 中运行。
大多数会派生子进程的守护进程都提供在前台运行的选项。请使用该选项配合 Type=exec,并删除 PIDFile= 行。减少组件数量意味着降低了丢失 PID 的风险。
Type=oneshot 用于执行完成即退出的任务
Type=oneshot 要求进程运行后退出。systemd 只有在该单元启动的进程退出后,才会将其视为已启动,因此 oneshot 适用于其他单元必须等待的任务。如果单元既未指定 Type=,也未指定 ExecStart=,则默认使用该类型。
oneshot 有两项特有行为。它是唯一允许使用多个 ExecStart= 行的类型,并且这些行会按顺序执行。它的启动超时默认也处于禁用状态,因此如果 oneshot 卡住,systemd 会无限等待,除非您自行设置 TimeoutStartSec=。
进程退出后,该单元会恢复为非活动状态。RemainAfterExit=yes 会使其保持 active,即使没有任何进程在运行。这正是本页顶部所述现象的有意版本;当单元的任务是留下某种状态,而不是持续运行某个服务时,这种行为是正确的,例如加载防火墙规则集或启动容器堆栈。这也是 重启后恢复的 Docker Compose 堆栈 所采用的模式:该单元运行 compose 命令后退出,但由于它启动的容器仍在运行,因此单元保持活动状态。oneshot 单元也适合执行由计划触发的任务,这是 使用 systemd timer 而不是 cron 运行任务 的另一部分。
Type=notify 让服务能够告知其就绪状态
Type=notify 将决策权移交给服务。systemd 会保持启动任务处于挂起状态,直到进程通过 Unix 套接字发送 READY=1 为止;该套接字的路径由 NOTIFY_SOCKET 环境变量提供。其 C 语言接口为 sd_notify(3),目前许多服务器程序已提供支持。
这是针对“服务是否已启动”这一问题的准确答案。simple 和 exec 在服务读取配置或打开监听套接字之前就会报告已启动,这可能导致依赖单元过早启动并因首次连接失败而报错。notify 则在服务自身确认就绪时才报告启动完成。
systemd 仅接受来自主进程的消息,这就是 NotifyAccess=main 的含义,而 Type=notify 也隐含了这一点。如果消息来自子进程或辅助进程,请设置 NotifyAccess=all。Shell 脚本可以调用 systemd-notify --ready。当拥有相应权限时,systemd-notify 会以父进程的 PID 发送该消息,因此作为主进程的脚本可以传递 NotifyAccess=main;否则它会回退到使用自身的 PID,此时单元需要设置 NotifyAccess=all。默认情况下,它会等待 systemd 处理完消息后再退出,因此请勿使用 --no-block,该选项会关闭此等待机制。能够直接使用该协议的服务更为可靠。
有两个相关设置值得了解。Type=notify-reload 自 systemd 253 版本起可用,它将相同的握手机制扩展到了重载操作,因此 systemctl reload 会在服务报告重载完成时返回,而不是在信号发出时立即返回。自 2026 年 9 月发布的 systemd 262 版本起,如果一个 notify-reload 服务发送了 READY=1,但未捕获或阻塞其重载信号(除非 ReloadSignal= 另有指定,否则默认为 SIGHUP),则该服务会因协议错误而启动失败,而不是在首次重载时被该信号终止。WatchdogSec= 要求通知型服务按固定间隔发送存活消息,若错过截止期限,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 现在属于该守护进程。更好的方式是直接移除包装脚本。Environment= 和 EnvironmentFile= 负责传递变量,ExecStartPre= 负责执行设置步骤,因此 systemd 可以直接启动守护进程,并从一开始就知道它的 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,systemd 会认为该单元已停止,并终止仍在运行的进程。使用 ExitType=cgroup 后,该单元会跟踪整个进程组。
需要明确它无法解决的问题。只要至少有一个进程存活,ExitType=cgroup 就会让单元保持活动状态。因此,一个单元管理两个守护进程时,即使其中一个退出,该单元仍会保持活动。它可以解决启动器场景,但不会让一个单元变成多个独立进程的监督器。ExitType=cgroup 也不能与 Type=oneshot 结合使用。
cgroup 还负责资源记账,因此 MemoryMax= 和 CPUQuota= 等限制会应用于该单元启动的每个进程,不受 Type= 对主 PID 定义的影响。相关内容请参阅使用 systemd 限制服务的内存和 CPU。
如何查找 systemd 实际监控的进程
请按顺序在正在排查的单元上执行以下步骤。先读取单元文件,再读取 systemd 跟踪的信息,最后与进程表进行比较。
systemctl cat app.service
systemctl show -p Type,ExitType,GuessMainPID,PIDFile,MainPID,RemainAfterExit app.servicesystemctl cat 会从磁盘打印单元文件及适用于该单元的所有 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 会列出该单元 cgroup 中的所有进程。ps 行描述 systemd 监控的单个进程。请结合两者进行查看。MainPID 为 0 表示 systemd 没有跟踪主进程,即使 systemd-cgls 仍列出该单元 cgroup 中的进程。若 MainPID 解析为 shell,而 cgroup 中同时存在您的守护进程,则属于前文所述的包装器情况。若 cgroup 中的进程数超出预期,说明存在启动器或采用 fork 的守护进程。
systemctl status app.service
journalctl -u app.service -bsystemctl status 会同时打印状态行和 cgroup 树,因此通常可以一次回答这两个问题。使用 -b 将 journalctl -u 限制在本次启动范围内,可以查看 systemd 为该单元记录的启动和停止事件,以及它观察到的退出代码。如果守护进程将日志写入自己的日志文件而不是 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,并终止该进程。随后立即运行 systemctl is-active app.service。对于 ExitType=main 和 RemainAfterExit=no,终止主进程会结束该运行实例,但重启策略可能会在您检查之前将其重新启动。如果它保持活动状态且没有重启,请检查 systemd 是否监控了其他对象,或该单元是否使用了 ExitType=cgroup 或 RemainAfterExit=yes。
应使用哪种 systemd 服务 Type=
- 保持在前台运行的程序:
Type=exec。 - 支持就绪通知的程序:
Type=notify;如果还会确认重载完成,则使用notify-reload。 - 必须转入后台运行的 daemon:将
Type=forking与PIDFile=配合使用,或使用其前台运行选项Type=exec。 - 执行任务后退出的脚本:
Type=oneshot;如果目的是留下状态,还应使用RemainAfterExit=yes。 - 退出后由子进程继续运行的启动器:将
Type=simple与ExitType=cgroup配合使用。
如果不确定第三方 daemon 需要哪一种设置,请先查看其软件包提供的 unit 文件。对发行版提供的 unit 运行 systemctl cat,可以查看软件包预设的 Type= 选择以及本地覆盖配置。
FAQ
为什么进程已退出,但我的 systemd 单元仍保持 active?
使用默认的 ExitType=main 和 RemainAfterExit=no 时,这是因为 systemd 视为主进程的进程仍在运行。在这些默认设置下,systemd 为每个服务跟踪一个主 PID,并根据 Type= 选择该 PID。使用 Type=simple 启动的包装脚本是最常见的原因:shell 是主 PID,因此当 shell 在后台启动的守护进程退出时,单元仍保持 active。运行 systemctl show -p MainPID app.service,然后使用 systemd-cgls --unit=app.service 列出该单元的 cgroup,并比较两者。
Type=simple 和 Type=exec 有什么区别?
Type=simple 在 systemd 创建进程后、执行二进制文件前,就认为单元已启动。因此,ExecStart= 中的路径错误仍会导致启动作业成功,随后进程才失败。Type=exec 会等待执行成功,因此该失败会由启动作业本身报告。两者都将同一进程视为主 PID。Type=exec 在 systemd 240 中由上游引入,但发行版可以将其向后移植到更早的版本,RHEL 8 就在 systemd-239-15.el8 中这样做了。
使用 Type=forking 时,仍需要 PIDFile= 吗?
需要,只要守护进程会写入 PID 文件。不设置它时,systemd 会回退到 GuessMainPID=;这只是推测,只有当服务最终稳定为单个进程时才可靠。如果推测错误或无法进行推测,该单元的失败检测和自动重启都无法可靠工作。将 PIDFile= 指向守护进程写入的准确路径,通常位于 /run 下。
什么时候应使用 RemainAfterExit=yes?
当单元的用途是修改系统状态,而不是持续运行进程时。加载防火墙规则或启动容器栈的 Type=oneshot 单元会在工作完成后立即退出。如果没有 RemainAfterExit=yes,单元会直接从 starting 进入 stopping,因此任何 ExecStop= 清理都会在工作完成后立即运行,而不是在您选择停止单元时运行;systemctl stop 也没有剩余内容可停止。启用它后,单元会在没有进程的情况下保持 active,这正是此处需要的行为。
修改 Type= 后需要执行 daemon-reload 吗?
需要,同时还要重启该单元。systemctl daemon-reload 会让 systemd 重新读取磁盘上的单元文件,但正在运行的实例仍会保留启动时使用的 Type=。在测试前运行 sudo systemctl daemon-reload,然后运行 sudo systemctl restart app.service;否则您看到的仍是旧的监管行为。