Linux 与服务器运维 / 知识点
systemd Unit 配置速查手册
[Unit] 条件与断言
ConditionEnvironment=<NAME>[=<VALUE>]按 manager 环境变量决定是否执行 Unit。
ConditionEnvironment=
按 manager 环境变量决定是否执行 Unit。
所属 Section
[Unit]
语法
ConditionEnvironment=<NAME>[=<VALUE>]推荐示例
ConditionEnvironment=APP_ENABLED=1关键边界
system manager 的环境并不是普通登录 Shell 环境。
ConditionVirtualization=<VALUE>按虚拟化/容器环境决定是否运行。
ConditionVirtualization=
按虚拟化/容器环境决定是否运行。
所属 Section
[Unit]
语法
ConditionVirtualization=<VALUE>推荐示例
ConditionVirtualization=!container关键边界
可用否定前缀 !;适合 host-only service。
ConditionArchitecture=<ARCH>限制 Unit 只在指定架构运行。
ConditionArchitecture=
限制 Unit 只在指定架构运行。
所属 Section
[Unit]
语法
ConditionArchitecture=<ARCH>推荐示例
ConditionArchitecture=x86-64关键边界
架构名称按 systemd 规范,不一定和 uname -m 字符串完全一致。
AssertPathExists=<PATH>类似 ConditionPathExists,但不满足时 Unit 直接失败。
AssertPathExists=
类似 ConditionPathExists,但不满足时 Unit 直接失败。
所属 Section
[Unit]
语法
AssertPathExists=<PATH>推荐示例
AssertPathExists=/srv/app/bin/app关键边界
Condition 更像“是否适用”;Assert 更像“必须满足”。
[Service] 类型与主进程
Type=execsystemd 在成功 execve() 主进程后才认为服务启动步骤成功。
Type=exec
systemd 在成功 execve() 主进程后才认为服务启动步骤成功。
所属 Section
[Service]
语法
Type=exec推荐示例
Type=exec关键边界
现代长运行服务推荐优先考虑 exec,可更早发现可执行文件/用户等 setup 错误。
Type=simple主进程 fork 后 systemd 很快认为服务已启动。
Type=simple
主进程 fork 后 systemd 很快认为服务已启动。
所属 Section
[Service]
语法
Type=simple推荐示例
Type=simple关键边界
简单但可能在真正 exec 失败前就让后续 Unit 继续;现代新服务常更推荐 exec。
Type=notify服务通过 sd_notify() 发送 READY=1 告诉 systemd 已真正 ready。
Type=notify
服务通过 sd_notify() 发送 READY=1 告诉 systemd 已真正 ready。
所属 Section
[Service]
语法
Type=notify推荐示例
Type=notify关键边界
应用必须实现 systemd notify 协议;适合需要明确 readiness 的 daemon。
Type=forking适配传统 daemon 自己 fork 到后台的模式。
Type=forking
适配传统 daemon 自己 fork 到后台的模式。
所属 Section
[Service]
语法
Type=forking推荐示例
Type=forking关键边界
现代新程序通常不应 daemonize;让进程前台运行并由 systemd 管理更简单。
Type=oneshot用于执行一次任务并等待主命令退出。
Type=oneshot
用于执行一次任务并等待主命令退出。
所属 Section
[Service]
语法
Type=oneshot推荐示例
Type=oneshot关键边界
只有 oneshot 可以配置多条 ExecStart;不适合长期常驻服务。
RemainAfterExit=yes|no命令退出后仍把 Unit 保持为 active。
RemainAfterExit=
命令退出后仍把 Unit 保持为 active。
所属 Section
[Service]
语法
RemainAfterExit=yes|no推荐示例
RemainAfterExit=yes关键边界
常与 Type=oneshot 配合,表示“一次配置动作已经完成并仍视作生效”。
PIDFile=<PATH>帮助 systemd 在传统 forking daemon 中识别主进程。
PIDFile=
帮助 systemd 在传统 forking daemon 中识别主进程。
所属 Section
[Service]
语法
PIDFile=<PATH>推荐示例
PIDFile=/run/legacy-app.pid关键边界
主要用于 Type=forking 老程序;现代前台服务一般不需要。
NotifyAccess=none|main|exec|all限制哪些服务进程可以发送 systemd notify 消息。
NotifyAccess=
限制哪些服务进程可以发送 systemd notify 消息。
所属 Section
[Service]
语法
NotifyAccess=none|main|exec|all推荐示例
NotifyAccess=main关键边界
Type=notify 场景常见;不要无必要放宽到 all。
[Service] 启停命令与环境
ExecStart=<ABSOLUTE_COMMAND> [ARGS...]定义服务启动命令。
ExecStart=
定义服务启动命令。
所属 Section
[Service]
语法
ExecStart=<ABSOLUTE_COMMAND> [ARGS...]推荐示例
ExecStart=/usr/local/bin/app --config /etc/app.yml关键边界
默认不是 Shell 命令行,不支持直接写 |、&&、> 等 Shell 语法。
ExecStartPre=<COMMAND>在 ExecStart 前依次执行准备命令。
ExecStartPre=
在 ExecStart 前依次执行准备命令。
所属 Section
[Service]
语法
ExecStartPre=<COMMAND>推荐示例
ExecStartPre=/usr/bin/test -f /etc/app.yml关键边界
不应在这里启动长期后台进程;失败通常会阻止服务启动。
ExecStartPost=<COMMAND>服务按 Type 语义启动成功后执行后置命令。
ExecStartPost=
服务按 Type 语义启动成功后执行后置命令。
所属 Section
[Service]
语法
ExecStartPost=<COMMAND>推荐示例
ExecStartPost=/usr/bin/logger app-started关键边界
它也计入 After/Before ordering 的启动完成时点。
ExecCondition=<COMMAND>在正式启动前做条件命令判断。
ExecCondition=
在正式启动前做条件命令判断。
所属 Section
[Service]
语法
ExecCondition=<COMMAND>推荐示例
ExecCondition=/usr/local/bin/check-license关键边界
退出 1–254 通常跳过启动而不标记 failed;255/异常退出会失败。
ExecReload=<COMMAND>定义 systemctl reload 时运行的动作。
ExecReload=
定义 systemctl reload 时运行的动作。
所属 Section
[Service]
语法
ExecReload=<COMMAND>推荐示例
ExecReload=/bin/kill -HUP $MAINPID关键边界
最好使用能同步确认 reload 完成的机制,而不是盲目发信号。
ExecStop=<COMMAND>定义服务正常停止时执行的命令。
ExecStop=
定义服务正常停止时执行的命令。
所属 Section
[Service]
语法
ExecStop=<COMMAND>推荐示例
ExecStop=/usr/local/bin/appctl stop关键边界
仅在服务成功启动后执行;最终清理更适合 ExecStopPost。
ExecStopPost=<COMMAND>服务停止后执行清理,包括启动失败后的清理。
ExecStopPost=
服务停止后执行清理,包括启动失败后的清理。
所属 Section
[Service]
语法
ExecStopPost=<COMMAND>推荐示例
ExecStopPost=/usr/bin/rm -f /run/app.lock关键边界
清理逻辑应能处理“只启动到一半”的状态。
Environment=<KEY>=<VALUE> [...]直接给服务进程设置环境变量。
Environment=
直接给服务进程设置环境变量。
所属 Section
[Service]
语法
Environment=<KEY>=<VALUE> [...]推荐示例
Environment=APP_ENV=prod LOG_LEVEL=info关键边界
不适合放密码、Token 等秘密;Unit 文件和 D-Bus 属性可能可读。