外观
18 - 服务器启动后,服务怎样被拉起来:systemd、就绪、退出与时间基础
摘要
终端能启动应用,systemd 却启动失败;显示 active,接口仍不可用。本文从这些差异出发,梳理启动链、Unit、依赖、执行环境和服务状态,区分进程启动与业务就绪、重载与重启,再用有期限的 Python 程序和服务模板解释托管职责,并建立日志时间与超时预算的基础。
阅读指引
- 前置阅读:创建、信号与退出、权限与安全策略、cgroup。
- 本文定位:以 systemd 主机上的普通长期服务为主;容器 PID 1、Kubernetes 探针与控制器分别在已有专题展开。
- 适用范围:服务模板以 systemd 252 及支持相关选项的后续版本为基线,不声称该版本是最新。实际安装版本、发行版补丁和模式以
systemd --version及本机 man 为准。 - 示例环境:Python 示例要求 Python 3.8+,只创建并等待自己的子进程。Unit 模板需在具备 systemd 的授权测试主机验证;配置检查与实际安装、修改启动目标、调整系统时间是不同操作。
1. 场景:启动命令一样,为什么服务管理器里失败
管理员在项目目录运行程序,环境变量、相对路径和当前用户都正确。交给 systemd 后,默认工作目录、身份、环境、权限和资源限制可能不同,程序便找不到文件或无法写入。
还有一个常见误会:systemctl start 成功就代表业务能接流量。这里的“成功”由服务类型与启动协议决定。创建进程只是获得一个执行主体;exec 是让进程执行指定程序;程序执行后,还可能需要读取配置、初始化连接池,才具备接收请求的条件。即使初始化完成,远端依赖也可能在运行期间失败。
先检查服务生命周期和执行环境,再决定是不是参数、权限、依赖或应用初始化问题。
2. 启动全景:系统启动与服务启动不是一件事
systemd 是管理系统启动和服务生命周期的软件。系统启动先准备运行程序所需的基础环境;服务启动则是在这些条件下运行某个应用。服务管理器负责启动、跟踪和停止程序,应用负责定义并实现自己的初始化与就绪条件。
图表将在阅读到此处时加载…
Initramfs 是早期用户空间使用的文件系统映像,用于根文件系统准备等启动工作。图中是常见启动链,不是所有平台的固定流程。系统初始化管理器也称 init;以 systemd 担任这一角色时,它通常是系统的 PID 1,即进程编号为 1 的进程。容器内的 PID 1、管理用户服务的 systemd 实例,以及其他 init 实现,需要分别看待。
2.1 Unit、Service、Target、Socket 和 Timer
Unit,即单元,是 systemd 描述管理对象的基本配置单位。服务是其中一种对象,挂载、监听 socket 和定时任务也可以分别由单元描述。配置文件后缀用于区分单元类型。Socket 是通信端点;FD(文件描述符)是进程引用已打开文件或 socket 等对象的编号。
| 类型 | 主要职责 | 常见误读 |
|---|---|---|
.service | 管理程序执行与生命周期 | 所有服务都必须后台 fork |
.target | 组合和同步相应单元关系 | 一个 target 就是传统固定串行启动脚本 |
.socket | 按 socket 激活协议提供监听等 | 应用无需适配就能接受管理器传入的 FD |
.timer | 定时激活其他单元 | 所有定时都使用同一种墙钟规则 |
.mount | 管理相应挂载 | 与应用自己的工作目录同义 |
系统会按依赖与激活安排工作,不一定按配置文件名字顺序逐个启动。因此,系统启动耗时不能把所有单元的运行时长直接相加:没有先后约束的工作可以并行,受依赖约束的最长等待链才可能决定整体完成时间,这条链称为关键路径。
3. 依赖与就绪:After 不等于 Requires
依赖配置要分别回答两个问题:是否把另一个单元一起启动,以及双方都要启动时谁先谁后。 Wants=、Requires= 主要表达前一个问题,After=、Before= 表达后一个问题。
例如,只写 After=database.service 不会主动启动数据库;只写 Wants=database.service 又没有相应排序时,也不能据此认定数据库先完成启动。即使排序已建立,“完成启动”仍取决于数据库单元的服务类型,不自动等于数据库可以处理查询。
| 配置 | 基础职责 | 不保证什么 |
|---|---|---|
After= / Before= | 当相关工作被安排时约束先后 | 单独使另一单元必定被启动 |
Wants= | 建立较弱的启动依赖 | 依赖失败一定让本服务失败 |
Requires= | 较强需求关系,失败/停用传播有条件 | 不加排序就得到完整先后,也不证明业务健康 |
[Install] WantedBy= | 为 enable 时安装激活关系提供信息 | 当前 start 已执行,或该段直接完成业务初始化 |
network-online.target 及相关等待服务的含义依网络管理配置,不代表任意远端数据库、DNS 和外网永久健康。应用仍需有期限的依赖连接、错误处理和重试预算。
3.1 Service Type 决定管理器看到什么启动边界
[Service] 中的 Type= 告诉管理器:到哪个阶段可以认为服务的启动工作已完成。这个边界也会影响有启动排序关系的后续单元何时继续。它不是管理器对任意业务接口的自动检测。
| Type | 主要启动边界 | 需要补的业务保证 |
|---|---|---|
simple | 相应进程创建阶段即按规则推进 | 不保证实际程序 exec 成功或业务就绪 |
exec | 实际执行程序的 exec 阶段成功 | 不保证初始化完成或监听可用 |
notify | 应用按协议发送就绪通知,如 READY=1 | 应用必须实现通知,且通知内容与真实就绪契约匹配 |
forking | 针对传统 fork 后台化程序的协议 | 正确识别主进程与生命周期,不作为现代服务通用模板 |
oneshot | 启动命令按相应规则执行结束 | 不等于有长期业务进程,状态还受其他配置影响 |
表中的 fork 指创建子进程,传统后台化程序通常让父进程退出、由子进程继续运行。前台运行的长期服务不需要为了托管而主动后台化。
Notify 协议中的 READY=1 不是一行普通日志。应用需要按 systemd 通知接口与权限、接收规则发送;不支持通知的程序不能只改 Type=notify 就期待成功。
Readiness,即就绪,是“现在是否应接新工作”的契约;Liveness,即活性,是“是否仍能取得所需进展”的判断。systemd 的 active 状态和业务健康不完全等同。容器探针具体对照 三类 Probe。
4. 执行环境:终端测试必须补哪些条件
交互终端中的程序继承当前 Shell 的工作目录和环境;systemd 则按单元配置及管理器规则建立执行环境。因此,“同一条命令”只说明程序和参数看起来相同,没有证明它们能看到同样的文件、拥有同样的权限。
| 条件 | 服务配置或证据 | 为什么重要 |
|---|---|---|
| 程序与参数 | ExecStart= | 不自动完整复现交互 Shell 的 alias、管道和重定向 |
| 工作目录 | WorkingDirectory= | 相对路径的解析起点 |
| 身份与组 | User=、Group=、实际状态 | 文件、端口及资源访问边界 |
| 环境 | Environment=、相关文件与进程环境 | 配置可能含秘密,不能公开全量导出 |
| 文件与临时目录 | mount 视图、PrivateTmp= 等 | 相同路径可能指向不同对象或只读范围 |
| 限额与资源 | Unit 配置、实际 limits 与 cgroup | 当前 Shell 的 ulimit 不证明服务相同 |
| 沙箱与能力 | NoNewPrivileges=、保护路径等 | 终端允许不代表服务允许 |
ExecStart= 不会自动交给交互 Shell 执行,管道 |、重定向 > 和命令别名不能照搬。第 7.2 节给出日志重定向的反例。确实需要脚本时,应指定解释器,并处理参数引用、错误退出和主进程归属;脚本可用 exec 将自身替换为服务程序,避免让包装脚本与实际服务的生命周期脱节。
环境变量不适合无边界传递敏感信息。凭据加载应遵守平台方案与权限,配置展示、日志和 /proc 取证前脱敏,不能把“排障方便”当公开 token 的理由。
5. 可运行实战:程序存活与初始化完成分开观察
保存为 startup_demo.py,直接运行 python3 startup_demo.py。父进程启动一个子进程,并为整个子进程运行设置 5 秒超时。子进程依次输出启动、初始化完成和正常退出事件。这里用有限睡眠模拟初始化阶段,没有实现 systemd notify 或真实健康接口。
python
import json
import os
import subprocess
import sys
import time
def child_main():
print(json.dumps({"event": "process_started", "pid": os.getpid()}), flush=True)
time.sleep(0.2) # 有限初始化占位,不作为服务启动性能结论。
print(json.dumps({"event": "initialization_finished"}), flush=True)
time.sleep(0.1)
print(json.dumps({"event": "normal_exit"}), flush=True)
def main():
if sys.argv[1:] == ["child"]:
child_main()
return
if sys.argv[1:]:
raise SystemExit("用法:python3 startup_demo.py")
result = subprocess.run(
[sys.executable, __file__, "child"],
capture_output=True, text=True, check=True, timeout=5,
)
events = [json.loads(line) for line in result.stdout.splitlines()]
assert [event["event"] for event in events] == [
"process_started", "initialization_finished", "normal_exit",
]
assert events[0]["pid"] != os.getpid()
assert result.returncode == 0
for event in events:
print(json.dumps(event))
print("startup phases and owned-child exit verified")
if __name__ == "__main__":
main()预期输出:前三行 JSON 的 event 依次为 process_started、initialization_finished、normal_exit,第一行还包含随运行变化的子进程 PID;随后输出 startup phases and owned-child exit verified。
subprocess.run 等待子进程结束后,父进程才解析并打印捕获的输出,因此终端不会实时展示三个阶段。断言检查事件顺序、父子 PID 差异和正常退出状态,不证明服务能接收流量。生产程序应在实际初始化条件满足时报告就绪,固定 sleep 只能等待一段时间,无法判断条件是否满足。
5.1 长期服务 Unit 模板:明确身份、类型与停止预算
下面是用于测试主机的长期服务配置模板。要求 app 用户和组、配置中的路径以及服务程序已存在;程序必须前台运行,并支持处理 SIGTERM(请求终止的信号)来关闭。上面的 demo 会自行退出,只适合观察阶段,不能代替这里的长期服务。
ini
[Unit]
Description=Example backend service
Wants=network-online.target
After=network-online.target
StartLimitIntervalSec=60
StartLimitBurst=3
[Service]
Type=exec
User=app
Group=app
WorkingDirectory=/opt/app
ExecStart=/opt/app/bin/server --config /etc/app/server.conf
Restart=on-failure
RestartSec=3
TimeoutStopSec=15
KillMode=control-group
UMask=0027
NoNewPrivileges=yes
PrivateTmp=yes
[Install]
WantedBy=multi-user.target这些配置值是示例选择,不是通用默认值。Type=exec 确认程序执行阶段;Restart=on-failure 请求在符合规则的失败后重启,RestartSec=3 设置重启等待时间;StartLimitIntervalSec=60 与 StartLimitBurst=3 限制启动频率,避免失败时持续冲击依赖。停止预算和进程范围由下一节解释。
UMask=0027 影响新建文件的权限,基础规则见前置权限篇。PrivateTmp=yes 改变临时目录视图;NoNewPrivileges=yes 限制通过 exec 等获得新特权,但它不是完整安全沙箱。网络在线目标仍不能保证远端业务健康。
systemd-analyze verify 可在目标测试环境检查配置语法和部分依赖,不能证明程序就绪、权限和停止行为已正确。生产验收还需实际启动、读回合并配置、就绪探测、关闭测试和资源检查。
6. 停止与重启:管理器不能替代应用取消协议
KillMode=control-group 以该 Unit 控制组范围管理适用剩余进程,不只处理一个包装脚本 PID。停止会按配置请求终止,超出适用停止预算后可强制终止;具体行为受 ExecStop、信号与其他设置影响。
停止准入是指不再接受新请求;排空是等待已接收的任务完成。应用应先停止准入,再在期限内完成或取消在途任务,最后关闭资源并报告结果。管理器只知道进程和停止规则,无法替应用判断业务任务是否完成。SIGKILL 是强制终止信号,不执行用户态清理,回查 退出协议。
| 操作 | 核心职责 | 不等于什么 |
|---|---|---|
start / stop | 安排当前启动/停止工作 | 修改开机激活关系 |
enable / disable | 按安装规则配置激活关系 | 自动启动/停止,除非明确使用相关选项 |
daemon-reload | 让管理器重新读取 Unit 等配置 | 自动重启服务或重读业务配置 |
reload | 请求服务实现的重载协议 | 所有程序都支持安全重载 |
restart | 按规则停止再启动 | 不损失连接或自动修复根因 |
reset-failed | 清理适用失败状态与相关计数 | 修复导致失败的配置、权限或应用缺陷 |
重启退避与限速减少持续冲击,不修复坏配置;重启还会丢现场、重新初始化和冲击依赖。对照 CrashLoopBackOff,相似表象由不同管理层产生,不能混用策略默认值。
7. 日志与时间:对齐墙钟,预算用单调时间
Wall Clock,即墙钟,回答“现在是哪一天、几点”,适合日志日期和跨系统时间线,但会受到时钟同步和人工调整影响。Monotonic Clock,即单调时钟,适合回答“经过了多久”:它不会因为墙钟被拨回而倒退,因此适合计算等待期限。
例如,先用单调时钟记录开始值,再用后续值减去开始值,就能计算同一计时环境中的经过时间。总超时预算也应沿用同一个截止点,每次连接或重试只使用剩余时间;如果每次重试都重新获得完整预算,总等待时间就可能超过调用方允许的期限。
日志应记录时区、启动实例、boot(本次系统启动)、发布版本与请求标识。不同机器墙钟误差可能影响因果判断;不要为了让日志“对上”随意改系统时间。
Python 的 time.monotonic() 是计算总预算的常用计时依据,但它不保证操作准时返回,也不允许跨不同系统或未对齐视图直接比较绝对值。Time namespace(时间命名空间)也不隔离任意墙钟,见 namespace。
bash
# systemd 主机的只读检查;unit 名称替换为已确认服务。
systemd --version
unit=app.service
systemctl status "$unit" --no-pager
systemctl show "$unit" -p MainPID -p ActiveState -p SubState -p Result -p ExecMainCode -p ExecMainStatus -p NRestarts -p ControlGroup
systemctl cat "$unit" # 可能显示敏感配置,分享前必须脱敏。
# 示例时间需替换为现场窗口;-b 限定当前 boot,-o 带明确时间格式。
journalctl -u "$unit" -b --since '2026-10-09 10:00:00' --until '2026-10-09 10:10:00' -o short-iso --no-pager
timedatectl status精简容器可能没有 systemd,命令失败不能说明内核服务管理异常。journal 的持久性、权限和保留规则依配置,未找到旧日志不证明服务从未失败。
7.1 enabled、active、MainPID 与业务健康分别回答什么
| 状态或字段 | 回答的问题 | 常见反例 |
|---|---|---|
| enabled / disabled | 是否按安装关系配置了相应激活入口 | enabled 的服务尚未启动;disabled 的服务仍可被手动或其他关系启动 |
| ActiveState / SubState | 管理器眼里的单元与类型相关状态 | oneshot 配合 RemainAfterExit 可 active,但没有持续服务进程 |
| MainPID | 管理器当前识别的主进程编号 | 编号为 0 不必定是异常;有编号也不证明初始化已完成 |
| Result / ExecMainCode / ExecMainStatus | 启停结果及主进程终止原因、状态值 | 只看一个数字就把信号终止误认成应用退出码 |
| NRestarts | 相应自动重启计数线索 | 累计重启数不等于当前窗口失败率,也不能说明最初根因 |
| 应用健康或就绪结果 | 按约定检查业务能否接流量 | 端口能连接,但关键依赖或初始化尚未完成 |
把这几层放在同一条时间线上,才能判断“启动失败”还是“进程已启动,业务未就绪”。例如管理器 active、主进程存在、应用日志仍在加载配置,清除失败状态不会让加载更快,反复重启还可能让初始化重新开始。
常见的 200/CHDIR、203/EXEC、216/GROUP、217/USER 是 systemd 调用准备或执行阶段的定位线索,分别指向工作目录、执行程序、组身份和用户身份等环节。它们不自动等于应用代码中某个异常;尤其 203/EXEC 应连同可执行文件、解释器、路径搜索权限与挂载检查,而不只验证文件名存在。依据:systemd.exec 的专用退出状态表。镜像手册不是 systemd 252 固定快照,现场以本机版本对照具体解释,不照抄新增选项。
7.2 一条 ExecStart 反例:Shell 操作符不是服务配置语法
ini
# 反例:systemd 不会把这里的 > 当交互 Shell 的输出重定向。
[Service]
ExecStart=/opt/app/bin/server > /var/log/app/server.logini
# 正例:程序前台运行,把输出目标交给管理器明确配置。
# 这是局部模板,不是完整可安装 Unit;身份和程序路径沿用上文。
[Service]
ExecStart=/opt/app/bin/server
StandardOutput=journal
StandardError=journal业务是否写文件、日志轮转和 journal 保留是后续协议,不能因为改成 journal 就认为日志永不丢失。确有 Shell 需求时,明确解释器和脚本文件;不要再叠加后台 & 让主进程退出,把子进程留给管理器猜。操作符规则见上游 systemd.service 的命令行说明,本例仍需授权 systemd 测试环境验证。
8. 排障与容易踩的坑
| 现象 | 下一步核对 | 不要直接做什么 |
|---|---|---|
| 手动启动成功、Unit 失败 | ExecStart、身份、工作目录、环境、路径与沙箱 | 递归 chmod 777 |
| active 但接口不可用 | 类型边界、初始化与真实就绪 | 把 active 当所有业务健康 |
| 改 Unit 后无变化 | 合并配置、daemon-reload、是否需受控重启 | 无限重复编辑启动脚本 |
| 重载不生效 | 程序是否实现 reload,配置位置与错误 | 假设 reload 等于 restart |
| 服务反复失败 | 上一轮 Result、日志、限额和状态原因 | reset-failed 后宣布已修复 |
| 停止超时 | 在途、子进程、资源持有与取消期限 | 认为管理器会自动补偿外部事务 |
不要把 After=database.service 当数据库永远可用,也不要把 Restart=always 当通用高可用方案。启动顺序、运行时依赖容错和故障恢复分别需要协议。
9. 名词解释与延伸阅读
| 名词 | 简短解释 |
|---|---|
| init / initramfs | 用户空间初始化角色 / 早期用户空间文件系统映像 |
| Unit / Target | systemd 管理对象配置 / 组合与同步单元关系 |
| Type / READY=1 | 管理器判断启动阶段的协议类型 / notify 协议中的就绪通知内容 |
| Wants / Requires / After | 弱需求 / 有条件更强需求 / 启动排序关系,不能互相替代 |
| daemon-reload / reload | 管理器重读配置 / 服务自身重载协议 |
| enabled / active / MainPID | 安装激活关系状态 / 类型相关运行状态 / 管理器识别的当前主进程编号 |
| Wall Clock / Monotonic | 日期时间线时钟 / 测量经过时间的时钟 |
- 自然后续:Linux 诊断命令,以服务身份和时间线为入口获取 CPU、内存、I/O 与网络证据。
- 跨专题应用:容器生命周期、三类探针,对照管理器、就绪与停止职责,避免套用 systemd 配置到所有容器。
- 依据:systemd 上游
systemd.service(5)、systemd.unit(5)、systemd.exec(5)、systemd.kill(5)、systemctl(1)与本机版本手册;Pythonsubprocess、time。新增选项和默认行为需按实际构建版本核验;模板中的配置值不代表线上测量结果。
10. 一句话总结与三个要点
可靠服务托管需要明确执行环境、启动就绪和有期限退出,管理器状态不是业务健康的完整证明。
- Unit 依赖、Type 和业务就绪各有职责,排序不保证远端依赖永远健康。
- 服务身份、路径、环境、沙箱与资源预算要与实际进程对齐,终端测试只是对照。
- 重读配置、重载、重启和恢复不同;日志对齐墙钟,等待预算使用适用单调时间。