如果任务应该在每天固定时间、每周某天或每月某日运行,systemd timer 应优先使用 OnCalendar= 表达墙上时钟,而不是把“启动后等待几小时”硬套进来。机器在关机期间错过了日历触发时,可以配合 Persistent=true,让 timer 重新激活后补一次执行;下一次和上一次触发则用 systemctl list-timers 直接查看。
官方文档:https://www.freedesktop.org/software/systemd/man/latest/systemd.timer.html
下面用一个维护任务说明完整写法。示例只表达配置关系,不把静态说明图当成实际运行截图。
先把 timer 和 service 的关系写清楚
一个可重复触发的任务通常由两个 unit 组成:backup.timer 负责什么时候触发,backup.service 负责触发后做什么。如果 timer 没有显式写 Unit=,systemd 默认激活去掉 .timer 后的同名服务。
因此,最小的 service 可以先保持单一职责,timer 再单独描述调度:
[Unit]
Description=整理应用备份
[Service]
Type=oneshot
# 只调用已部署的维护脚本,服务本身不常驻
ExecStart=/usr/local/sbin/app-backup
[Unit]
Description=每天执行应用备份
[Timer]
# 每天凌晨 02:30 触发同名的 backup.service
OnCalendar=*-*-* 02:30:00
# 关机错过时,下一次激活 timer 时补一次
Persistent=true
[Install]
WantedBy=timers.target
如果服务文件不是同名文件,可以在 [Timer] 中增加 Unit=app-maintenance.service。更换目标服务不会改变 OnCalendar 的语义,但会改变触发后实际运行的 unit。
用 OnCalendar 表达日历调度
OnCalendar 使用 systemd 的日历事件语法,适合表达“几点几分”“每周哪几天”或“每月某日”。省略的日期部分会使用通配符,省略秒数时按 :00 处理,时区未显式写出时使用本地时区。
| 需求 | 写法 | 含义 |
|---|---|---|
| 每天 02:30 | *-*-* 02:30:00 | 每天固定墙上时钟时间 |
| 工作日 02:30 | Mon..Fri *-*-* 02:30:00 | 周一到周五匹配 |
| 每月 1 日 03:15 | *-*-01 03:15:00 | 每月第一天匹配 |
| 每周一 04:00 | Mon *-*-* 04:00:00 | 每周一匹配 |
内置短语也可以使用,例如 daily 表示每天零点,weekly 表示每周一零点。日历定时器与按启动时刻计算的 OnBootSec= 不同:前者跟墙上时钟和时区有关,后者跟启动或 manager 激活时刻有关。
Persistent=true 解决什么问题
Persistent=true 只对配置了 OnCalendar= 的 timer 有效。systemd 会保存该服务上次被触发的时间;如果 timer 处于非活动状态期间本应至少触发过一次,重新激活时会补触发一次。这适合备份、报表或清理等“错过后补做一次仍有意义”的任务。
它不是补齐每一次错过的历史队列,也不代表服务一定会同时运行多份实例。连续关机跨过多个日历点时,恢复后只会产生一次补触发;如果服务在 timer 到点时已经处于活动状态,systemd 不会为了同一个 timer 再启动一个新的服务实例。
因此,服务脚本仍应具备幂等性,并明确是否允许重入。对于短周期 timer,不要轻易在服务里设置 RemainAfterExit=yes:服务会保持 active,后续重复触发可能只看到已有实例而不再重新启动。
重新加载并查看下一次触发
unit 文件写入正确目录后,先让 systemd 重新读取文件,再启用 timer。命令中的注释说明每个动作,实际执行时按自己的 unit 名称替换:
# 重新读取 unit 文件,避免继续使用旧配置
sudo systemctl daemon-reload
# 设置开机自动启动,并立即启动 timer
sudo systemctl enable --now backup.timer
# 按下一次触发时间列出 timer,--all 也显示暂时没有下一次触发的项目
systemctl list-timers --all backup.timer
# 查看 timer 的当前状态和最近一次相关日志摘要
systemctl status backup.timer
list-timers 输出中的 NEXT 是下一次触发时间,LAST 是上一次触发时间,UNIT 是 timer 名称,ACTIVATES 是它会激活的服务。若只想解析日历表达式并计算下一次时间,可使用:
# 让 systemd 解析表达式,并给出规范形式与下一次时间
systemd-analyze calendar 'Mon..Fri *-*-* 02:30:00'
对带 OnCalendar 的 timer,systemd 还会把它排在时间设置与同步目标之后;如果机器的实时时钟尚未正确校准,日历事件就可能落在意外时间。生产环境应把时区、时间同步和服务日志一起纳入排查,而不是只盯着 timer 文件。
上线前检查这几个边界
- 确认目标服务:没有
Unit=时默认找同名.service,改名后要同步检查绑定关系。 - 确认补偿语义:
Persistent=true只补一次错过的日历触发,不是离线期间的任务队列。 - 确认时间精度:timer 默认受
AccuracySec=影响,默认值是 1 分钟;不要把它当成硬实时调度。 - 确认并发行为:服务仍在运行时,到点不会自动产生新的实例,脚本应自行处理幂等与锁。
- 确认权限:尽量让服务以专用、最小权限身份执行,脚本和输出目录的属主与权限要能被审计。
- 确认查询结果:先看
systemctl list-timers --all的NEXT、LAST,再看systemctl status backup.service和 journal。
相关问题
OnCalendar 和 OnBootSec 有什么区别?
OnCalendar 按墙上时钟匹配日期时间,OnBootSec 按机器启动后的时间跨度计算。前者适合“每天 2 点”,后者适合“启动 10 分钟后”。
Persistent=true 会补齐关机期间每一次任务吗?
不会。它只判断非活动期间是否错过过触发,重新激活时最多补一次。
怎样只看一个 timer 的下一次时间?
使用 systemctl list-timers --all backup.timer,重点看 NEXT 列;表达式本身则可交给 systemd-analyze calendar 解析。
把日历表达式、漏执行补偿和状态查询拆开后,systemd timer 的配置就比较容易审计:timer 负责时间,service 负责任务,list-timers 负责告诉你下一次和上一次发生了什么。