内容总览

linux: 计划任务与定时器 思维导图

一、cron 计划任务

1.1 crontab

  • 全称:cron table(cron 表)
  • 作用:管理当前用户的计划任务,实际存放于 /var/spool/cron/crontabs/<用户>
  • 常用参数:
  • -e:编辑任务表
  • -l:列出任务表
  • -u:指定用户,需 root 权限
  • -r:删除全部任务
  • -i:删除前逐条确认,与 -r 搭配
  • 示例:
crontab -l
crontab -e
sudo crontab -l -u root
  • 坑点:/var/spool/cron/crontabs/ 下的文件不应直接编辑,应统一使用 crontab -e,否则可能出现权限与格式问题。

1.2 crontab -e

  • 全称:cron table(cron 表),-e edit
  • 作用:编辑当前用户的计划任务,保存退出后自动生效
  • 示例:
crontab -e
EDITOR=/usr/bin/vim crontab -e
crontab -l
  • 说明:首次执行需选择编辑器,也可通过 EDITOR 环境变量临时指定;任务行格式为"分 时 日 月 周 命令",例如 */5 * * * * /usr/local/bin/check.sh >> /var/log/check.log 2>&1。
  • 坑点:cron 执行任务时不加载 ~/.bashrc、~/.profile 等登录环境,别名、函数与自定义环境变量均不可用。

1.3 crontab -l

  • 全称:cron table(cron 表),-l list
  • 作用:列出当前用户的计划任务
  • 示例:
crontab -l
sudo crontab -l -u www-data
  • 坑点:当前用户没有任务时输出 "no crontab for <用户>",这是正常提示而非错误。

1.4 crontab -u

  • 全称:cron table(cron 表),-u user
  • 作用:以 root 身份查看或修改指定用户的任务表
  • 示例:
sudo crontab -l -u root
sudo crontab -e -u www-data
  • 坑点:普通用户使用 -u 会被拒绝;通过 -u 添加的任务以目标用户身份执行,权限与写入路径均按该用户计算。

1.5 crontab -r

  • 全称:cron table(cron 表),-r remove
  • 作用:删除当前用户的全部计划任务,无确认提示
  • 示例:
crontab -l > /root/crontab_backup_$(date +%F).txt
crontab -ri
crontab -l
  • 高危 提醒:crontab -r 一次性删除当前用户全部计划任务,无确认、无回收站、无法撤销,误执行会导致备份、巡检等任务静默失效。防护建议为操作前先 crontab -l > /root/crontab_backup_$(date +%F).txt 导出,日常清理使用 crontab -ri 逐条确认,或进入 crontab -e 按行删除需要取消的任务。

1.6 cron 五个时间字段

  • 全称:cron 源自希腊语 chronos(时间),指按时间调度任务的守护进程
  • 作用:定义任务执行的时间点
  • 字段含义(按从左到右顺序):分钟 0 至 59、小时 0 至 23、日 1 至 31、月 1 至 12、星期 0 至 7(0 与 7 均表示星期日)
  • 通配符写法:
  • *:任意值
  • */5:每 5 个单位执行一次
  • 1-5:范围,表示第 1 到第 5 个值
  • 1,3,5:列表,表示第 1、3、5 个值
  • 组合写法 0-30/10:在第 0 到第 30 个单位内每 10 个单位执行一次
  • 示例:
crontab -e
# */5 * * * * /usr/local/bin/check.sh
# 0 3 * * * /usr/local/bin/backup.sh
# 0 9 * * 1-5 /usr/local/bin/report.sh
# 0 8,12,18 * * * /usr/local/bin/sync.sh
crontab -l
  • 坑点:日与星期两个字段同时不是 * 时为"或"关系,满足任一条件即执行,容易造成执行次数多于预期;星期字段建议使用 0 至 7 的数字,避免名称写法在不同实现下产生差异。

1.7 /etc/crontab 与 /etc/cron.d 的格式差异

  • 全称:cron table(cron 表)
  • 作用:系统级计划任务配置,与用户任务表的差异在于多一个用户字段
  • 格式差异:
  • 用户 crontab:分 时 日 月 周 命令
  • /etc/crontab 与 /etc/cron.d/ 下的文件:分 时 日 月 周 用户 命令
  • 示例:
cat /etc/crontab
ls -l /etc/cron.d/
sudo tee /etc/cron.d/myjob <<'EOF'
30 2 * * * root /usr/local/bin/cleanup.sh >> /var/log/cleanup.log 2>&1
EOF
  • 坑点:/etc/cron.d/ 下的文件名只能由字母、数字、下划线、连字符组成,含点号的文件会被忽略;文件属主须为 root,且不可被组或其他用户写入。

1.8 /etc/cron.hourly 与 daily 与 weekly 与 monthly

  • 全称:cron hourly(每小时)、daily(每天)、weekly(每周)、monthly(每月)
  • 作用:放置可执行脚本,由系统任务表通过 run-parts 按周期调用
  • 示例:
ls -l /etc/cron.hourly/ /etc/cron.daily/ /etc/cron.weekly/ /etc/cron.monthly/
sudo install -m 755 ./cleanup /etc/cron.daily/cleanup
cat /etc/crontab
  • 说明:四个目录的触发时间由 /etc/crontab 中的 run-parts 条目与 anacron 配合决定;目录内只需放置脚本文件,不写时间字段,脚本必须具有可执行权限。
  • 坑点:run-parts 会忽略文件名中包含点号的脚本,backup.sh 放入 /etc/cron.daily/ 不会被执行,文件名应为 backup 这类不含点号的名称。

1.9 PATH 与执行环境问题

  • 全称:PATH 取自 path(可执行文件搜索路径)
  • 作用:说明 cron 执行环境与交互式 shell 的差异
  • 差异说明:
  • cron 的默认 PATH 通常为 /usr/bin:/bin,不含 /usr/local/bin 等目录
  • cron 不加载 ~/.bashrc、~/.profile、/etc/profile
  • 用户任务的工作目录为用户主目录,系统任务的工作目录为 /
  • HOME、LANG、TZ 等变量可能与登录会话中不同
  • 示例:
crontab -e
# PATH=/usr/local/bin:/usr/bin:/bin
# LANG=zh_CN.UTF-8
# 0 4 * * * /usr/local/bin/task.sh >> /var/log/task.log 2>&1
  • 坑点:脚本内部调用命令时使用绝对路径最可靠;依赖 PATH 时应在 crontab 顶部或在脚本内显式导出 PATH。

1.10 输出重定向与邮件打扰

  • 全称:redirect(重定向)
  • 作用:控制任务输出,避免大量邮件同时保留必要的错误信息
  • 写法说明:
  • 丢弃全部输出:>> /dev/null 2>&1
  • 记录输出:>> /var/log/task.log 2>&1
  • 关闭邮件:在任务表中设置 MAILTO=""
  • 示例:
crontab -e
# MAILTO=""
# 0 3 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1
# */5 * * * * /usr/local/bin/check.sh >/dev/null 2>&1
  • 说明:cron 会把任务的标准输出与标准错误通过本地邮件发送给任务属主,输出较多时会产生大量邮件。
  • 坑点:只写 >> 文件 而不写 2>&1 时错误信息仍会通过邮件发出;全部重定向到 /dev/null 会丢失排障信息,建议至少保留一份日志文件。

1.11 % 在 cron 命令中的转义

  • 全称:percent(百分号,在 cron 中表示换行)
  • 作用:说明 cron 对百分号的特殊处理
  • 规则说明:任务行中未转义的 % 表示换行,其后的内容作为命令的标准输入,命令会被截断
  • 示例:
crontab -e
# 错误写法:% 未转义,date 的参数被当作标准输入
# 0 1 * * * tar czf /backup/$(date +%F).tar.gz /data
# 正确写法:% 前加反斜杠
# 0 1 * * * tar czf /backup/$(date +\%F).tar.gz /data
  • 坑点:含日期格式的命令直接写入任务表时最常见的失败原因即百分号未转义;更稳妥的做法是把逻辑写入脚本,任务行只调用脚本。

1.12 cron 日志查看

  • 全称:cron 源自希腊语 chronos(时间)
  • 作用:确认任务是否按计划触发以及执行结果
  • 查看方式:
  • journalctl -u cron --since today:查看 cron 服务日志
  • sudo grep CRON /var/log/syslog:查看 rsyslog 记录的 cron 消息
  • sudo grep CRON /var/log/cron.log:rsyslog 为 cron 设施单独输出时使用
  • 任务自身输出:查看任务中重定向指定的日志文件
  • 示例:
systemctl status cron
journalctl -u cron --since today --no-pager
sudo grep CRON /var/log/syslog | tail -n 20
  • 坑点:cron 日志只证明任务被触发,不包含任务内部命令的输出;未在任务中重定向输出时,错误信息只体现在邮件中。

二、at 与 batch

2.1 at

  • "在……时刻"
  • 作用:提交一次性延时任务,由 atd 服务负责执行
  • 常用参数:-l 列出任务(等同 atq)、-r 删除任务(等同 atrm)、-c 查看任务内容、-f 从文件读取命令、-m 任务结束后发送邮件
  • 时间写法:now +5min、10:30、tomorrow、teatime(16:00)
  • 示例:
echo "/usr/local/bin/backup.sh" | at now +5min
at 22:00
sudo systemctl status atd
atq
  • 说明:Ubuntu 可能默认未安装 at,需 sudo apt install at 并启动 atd 服务;提交成功后会输出任务编号与计划执行时间。
  • 坑点:atd 未运行时任务只排队不执行;任务的工作目录与提交时一致,脚本中的相对路径容易失效。

2.2 at -f

  • 全称:file(文件)
  • 作用:把脚本文件作为任务内容提交,避免交互式输入
  • 示例:
at -f ./cleanup.sh now +1hour
at -f /usr/local/bin/report.sh 08:00 tomorrow
atq
  • 坑点:-f 提交的是脚本内容本身,脚本中的相对路径按提交时的工作目录解析,建议脚本内部统一使用绝对路径。

2.3 atq

  • 全称:at queue(查看 at 队列)
  • 作用:列出待执行的任务,root 可查看全部用户的任务
  • 示例:
atq
sudo atq
  • 说明:输出格式为"任务编号 执行时间 队列标记 提交用户",任务编号用于 atrm 删除。

2.4 atrm

  • 全称:at remove(删除 at 任务)
  • 作用:按任务编号删除待执行的任务
  • 示例:
atq
atrm 7
atq
  • 坑点:只能删除尚未执行的任务;普通用户只能删除自己的任务,删除他人任务需要 root 权限。

2.5 batch

  • 全称:"批处理"
  • 作用:提交在系统负载较低时执行的一次性任务,等价于 at -q b
  • 示例:
echo "/usr/local/bin/heavy_task.sh" | batch
batch -f ./index.sh
atq
  • 说明:batch 队列中的任务在系统平均负载降到阈值以下时启动,同一时刻只运行一个任务,适合资源占用较高的离线作业。
  • 坑点:负载长期偏高时任务可能长时间不执行,对时效有要求的任务应使用 at 或 systemd timer。

2.6 /etc/at.deny 与 /etc/at.allow

  • 全称:at deny(禁止名单)与 at allow(允许名单)
  • 作用:控制哪些用户可以提交 at 任务
  • 规则说明:
  • 存在 /etc/at.allow 时,只有名单中的用户可以使用 at,/etc/at.deny 被忽略
  • 只存在 /etc/at.deny 时,名单中的用户被禁止,其余用户允许使用
  • 两个文件都不存在时,仅 root 可以使用 at
  • 示例:
cat /etc/at.allow
cat /etc/at.deny
sudo sh -c 'echo "developer" >> /etc/at.deny'
  • 坑点:两个文件均为纯文本,每行一个用户名,逐行写入时不要附带多余空格;修改后无需重启服务。

三、systemd timer

3.1 timer 与 service 单元配对

  • 全称:systemd timer unit(systemd 定时器单元)
  • 作用:由 .timer 单元按时间触发同名 .service 单元,实现计划任务
  • 配对规则:mytask.timer 触发 mytask.service,两个文件去掉扩展名后名称必须一致,通常放在 /etc/systemd/system/
  • 示例:
sudo tee /etc/systemd/system/mytask.service <<'EOF'
[Unit]
Description=Daily backup task

[Service]
Type=oneshot
ExecStart=/usr/local/bin/backup.sh
EOF

sudo tee /etc/systemd/system/mytask.timer <<'EOF'
[Unit]
Description=Run mytask daily

[Timer]
OnCalendar=*-*-* 03:30:00
Persistent=true

[Install]
WantedBy=timers.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now mytask.timer
systemctl list-timers mytask.timer
  • 坑点:新增或修改单元文件后必须执行 systemctl daemon-reload;只需启用 timer,配套的 service 不需要单独 enable。

3.2 OnCalendar 时间语法

  • 全称:on calendar(按日历时间)
  • 作用:指定定时器触发的日历时间点
  • 语法说明:格式为"星期 年-月-日 时:分:秒",各部分用 * 表示任意值,也可使用范围、列表与步长
  • 常见写法:
  • *-*-* 03:00:00:每天 3 点
  • daily:等价于 *-*-* 00:00:00
  • Mon..Fri *-*-* 09:00:00:工作日 9 点
  • *-*-* *:0/15:00:每小时的第 0、15、30、45 分钟
  • *-*-01 04:00:00:每月 1 日 4 点
  • 示例:
systemd-analyze calendar "Mon..Fri *-*-* 09:00:00"
systemd-analyze calendar "*-*-* *:0/15:00"
systemd-analyze calendar daily
  • 坑点:星期与月份使用英文缩写(Mon、Tue、Jan 等),省略星期部分时该位置需保留 * 占位;写好的表达式用 systemd-analyze calendar 校验,命令同时输出下次触发时间。

3.3 OnBootSec 与 OnUnitActiveSec

  • 全称:on boot seconds(启动后经过的秒数)与 on unit active seconds(单元活跃后经过的秒数)
  • 作用:使用相对时间定义触发点,适合开机后延时执行与固定间隔重复执行
  • 取值写法:30s、5min、1h、1d
  • 示例:
sudo tee /etc/systemd/system/collector.timer <<'EOF'
[Unit]
Description=Collect metrics every 10 minutes

[Timer]
OnBootSec=2min
OnUnitActiveSec=10min

[Install]
WantedBy=timers.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now collector.timer
systemctl list-timers collector.timer
  • 说明:OnBootSec 以系统启动时刻为基准,OnUnitActiveSec 以上一次任务启动时刻为基准,二者可同时使用。
  • 坑点:OnUnitActiveSec 的计时基准是上一次启动时刻,任务执行时间超过间隔时会出现连续触发,长任务应改用 OnCalendar 或延长间隔。

3.4 Persistent

  • 全称:persistent(持久化补跑)
  • 作用:记录上次触发时间,若在应触发时刻系统处于关机状态,开机后补执行一次
  • 示例:
sudo systemctl edit --full mytask.timer
# 在 [Timer] 段中设置
# Persistent=true
sudo systemctl daemon-reload
sudo systemctl restart mytask.timer
systemctl list-timers mytask.timer
  • 说明:补跑依赖定时器状态记录文件(/var/lib/systemd/timers/),只对基于 OnCalendar 的定时器有意义。
  • 坑点:补跑会在开机后立即触发一次,任务较重时可能与开机服务争抢资源,可配合 RandomizedDelaySec 分散启动时间。

3.5 systemctl list-timers

  • 全称:system control list timers(列出定时器)
  • 作用:列出系统中的定时器及下次触发时间
  • 常用参数:--all 包含未激活的定时器,可附加单元名只显示指定定时器
  • 示例:
systemctl list-timers
systemctl list-timers --all
systemctl list-timers logrotate.timer
  • 说明:输出列依次为下次触发时间、剩余时间、上次触发时间、已过去时间、单元名与激活状态;NEXT 列为空表示该定时器不会再次触发。

3.6 systemctl enable --now

  • 全称:system control enable(启用并立即启动)
  • 作用:一次完成设置开机自启与立即启动两个动作
  • 示例:
sudo systemctl enable --now mytask.timer
sudo systemctl status mytask.timer
sudo systemctl disable --now mytask.timer
  • 坑点:enable 只设置开机自启,不会立即启动,需要 --now 才会同时 start;disable --now 会停止运行中的定时器并取消自启。

3.7 systemd-run --on-calendar

  • 全称:systemd run(运行临时单元)
  • 作用:不创建单元文件,直接提交临时定时任务
  • 常用参数:--on-calendar= 指定日历时间,--on-active= 指定相对时间,--unit= 指定单元名,--user 以当前用户身份运行
  • 示例:
sudo systemd-run --on-calendar="*-*-* 04:00:00" --unit=once-task /usr/local/bin/backup.sh
sudo systemd-run --on-active=30min --unit=delay-reboot /sbin/reboot
systemctl list-timers | grep once
  • 坑点:临时单元在重启后不复存在;单元名重复时提交会失败,需先 sudo systemctl stop once-task.timer 清理旧的临时单元;长期任务仍应写入单元文件。

3.8 timer 与 cron 的取舍

  • 全称:systemd timer unit(定时器单元)与 cron table(cron 表)
  • 作用:说明两种计划任务机制的适用场景
  • 对比说明:
  • 补跑能力:timer 通过 Persistent=true 补跑错过的任务,cron 本身无补跑机制
  • 日志:timer 的输出统一进入 journald,可用 journalctl -u 查询,cron 依赖 syslog 与邮件
  • 依赖控制:timer 可声明 After、Requires 等依赖关系,cron 无依赖控制
  • 配置成本:cron 一行即可定义任务,timer 需要 service 与 timer 两个单元文件
  • 时间分散:timer 提供 RandomizedDelaySec=,cron 只能借助通配符范围分散
  • 示例:
systemctl list-timers --all
crontab -l
  • 说明:面向系统服务的周期任务优先使用 timer,与 systemd 的日志、依赖与状态管理集成更好;用户级、临时性的一行命令用 crontab 更直接。

四、高危命令与常见坑点汇总

4.1 高危命令

以下命令或操作影响范围大且多数不可逆,执行前必须确认目标与影响面:

命令 风险 防护建议
crontab -r 无确认删除当前用户全部计划任务,备份与巡检任务静默失效 先 crontab -l > 备份文件;日常清理用 crontab -ri
systemctl mask 屏蔽服务后其他单元无法启动它,排查耗时长 确认服务无依赖后再屏蔽;用 systemctl unmask 恢复

4.2 常见坑点

  • cron 不加载 ~/.bashrc 等环境文件,命令需用绝对路径或显式设置 PATH
  • cron 命令中的 % 必须写成 \%
  • cron 的日与星期字段同时非 * 时按"或"关系匹配
  • cron 任务输出默认通过邮件发送,应重定向输出或设置 MAILTO=""
  • /etc/cron.d/ 下文件名含点号会被忽略
  • /etc/cron.hourly 等目录中的脚本文件名含点号不会被 run-parts 执行
  • at 任务依赖 atd 服务运行,服务未启动时任务只排队
  • /etc/at.allow 存在时 /etc/at.deny 被忽略
  • 修改 systemd 单元文件后必须执行 systemctl daemon-reload
  • Persistent=true 只对基于 OnCalendar 的定时器有意义
  • systemctl enable 不会立即启动单元,需要加 --now

五、命令全称对照表

命令 全称 含义
crontab cron table 管理计划任务表
cron 源自 chronos 计划任务守护进程
run-parts run-parts 按目录批量执行脚本
at at 提交一次性延时任务
atq at queue 查看 at 任务队列
atrm at remove 删除 at 任务
batch batch 低负载时执行的一次性任务
atd at daemon at 任务守护进程
systemctl system control 管理 systemd 单元与服务
systemd-run systemd run 运行临时单元
systemd-analyze systemd analyze 分析启动过程与日历表达式

六、快速检索清单

目标 命令
查看用户计划任务 crontab -l
编辑用户计划任务 crontab -e
查看系统级计划任务 cat /etc/crontab 与 ls -l /etc/cron.d/
查看 cron 触发记录 journalctl -u cron --since today --no-pager
清点全部计划任务 systemctl list-timers --all 与遍历各用户 crontab -l
查看 at 任务队列 atq
删除 at 任务 atrm <任务编号>
查看 systemd 定时器 systemctl list-timers
校验 timer 时间表达式 systemd-analyze calendar "*-*-* 03:00:00"
启用并启动定时器 sudo systemctl enable --now <单元名>.timer