Linux 与服务器运维 / 知识点
systemd Unit 配置速查手册
[Install] 启用关系与模板实例
<NAME>@.service定义可实例化的服务模板。
模板 Unit @.service
定义可实例化的服务模板。
所属 Section
[Install]
语法
<NAME>@.service推荐示例
worker@.service关键边界
实例通过 worker@1.service、worker@blue.service 等启动。
%i在模板 Unit 中展开实例名。
实例标识 %i
在模板 Unit 中展开实例名。
所属 Section
[Install]
语法
%i推荐示例
ExecStart=/usr/local/bin/worker --queue %i关键边界
例如 worker@high.service 中 %i 为 high。
%I展开未转义的实例标识。
转义实例 %I
展开未转义的实例标识。
所属 Section
[Install]
语法
%I推荐示例
Description=Worker for %I关键边界
%i 是转义后的 Unit 实例名,%I 更接近原始字符串。
DefaultInstance=<INSTANCE>模板 Unit 被直接 enable 时指定默认实例。
DefaultInstance=
模板 Unit 被直接 enable 时指定默认实例。
所属 Section
[Install]
语法
DefaultInstance=<INSTANCE>推荐示例
DefaultInstance=default关键边界
模板安装场景使用,普通非模板 service 不需要。
[Timer] 定时任务
OnCalendar=<CALENDAR_EXPR>按真实时间日历表达式触发 Timer。
OnCalendar=
按真实时间日历表达式触发 Timer。
所属 Section
[Timer]
语法
OnCalendar=<CALENDAR_EXPR>推荐示例
OnCalendar=*-*-* 02:00:00关键边界
适合每天/每周/指定日期任务;实际触发还受 AccuracySec 等影响。
OnBootSec=<TIME>系统启动后经过指定时间触发。
OnBootSec=
系统启动后经过指定时间触发。
所属 Section
[Timer]
语法
OnBootSec=<TIME>推荐示例
OnBootSec=5min关键边界
属于单调计时,不依赖墙上时钟。
OnUnitActiveSec=<TIME>相对被触发 Unit 上次 activation 计算下一次。
OnUnitActiveSec=
相对被触发 Unit 上次 activation 计算下一次。
所属 Section
[Timer]
语法
OnUnitActiveSec=<TIME>推荐示例
OnUnitActiveSec=10min关键边界
适合周期任务。
Persistent=yes|no系统关机期间错过日历触发时,启动后补执行一次。
Persistent=
系统关机期间错过日历触发时,启动后补执行一次。
所属 Section
[Timer]
语法
Persistent=yes|no推荐示例
Persistent=true关键边界
只影响 OnCalendar 类型 timer 的持久追赶语义。
AccuracySec=<TIME>允许 Timer 在目标时间后的一个精度窗口内合并触发。
AccuracySec=
允许 Timer 在目标时间后的一个精度窗口内合并触发。
所属 Section
[Timer]
语法
AccuracySec=<TIME>推荐示例
AccuracySec=1s关键边界
默认通常不是“精确到秒”;它主要用于合并 CPU 唤醒。
RandomizedDelaySec=<TIME>在每次计划时间后增加随机延迟,分散批量任务峰值。
RandomizedDelaySec=
在每次计划时间后增加随机延迟,分散批量任务峰值。
所属 Section
[Timer]
语法
RandomizedDelaySec=<TIME>推荐示例
RandomizedDelaySec=15min关键边界
与 AccuracySec 目的不同:它主动拉散触发时间。
Unit=<UNIT>明确指定 Timer 要激活的 Unit。
Unit=
明确指定 Timer 要激活的 Unit。
所属 Section
[Timer]
语法
Unit=<UNIT>推荐示例
Unit=backup.service关键边界
不设置时通常按同名 .service 推导。
WakeSystem=yes|no允许 Timer 在硬件支持时唤醒挂起系统。
WakeSystem=
允许 Timer 在硬件支持时唤醒挂起系统。
所属 Section
[Timer]
语法
WakeSystem=yes|no推荐示例
WakeSystem=true关键边界
服务器/VM 支持情况差异大。
[Socket] Socket 激活
ListenStream=<ADDRESS>创建 SOCK_STREAM 监听;IP 场景通常对应 TCP。
ListenStream=
创建 SOCK_STREAM 监听;IP 场景通常对应 TCP。
所属 Section
[Socket]
语法
ListenStream=<ADDRESS>推荐示例
ListenStream=127.0.0.1:9000关键边界
连接到监听 socket 时可触发对应 service。
ListenDatagram=<ADDRESS>创建 SOCK_DGRAM 监听;IP 场景通常对应 UDP。
ListenDatagram=
创建 SOCK_DGRAM 监听;IP 场景通常对应 UDP。
所属 Section
[Socket]
语法
ListenDatagram=<ADDRESS>推荐示例
ListenDatagram=0.0.0.0:9999关键边界
UDP 与 TCP activation 行为不同。
Accept=yes|no决定每个入站连接是否生成独立 service instance。
Accept=
决定每个入站连接是否生成独立 service instance。
所属 Section
[Socket]
语法
Accept=yes|no推荐示例
Accept=no关键边界
默认 no;高性能常用单个 service 处理全部连接。
SocketMode=<MODE>设置 Unix socket 文件权限。
SocketMode=
设置 Unix socket 文件权限。
所属 Section
[Socket]
语法
SocketMode=<MODE>推荐示例
SocketMode=0660关键边界
只对文件系统 Unix socket 有意义。
SocketUser=<USER>设置 Unix socket 文件 owner。
SocketUser=
设置 Unix socket 文件 owner。
所属 Section
[Socket]
语法
SocketUser=<USER>推荐示例
SocketUser=app关键边界
配合 SocketGroup/SocketMode 控制本地访问权限。
SocketGroup=<GROUP>设置 Unix socket 文件 group。
SocketGroup=
设置 Unix socket 文件 group。
所属 Section
[Socket]
语法
SocketGroup=<GROUP>推荐示例
SocketGroup=www-data关键边界
比把服务运行成同一用户更灵活。
Service=<UNIT>显式指定 socket 激活的 service。
Service=
显式指定 socket 激活的 service。
所属 Section
[Socket]
语法
Service=<UNIT>推荐示例
Service=app.service关键边界
默认通常按同名规则推导。
Path / Mount / Automount / Target
PathExists=<PATH>Path Unit 监控路径存在事件。
PathExists=
Path Unit 监控路径存在事件。
所属 Section
Path
语法
PathExists=<PATH>推荐示例
PathExists=/srv/app/trigger关键边界
满足条件时激活对应 service;适合轻量文件触发。