Linux systemd定时器如何配置周期任务并确认下一次执行时间?

发布人:A5数据发布时间:2026-10-24 11:38阅读量:102

systemd 定时器通过 .timer 单元决定何时触发任务,再由对应的 .service 单元执行具体命令。完成配置后,使用 systemctl list-timers 可以直接查看定时器的下一次执行时间、上次执行时间和当前等待状态;systemd-analyze calendar 则用于验证时间表达式是否符合预期。

下面以使用 systemd 的 Ubuntu、Debian、Rocky Linux、AlmaLinux 等常见 Linux 服务器为例,部署一个系统级定时任务。示例任务每 10 分钟执行一次,仅向 systemd 日志输出执行时间,适合首次部署和验证。实际替换任务命令时,应先确认任务具备幂等性,避免手动验证或定时重试造成重复扣款、重复发信或重复写入。

对于需要长期运行定时脚本的网站、业务后台、数据库与备份任务,A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡、马来西亚等地区的物理服务器资源,覆盖Xeon、AMD EPYC、存储型及多IP等产品系列,并配备SSD、NVMe或大容量机械硬盘方案。结合不同地区的网络线路、CPU、内存和存储配置,可为systemd定时器承载的周期任务提供相应的服务器基础。

一、准备条件

1. 确认系统由 systemd 管理

systemd 定时器依赖 systemd 作为系统初始化进程运行。在服务器上执行:

command -v systemctl
systemctl --version | head -n 1
ps -p 1 -o pid=,comm=
timedatectl show -p Timezone -p NTPSynchronized

典型输出类似下面的示例:

/usr/bin/systemctl
systemd 252 (252.22-1~deb12u1)
      1 systemd
Timezone=Asia/Shanghai
NTPSynchronized=yes

其中,PID 1 的进程应为 systemd。如果 PID 1 是 init、tini、bash 或其他进程,当前环境可能是容器、精简系统或 chroot,不能直接假定 systemd 定时器可用。

如果服务器已经存在 systemctl,通常不需要重复安装 systemd。只有在确认发行版缺少 systemd 软件包时,才根据发行版补装:

# Debian 或 Ubuntu
sudo apt-get update
sudo apt-get install -y systemd
# Rocky Linux、AlmaLinux、RHEL 等
sudo dnf install -y systemd

在容器中安装 systemd 软件包并不等于让 systemd 成为 PID 1。容器需要由运行时以 systemd 作为初始化进程启动,否则应使用宿主机的定时器或容器平台自身的调度机制。

2. 确认权限和任务边界

创建系统级单元文件需要 root 权限,通常使用 sudo。本例将文件放在以下位置:

  • 服务脚本:/usr/local/libexec/demo-systemd-task.sh
  • 服务单元:/etc/systemd/system/demo-systemd-task.service
  • 定时器单元:/etc/systemd/system/demo-systemd-task.timer

执行写入命令前,先确认这些名称没有被现有服务占用:

sudo systemctl list-unit-files | grep -E '^demo-systemd-task\.(service|timer)'

没有输出表示名称暂未出现在已安装的单元列表中。如果已经存在同名单元,不要直接覆盖,应先查看内容:

sudo systemctl cat demo-systemd-task.service
sudo systemctl cat demo-systemd-task.timer

若要部署真实任务,还需要提前明确以下内容:

  • 任务是否需要 root 权限;
  • 任务执行文件的绝对路径;
  • 任务失败时的退出码;
  • 任务是否可能执行超过一个周期;
  • 手动执行是否会产生真实业务副作用。

本例服务默认以 root 身份运行,仅用于演示。生产环境中,如果任务不需要特权,应在服务单元中使用专用用户运行。

3. 先验证计划时间

本例采用每 10 分钟的整点边界执行一次,使用 OnCalendar 表达式:

*-*-* *:00/10:00

用 systemd-analyze calendar 验证:

systemd-analyze calendar '*-*-* *:00/10:00'

示例输出:

Normalized form: *-*-* *:00/10:00
    Next elapse: Sat 2025-01-18 14:20:00 CST
       From now: 6min left

输出中的日期和剩余时间会随服务器当前时间变化,这里只用于说明格式。若表达式错误,命令会提示无法解析,此时不要继续创建定时器,应先修正时间表达式。

二、逐步创建服务和定时器

1. 创建实际执行脚本

先创建脚本目录:

sudo install -d -m 0755 /usr/local/libexec

然后写入演示脚本:

sudo tee /usr/local/libexec/demo-systemd-task.sh > /dev/null <<'EOF'
#!/bin/sh
set -eu

printf 'demo systemd task executed at %s\n' "$(/usr/bin/date --iso-8601=seconds)"
EOF

设置脚本为可执行文件:

sudo chmod 0755 /usr/local/libexec/demo-systemd-task.sh

这里的 chmod 0755 会改变该文件的权限,使 root 可读写执行,其他用户可读和执行,但不能修改文件。执行前应确认路径确实是新建的演示脚本,避免误改已有业务文件。

验证脚本语法和权限:

sudo sh -n /usr/local/libexec/demo-systemd-task.sh
ls -l /usr/local/libexec/demo-systemd-task.sh

预期结果类似:

-rwxr-xr-x 1 root root 143 Jan 18 14:10 /usr/local/libexec/demo-systemd-task.sh

此时可以先手动执行一次,确认脚本本身没有问题:

sudo /usr/local/libexec/demo-systemd-task.sh

示例输出:

demo systemd task executed at 2025-01-18T14:10:32+08:00

如果实际任务会修改数据库、清理文件或发送通知,不要直接用生产参数运行这一步,应改用测试参数或提供 dry-run 模式。

2. 创建 service 单元

创建服务单元:

sudo tee /etc/systemd/system/demo-systemd-task.service > /dev/null <<'EOF'
[Unit]
Description=Demo periodic task executed by systemd timer

[Service]
Type=oneshot
ExecStart=/usr/local/libexec/demo-systemd-task.sh
StandardOutput=journal
StandardError=journal
EOF

这个服务使用 Type=oneshot,表示启动后执行一次命令,命令退出后本次服务实例结束。它不需要设置 Restart=always,否则任务失败时可能与定时器叠加,造成重复执行。

ExecStart 使用绝对路径,并且不会自动经过 shell 解析。如果真实命令包含管道、重定向、环境变量展开等逻辑,建议把这些逻辑写进独立脚本,而不是在 ExecStart 中拼接复杂的 shell 命令。

本例没有设置 User=,因此服务默认以 root 身份运行。若任务只需要普通文件权限,可以增加专用用户,例如:

[Service]
Type=oneshot
User=taskrunner
Group=taskrunner
ExecStart=/usr/local/libexec/demo-systemd-task.sh

使用专用用户前,必须确认该用户对脚本、工作目录、输出目录和所需资源都有适当权限。

3. 创建 timer 单元

创建与服务对应的定时器:

sudo tee /etc/systemd/system/demo-systemd-task.timer > /dev/null <<'EOF'
[Unit]
Description=Run demo systemd task every ten minutes

[Timer]
OnCalendar=*-*-* *:00/10:00
Persistent=true
AccuracySec=1min
Unit=demo-systemd-task.service

[Install]
WantedBy=timers.target
EOF

各配置项的作用如下:

  • OnCalendar:按照日历时间触发,本例为每小时的第 0、10、20、30、40、50 分钟执行;
  • Persistent=true:服务器关机或定时器停止期间错过计划时间,重新启动定时器后尝试补执行一次;
  • AccuracySec=1min:允许 systemd 在约 1 分钟的精度范围内安排唤醒,降低频繁精确唤醒带来的开销;
  • Unit:明确指定触发的服务单元;
  • WantedBy=timers.target:允许使用 systemctl enable 将定时器加入系统启动目标。

Persistent=true 不代表每次开机都无条件执行一次,也不代表会补齐停机期间的所有历史周期。它主要用于处理日历定时器错过最近一次计划时间的情况。

4. 检查单元文件并重新加载

先检查两个单元文件:

sudo systemd-analyze verify \
  /etc/systemd/system/demo-systemd-task.service \
  /etc/systemd/system/demo-systemd-task.timer

配置正确时通常没有输出,并返回退出码 0。若出现 Failed to parse、Unknown lvalue 或 Executable path is not absolute 等提示,应根据报错修改文件。

检查通过后,让 systemd 重新读取单元文件:

sudo systemctl daemon-reload

daemon-reload 只重新读取配置,不会自动启动新定时器,也不会立即执行服务。

5. 启用并启动定时器

使用以下命令设置开机自动启动,并立即启动当前实例:

sudo systemctl enable --now demo-systemd-task.timer

验证定时器状态:

sudo systemctl is-enabled demo-systemd-task.timer
sudo systemctl is-active demo-systemd-task.timer
sudo systemctl status demo-systemd-task.timer --no-pager

预期结果包括:

enabled
active

状态中通常能看到:

Active: active (waiting)
Trigger: Sat 2025-01-18 14:20:00 CST; 8min left

enable --now 启动的是 .timer,不是 .service。启动定时器后,任务会等待下一次计划时间;如果需要立即验证服务逻辑,可以单独手动启动服务。

三、确认下一次执行时间和实际执行结果

1. 查看下一次触发时间

最直接的命令是:

sudo systemctl list-timers demo-systemd-task.timer --all --no-pager

典型输出格式如下:

NEXT                         LEFT   LAST                         PASSED  UNIT                     ACTIVATES
Sat 2025-01-18 14:20:00 CST  8min   n/a                          n/a     demo-systemd-task.timer  demo-systemd-task.service

重点查看以下字段:

  • NEXT:下一次计划触发时间;
  • LEFT:距离下一次触发的剩余时间;
  • LAST:上一次由定时器触发的时间;
  • UNIT:定时器名称;
  • ACTIVATES:该定时器触发的服务。

如果 NEXT 显示为 n/a,通常表示定时器没有成功加载、未处于等待状态,或 OnCalendar 表达式未生成下一次时间,需要回到异常处理部分检查。

还可以查看定时器的详细属性:

sudo systemctl show demo-systemd-task.timer \
  -p ActiveState \
  -p SubState \
  -p NextElapseUSecRealtime \
  -p LastTriggerUSecRealtime

示例:

ActiveState=active
SubState=waiting
NextElapseUSecRealtime=Sat 2025-01-18 14:20:00 CST
LastTriggerUSecRealtime=n/a

systemd-analyze calendar 只能验证表达式并计算计划时间,不能代替 systemctl list-timers。确认某个已经运行的定时器时,应以 list-timers 的实际状态为准。

2. 手动执行服务进行首次验证

为了不等待下一个 10 分钟边界,可以手动启动一次服务:

sudo systemctl start demo-systemd-task.service

查看服务状态:

sudo systemctl status demo-systemd-task.service --no-pager

由于服务是 Type=oneshot,命令执行完成后,状态可能显示为 inactive (dead),这不一定表示失败。继续查看结果字段:

sudo systemctl show demo-systemd-task.service \
  -p Result \
  -p ExecMainStatus \
  -p ExecMainCode

成功时应类似于:

Result=success
ExecMainStatus=0
ExecMainCode=exited

查看服务输出:

sudo journalctl -u demo-systemd-task.service -n 20 --no-pager -o short-iso

预期能看到:

2025-01-18T14:12:05+0800 server systemd[1]: Starting Demo periodic task executed by systemd timer...
2025-01-18T14:12:05+0800 server demo-systemd-task.sh[12345]: demo systemd task executed at 2025-01-18T14:12:05+08:00
2025-01-18T14:12:05+0800 server systemd[1]: Finished Demo periodic task executed by systemd timer.

这次手动启动只验证服务本身,不会把定时器的下一次时间改成当前时间。要验证定时器确实触发了服务,应等待 NEXT 到达后再次查看:

三、确认下一次执行时间和实际执行结果:2. 手动执行服务进行首次验证配图

sudo systemctl list-timers demo-systemd-task.timer --all --no-pager
sudo journalctl -u demo-systemd-task.service -n 20 --no-pager -o short-iso

如果 LAST 已出现时间,并且日志中新增了一条执行记录,说明定时器和服务链路均已正常工作。

3. 常用周期表达式

根据实际需求替换 OnCalendar,修改后需要重新加载并重启定时器。

任务需求OnCalendar 示例说明
每 10 分钟<em>-</em>-<em> </em>:00/10:00在每小时的 0、10、20 分钟等时间触发
每 15 分钟<em>-</em>-<em> </em>:00/15:00适合周期性同步或轻量检查
每小时hourly使用 systemd 内置日历别名
每天 02:30<em>-</em>-* 02:30:00按服务器本地时间执行
工作日 02:30Mon..Fri <em>-</em>-* 02:30:00周一至周五执行
每天 02:30 UTC<em>-</em>-* 02:30:00 UTC明确使用 UTC 时区

例如,将任务改为每天凌晨 2:30:

sudo sed -i 's#OnCalendar=.*#OnCalendar=*-*-* 02:30:00#' \
  /etc/systemd/system/demo-systemd-task.timer

sudo systemd-analyze verify /etc/systemd/system/demo-systemd-task.timer
sudo systemctl daemon-reload
sudo systemctl restart demo-systemd-task.timer
sudo systemctl list-timers demo-systemd-task.timer --all --no-pager

sed -i 会直接覆盖目标文件中的匹配行,仅应在确认该文件由本次部署创建、且其中只有一行 OnCalendar 时使用。若是已有生产配置,建议使用编辑器修改并先备份。

如果需要的是“上一次任务完成后再等待固定时长”,而不是固定日历边界,可以使用相对时间配置:

[Timer]
OnBootSec=5min
OnUnitActiveSec=1h
Unit=demo-systemd-task.service

这类配置与 OnCalendar 的时间语义不同。不要在不了解触发关系的情况下同时设置多个时间源,否则任意一个时间条件满足时都可能触发服务。

四、常见异常和处理方法

1. 显示 Unit not found

先确认文件名和路径:

ls -l /etc/systemd/system/demo-systemd-task.service
ls -l /etc/systemd/system/demo-systemd-task.timer

如果文件存在但 systemd 找不到,执行:

sudo systemctl daemon-reload
sudo systemctl list-unit-files | grep demo-systemd-task

还要注意服务名和定时器名必须完整,.timer 和 .service 不能混用。

2. 定时器启动失败或 NEXT 为 n/a

查看定时器状态:

sudo systemctl status demo-systemd-task.timer --no-pager
sudo journalctl -u demo-systemd-task.timer -b --no-pager

再单独验证时间表达式:

systemd-analyze calendar '*-*-* *:00/10:00'

常见原因包括:

  • OnCalendar 拼写或字段格式错误;
  • 修改文件后没有执行 daemon-reload;
  • 定时器没有执行 enable --now;
  • 当前系统不是 systemd 作为 PID 1;
  • 定时器被手动停止或进入 failed 状态。

修正后执行:

sudo systemctl daemon-reload
sudo systemctl restart demo-systemd-task.timer
sudo systemctl list-timers demo-systemd-task.timer --all --no-pager

3. 定时器正常,但服务执行失败

分别查看服务状态和日志:

sudo systemctl status demo-systemd-task.service --no-pager
sudo journalctl -u demo-systemd-task.service -b -n 50 --no-pager

如果日志显示 Permission denied,检查执行权限和目录权限:

ls -ld /usr/local/libexec
ls -l /usr/local/libexec/demo-systemd-task.sh

如果显示 No such file or directory,检查 ExecStart 是否使用了正确的绝对路径。systemd 不会按照交互式 shell 的环境自动补齐命令路径,也不会读取用户的 .bashrc。

修正脚本或单元文件后:

sudo systemctl daemon-reload
sudo systemctl start demo-systemd-task.service
sudo systemctl show demo-systemd-task.service -p Result -p ExecMainStatus

只有在确认故障已经修复后,才考虑清理失败状态:

sudo systemctl reset-failed demo-systemd-task.service

4. 时间和预期不一致

查看服务器时区和时间同步状态:

timedatectl status
date --iso-8601=seconds

OnCalendar 默认按照系统本地时区计算。如果服务器分别位于不同时区,而任务要求统一在 UTC 时间执行,应在表达式中明确写出 UTC,而不是仅依赖服务器本地设置。

如果系统时间刚发生校正,下一次触发时间可能随时钟调整而变化。先确认 NTP 同步状态,不要为了迁就某个任务而直接手动修改系统时间,因为这可能影响证书校验、日志排序和其他定时任务。

5. 任务执行时间超过周期

定时器的周期不是任务执行时长。若任务每 10 分钟触发一次,但一次执行需要 15 分钟,应重新评估周期,避免任务重叠、资源竞争或下一次执行被延后。

可以通过日志和进程状态观察实际耗时:

sudo journalctl -u demo-systemd-task.service --since "1 hour ago" --no-pager -o short-iso

对于不允许并发执行的任务,应在脚本中增加锁机制,或调整为合理的周期。不要简单添加 Restart=always 来解决周期执行问题,这会把执行失败重启和定时触发混在一起。

五、结果检查与验收

首次部署完成后,按以下顺序验收:

  1. 确认 PID 1 为 systemd,服务器时区符合任务要求。
  2. systemd-analyze verify 检查 service 和 timer 单元无配置错误。
  3. systemctl is-enabled demo-systemd-task.timer 返回 enabled。
  4. systemctl is-active demo-systemd-task.timer 返回 active。
  5. systemctl list-timers demo-systemd-task.timer --all 能显示明确的 NEXT 时间。
  6. 手动启动服务后,Result=success 且 ExecMainStatus=0。
  7. journalctl -u demo-systemd-task.service 能看到脚本输出。
  8. 等待一次真实的计划时间后,LAST 更新时间,日志新增一条执行记录。
  9. 任务使用的账户、目录和文件权限符合最小权限要求。
  10. 重启持久性通过 is-enabled 验证,不必为了测试而直接重启生产服务器。

需要注意,定时器的 NEXT 是计划触发时间,不等同于任务已经完成的时间。真正确认执行成功,还需要同时检查服务的 Result、退出码和 journal 日志。

六、回滚与恢复

如果本次部署需要撤销,回滚前先确认只处理本例创建的自定义单元和脚本。若这些文件原本就存在,必须先恢复部署前备份,不能直接删除。

1. 先停止并禁用定时器

sudo systemctl disable --now demo-systemd-task.timer

该命令会停止当前定时器,并移除它随系统启动自动运行的关联。它不会删除服务脚本,也不会清理历史日志。

确认已停止:

sudo systemctl is-enabled demo-systemd-task.timer
sudo systemctl is-active demo-systemd-task.timer

预期分别为 disabled 和 inactive,或者在单元不存在时返回对应错误。

2. 备份后删除本次创建的文件

删除前可以将文件备份到 root 目录:

backup_dir="/root/systemd-demo-backup-$(date +%Y%m%d%H%M%S)"
sudo install -d -m 0700 "$backup_dir"
sudo cp -a \
  /etc/systemd/system/demo-systemd-task.service \
  /etc/systemd/system/demo-systemd-task.timer \
  /usr/local/libexec/demo-systemd-task.sh \
  "$backup_dir/"

确认备份成功后,再删除准确的自定义路径:

sudo rm -f \
  /etc/systemd/system/demo-systemd-task.timer \
  /etc/systemd/system/demo-systemd-task.service \
  /usr/local/libexec/demo-systemd-task.sh

rm -f 会永久移除指定文件,不能把路径扩大到目录或通配符。该操作不会删除 journald 中已经产生的服务日志。

3. 重新加载并确认回滚状态

sudo systemctl daemon-reload
sudo systemctl reset-failed demo-systemd-task.timer demo-systemd-task.service 2>/dev/null || true
sudo systemctl list-timers --all --no-pager | grep demo-systemd-task || true

回滚完成后,检查项应满足:

  • 定时器不再处于 active 状态;
  • list-timers 中不再出现该定时器;
  • /etc/systemd/system/ 下不再有本次创建的单元文件;
  • 服务脚本不再存在,或已恢复为部署前版本;
  • 原有业务服务和其他定时器未被停止或修改;
  • 如需恢复部署,使用备份文件放回原路径后执行 daemon-reload,再重新验证单元配置。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5490.html

相关推荐