当前位置:首页 > 文章列表 > 文章 > linux > systemd timer 怎样表达日历调度并查看下一次触发

systemd timer 怎样表达日历调度并查看下一次触发

来源:17golang原创 2026-11-17 00:18:41 0浏览 收藏

如果任务应该在每天固定时间、每周某天或每月某日运行,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
backup.timer、OnCalendar、Persistent 与 backup.service 的静态关系说明图
图1:systemd timer 与 service 的静态关系说明图,展示定时单元如何把日历配置交给同名服务。

如果服务文件不是同名文件,可以在 [Timer] 中增加 Unit=app-maintenance.service。更换目标服务不会改变 OnCalendar 的语义,但会改变触发后实际运行的 unit。

用 OnCalendar 表达日历调度

OnCalendar 使用 systemd 的日历事件语法,适合表达“几点几分”“每周哪几天”或“每月某日”。省略的日期部分会使用通配符,省略秒数时按 :00 处理,时区未显式写出时使用本地时区。

需求写法含义
每天 02:30*-*-* 02:30:00每天固定墙上时钟时间
工作日 02:30Mon..Fri *-*-* 02:30:00周一到周五匹配
每月 1 日 03:15*-*-01 03:15:00每月第一天匹配
每周一 04:00Mon *-*-* 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、日历解析器、list-timers 的 NEXT/LAST 字段与 Persistent 状态关系图
图2:日历表达式与状态查询的静态关系图,区分 NEXT、LAST 和 Persistent 记录。

对带 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 负责告诉你下一次和上一次发生了什么。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Python Decimal.compare_total 怎样区分数值相等的不同表示Python Decimal.compare_total 怎样区分数值相等的不同表示
上一篇
Python Decimal.compare_total 怎样区分数值相等的不同表示
Linux getent services 怎样查询服务名对应的端口和协议
下一篇
Linux getent services 怎样查询服务名对应的端口和协议
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1057次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1058次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1222次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1164次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1005次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码