Linux 与服务器运维 / 知识点
systemd Unit 配置速查手册
[Service] 启停命令与环境
EnvironmentFile=[-]<PATH>从文件加载环境变量。
EnvironmentFile=
从文件加载环境变量。
所属 Section
[Service]
语法
EnvironmentFile=[-]<PATH>推荐示例
EnvironmentFile=-/etc/default/app关键边界
前缀 - 表示文件不存在时不报错;同样不应把它当 secret manager。
UnsetEnvironment=<NAME> [...]在最终执行环境中删除指定变量。
UnsetEnvironment=
在最终执行环境中删除指定变量。
所属 Section
[Service]
语法
UnsetEnvironment=<NAME> [...]推荐示例
UnsetEnvironment=HTTP_PROXY HTTPS_PROXY关键边界
适合防止 manager 环境意外传递到服务。
ExecStart=/bin/sh -c '<COMMAND>'确实需要管道、重定向等 Shell 语法时显式调用 Shell。
Shell 语法包装
确实需要管道、重定向等 Shell 语法时显式调用 Shell。
所属 Section
[Service]
语法
ExecStart=/bin/sh -c '<COMMAND>'推荐示例
ExecStart=/bin/sh -c 'exec /usr/bin/app 2>>/var/log/app.err'关键边界
能不用 Shell 就不用;Shell 引入引用、注入和信号传递复杂度。
[Service] 重启、超时与退出状态
Restart=no|on-failure|on-abnormal|on-watchdog|always|...控制主服务异常退出后的自动重启策略。
Restart=
控制主服务异常退出后的自动重启策略。
所属 Section
[Service]
语法
Restart=no|on-failure|on-abnormal|on-watchdog|always|...推荐示例
Restart=on-failure关键边界
长运行服务通常推荐 on-failure;systemctl stop 等显式停止不会触发自动重启。
RestartSec=<TIME>设置自动重启前等待时间。
RestartSec=
设置自动重启前等待时间。
所属 Section
[Service]
语法
RestartSec=<TIME>推荐示例
RestartSec=5s关键边界
避免故障服务瞬间无限重启;还会受到 StartLimit 约束。
StartLimitIntervalSec=<TIME>定义启动频率限制的统计时间窗口。
StartLimitIntervalSec=
定义启动频率限制的统计时间窗口。
所属 Section
[Service]
语法
StartLimitIntervalSec=<TIME>推荐示例
StartLimitIntervalSec=60s关键边界
属于 [Unit] 通用设置,但通常和 Restart 配套理解。
StartLimitBurst=<N>允许统计窗口内最多启动次数。
StartLimitBurst=
允许统计窗口内最多启动次数。
所属 Section
[Service]
语法
StartLimitBurst=<N>推荐示例
StartLimitBurst=5关键边界
超过限制后 Unit 会进入 start-limit-hit 等失败状态。
TimeoutStartSec=<TIME>限制服务启动最长时间。
TimeoutStartSec=
限制服务启动最长时间。
所属 Section
[Service]
语法
TimeoutStartSec=<TIME>推荐示例
TimeoutStartSec=90s关键边界
Type=notify 服务必须在时间内报告 ready,除非有相应扩展机制。
TimeoutStopSec=<TIME>限制优雅停止阶段等待时间。
TimeoutStopSec=
限制优雅停止阶段等待时间。
所属 Section
[Service]
语法
TimeoutStopSec=<TIME>推荐示例
TimeoutStopSec=30s关键边界
超时后 systemd 会按 KillMode/KillSignal 等策略进一步结束进程。
TimeoutSec=<TIME>同时设置启动和停止超时的简写。
TimeoutSec=
同时设置启动和停止超时的简写。
所属 Section
[Service]
语法
TimeoutSec=<TIME>推荐示例
TimeoutSec=60s关键边界
需要分别控制时使用 TimeoutStartSec/TimeoutStopSec。
SuccessExitStatus=<STATUS|SIGNAL> [...]把额外退出码/信号视为正常退出。
SuccessExitStatus=
把额外退出码/信号视为正常退出。
所属 Section
[Service]
语法
SuccessExitStatus=<STATUS|SIGNAL> [...]推荐示例
SuccessExitStatus=TEMPFAIL 250关键边界
会影响 Unit success/failure 和 Restart 判断。
RestartPreventExitStatus=<STATUS> [...]即使 Restart 策略要求重启,也对指定退出码禁止自动重启。
RestartPreventExitStatus=
即使 Restart 策略要求重启,也对指定退出码禁止自动重启。
所属 Section
[Service]
语法
RestartPreventExitStatus=<STATUS> [...]推荐示例
RestartPreventExitStatus=2 78关键边界
适合“配置错误就不要无限重启”的程序。
RestartForceExitStatus=<STATUS> [...]对指定退出码强制自动重启。
RestartForceExitStatus=
对指定退出码强制自动重启。
所属 Section
[Service]
语法
RestartForceExitStatus=<STATUS> [...]推荐示例
RestartForceExitStatus=75关键边界
只针对主服务进程;使用前确认业务退出码语义。
WatchdogSec=<TIME>要求支持 notify watchdog 的服务周期发送 keep-alive。
WatchdogSec=
要求支持 notify watchdog 的服务周期发送 keep-alive。
所属 Section
[Service]
语法
WatchdogSec=<TIME>推荐示例
WatchdogSec=30s关键边界
应用必须实现 watchdog 通知;不是 systemd 自动探测 HTTP 健康接口。
[Service] 用户、目录与权限
User=<USER>指定服务进程运行用户。
User=
指定服务进程运行用户。
所属 Section
[Service]
语法
User=<USER>推荐示例
User=app关键边界
网络服务默认不应以 root 运行,除非确有必要。
Group=<GROUP>指定主进程运行组。
Group=
指定主进程运行组。
所属 Section
[Service]
语法
Group=<GROUP>推荐示例
Group=app关键边界
没配置时通常使用 User 对应默认组。
SupplementaryGroups=<GROUP> [...]给服务附加补充组权限。
SupplementaryGroups=
给服务附加补充组权限。
所属 Section
[Service]
语法
SupplementaryGroups=<GROUP> [...]推荐示例
SupplementaryGroups=ssl-cert关键边界
比直接给 root 更细粒度。
DynamicUser=yes|no为服务动态分配临时系统用户/组。
DynamicUser=
为服务动态分配临时系统用户/组。
所属 Section
[Service]
语法
DynamicUser=yes|no推荐示例
DynamicUser=yes关键边界
适合无需固定 UID 的无状态服务;与持久目录应配合 StateDirectory 等能力。
WorkingDirectory=<PATH>设置执行命令的当前工作目录。
WorkingDirectory=
设置执行命令的当前工作目录。
所属 Section
[Service]
语法
WorkingDirectory=<PATH>推荐示例
WorkingDirectory=/srv/app关键边界
不要依赖 systemd 默认 cwd;相对路径程序应显式设置。
RootDirectory=<PATH>把服务根目录切换到指定目录。
RootDirectory=
把服务根目录切换到指定目录。
所属 Section
[Service]
语法
RootDirectory=<PATH>推荐示例
RootDirectory=/srv/chroot/app关键边界
类似 chroot 的文件系统隔离,高级场景使用。