cron
Use Cautionnpx machina-cli add skill chaterm/terminal-skills/cron --openclaw定时任务管理
概述
Cron 定时任务配置、日志监控、故障排查等技能。
Crontab 基础
管理命令
# 编辑当前用户的 crontab
crontab -e
# 查看当前用户的 crontab
crontab -l
# 删除当前用户的 crontab
crontab -r
# 管理其他用户的 crontab(需要 root)
crontab -u username -e
crontab -u username -l
时间格式
┌───────────── 分钟 (0-59)
│ ┌───────────── 小时 (0-23)
│ │ ┌───────────── 日 (1-31)
│ │ │ ┌───────────── 月 (1-12)
│ │ │ │ ┌───────────── 星期 (0-7, 0和7都是周日)
│ │ │ │ │
* * * * * command
特殊字符
* # 任意值
, # 列表 (1,3,5)
- # 范围 (1-5)
/ # 步长 (*/5 每5分钟)
# 示例
0 * * * * # 每小时整点
*/15 * * * * # 每15分钟
0 9-17 * * * # 9点到17点每小时
0 0 * * 1-5 # 工作日零点
0 0 1,15 * * # 每月1号和15号零点
特殊时间字符串
@reboot # 系统启动时
@yearly # 每年 (0 0 1 1 *)
@monthly # 每月 (0 0 1 * *)
@weekly # 每周 (0 0 * * 0)
@daily # 每天 (0 0 * * *)
@hourly # 每小时 (0 * * * *)
配置文件
用户 crontab
# 位置
/var/spool/cron/crontabs/username # Debian/Ubuntu
/var/spool/cron/username # CentOS/RHEL
# 格式
SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin
MAILTO=admin@example.com
# 任务
0 2 * * * /usr/local/bin/backup.sh
系统 crontab
# /etc/crontab
SHELL=/bin/bash
PATH=/sbin:/bin:/usr/sbin:/usr/bin
MAILTO=root
# 格式:多了用户字段
# 分 时 日 月 周 用户 命令
0 2 * * * root /usr/local/bin/backup.sh
cron.d 目录
# /etc/cron.d/myapp
SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin
0 * * * * appuser /opt/myapp/hourly-task.sh
0 2 * * * root /opt/myapp/daily-backup.sh
预定义目录
/etc/cron.hourly/ # 每小时执行
/etc/cron.daily/ # 每天执行
/etc/cron.weekly/ # 每周执行
/etc/cron.monthly/ # 每月执行
# 放入可执行脚本即可
chmod +x /etc/cron.daily/myscript
最佳实践
脚本模板
#!/bin/bash
# /usr/local/bin/cron-task.sh
# 日志文件
LOG_FILE="/var/log/cron-task.log"
# 锁文件(防止重复执行)
LOCK_FILE="/var/run/cron-task.lock"
# 检查锁
if [ -f "$LOCK_FILE" ]; then
echo "$(date): Task already running" >> "$LOG_FILE"
exit 1
fi
# 创建锁
trap "rm -f $LOCK_FILE" EXIT
touch "$LOCK_FILE"
# 记录开始
echo "$(date): Task started" >> "$LOG_FILE"
# 执行任务
/path/to/actual/command >> "$LOG_FILE" 2>&1
EXIT_CODE=$?
# 记录结束
echo "$(date): Task finished with exit code $EXIT_CODE" >> "$LOG_FILE"
exit $EXIT_CODE
Crontab 条目
# 推荐写法
# 1. 使用绝对路径
# 2. 重定向输出
# 3. 添加注释
# 每日备份 - 凌晨2点
0 2 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1
# 每5分钟健康检查
*/5 * * * * /usr/local/bin/healthcheck.sh > /dev/null 2>&1
# 每周日志清理 - 周日凌晨3点
0 3 * * 0 /usr/local/bin/cleanup-logs.sh >> /var/log/cleanup.log 2>&1
环境变量
# 在 crontab 中设置
SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin
HOME=/home/user
MAILTO=admin@example.com
# 或在脚本中加载
#!/bin/bash
source /etc/profile
source ~/.bashrc
日志与监控
查看日志
# 系统日志
grep CRON /var/log/syslog # Debian/Ubuntu
grep CRON /var/log/cron # CentOS/RHEL
# 实时监控
tail -f /var/log/syslog | grep CRON
# 查看邮件(如果配置了 MAILTO)
cat /var/mail/username
调试技巧
# 手动测试脚本
/usr/local/bin/myscript.sh
# 模拟 cron 环境
env -i /bin/bash --noprofile --norc -c '/usr/local/bin/myscript.sh'
# 检查 cron 服务状态
systemctl status cron # Debian/Ubuntu
systemctl status crond # CentOS/RHEL
常见场景
场景 1:数据库备份
# 每天凌晨2点备份 MySQL
0 2 * * * /usr/bin/mysqldump -u root -p'password' database | gzip > /backup/db_$(date +\%Y\%m\%d).sql.gz
# 注意:% 需要转义为 \%
场景 2:日志轮转
# 每天压缩并清理7天前的日志
0 0 * * * find /var/log/myapp -name "*.log" -mtime +7 -delete
0 1 * * * gzip /var/log/myapp/*.log.1
场景 3:监控告警
# 每5分钟检查服务状态
*/5 * * * * /usr/local/bin/check-service.sh || /usr/local/bin/send-alert.sh
场景 4:使用 flock 防止重复
# 使用 flock 确保单实例运行
*/5 * * * * /usr/bin/flock -n /var/lock/mytask.lock /usr/local/bin/mytask.sh
故障排查
| 问题 | 排查方法 |
|---|---|
| 任务不执行 | 检查 cron 服务状态、日志 |
| 权限错误 | 检查脚本权限、用户权限 |
| 环境变量问题 | 在脚本中设置 PATH |
| 命令找不到 | 使用绝对路径 |
| 输出丢失 | 重定向到日志文件 |
# 检查 cron 服务
systemctl status cron
# 检查用户是否被禁止
cat /etc/cron.allow
cat /etc/cron.deny
# 检查语法
crontab -l | grep -v '^#' | while read line; do
echo "Checking: $line"
done
Source
git clone https://github.com/chaterm/terminal-skills/blob/main/server/cron/SKILL.mdView on GitHub Overview
cron 提供定时任务配置能力,覆盖用户级 crontab、系统 crontab、以及 cron.d 目录等场景。你可以编排命令的定时执行、输出日志、以及在出现故障时进行排查与修复。它还支持将任务放在 /etc/cron.daily、/etc/cron.hourly 等预定义目录中,方便集中管理。
How This Skill Works
Cron 读取用户级和系统级的 crontab,以及 /etc/cron.d 目录中的任务定义,根据时间字段匹配触发执行。每次执行时,任务在一个受限的环境中运行,通常使用 SHELL 和 PATH 的系统默认设置,输出可以通过重定向保存到日志文件或通过 MAILTO 发送邮件。若需要避免并发执行,可以在脚本内使用锁(如 flock),并优先使用绝对路径的可执行程序。你也可以通过在脚本中显式设置 PATH/SHELL,或将常用任务放在 /usr/local/bin,然后在 crontab 中调用。
When to Use It
- 需要按固定时间表重复执行的维护任务(如备份、清理、健康检查等)
- 需要集中管理系统任务,利用 /etc/cron.d、cron.d 目录或预定义目录(如 /etc/cron.daily)
- 需要在系统启动时执行一次性任务(@reboot)
- 需要避免同一任务的并发执行(使用 flock 等机制)
- 需要将任务输出记录到日志或通过 MAILTO 通知管理员
Quick Start
- 1. 确认你要执行的脚本已存在且可执行(建议使用绝对路径)
- 2. 编辑当前用户的 crontab:crontab -e
- 3. 添加一个带输出重定向的条目,例如:0 2 * * * /usr/local/bin/backup.sh >> /var/log/backup.log 2>&1
- 4. 保存并用 crontab -l 验证条目是否生效
- 5. 初次执行后查看日志以确认输出与错误信息是否如期产生
- 6. 如需单实例执行,改用 flock 示例:*/5 * * * * /usr/bin/flock -n /var/lock/mytask.lock /usr/local/bin/mytask.sh
Best Practices
- 始终使用绝对路径(脚本和可执行程序)以避免 Cron 环境下的路径问题
- 将输出重定向到日志文件,并定期轮转日志
- 在脚本中明确设置 PATH、SHELL 等环境变量,必要时在脚本内加载系统环境
- 使用锁文件或 flock 来防止同一任务的并发执行
- 为每条任务添加注释,便于日后维护和排查
Example Use Cases
- 场景1:数据库备份 - 每日凌晨2点备份 MySQL 数据库并压缩:0 2 * * * /usr/bin/mysqldump -u root -p'password' database | gzip > /backup/db_$(date +\%Y\%m\%d).sql.gz(请将 % 转义为 \%)
- 场景2:日志轮转 - 每日压缩前一天日志并清理多余文件:0 0 * * * find /var/log/myapp -name "*.log" -mtime +7 -delete; 0 1 * * * gzip /var/log/myapp/*.log.1
- 场景3:健康检查 - 每5分钟执行健康检查脚本,异常时触发告警:*/5 * * * * /usr/local/bin/check-service.sh || /usr/local/bin/send-alert.sh
- 场景4:防重复执行 - 使用 flock 保证任务单实例执行:*/5 * * * * /usr/bin/flock -n /var/lock/mytask.lock /usr/local/bin/mytask.sh
- 场景5:系统初始化 - 系统启动后执行一次性初始化任务:@reboot /usr/local/bin/initialize.sh
Frequently Asked Questions
Related Skills
shell-scripting
chaterm/terminal-skills
Bash Shell 脚本编写
apache
chaterm/terminal-skills
Apache HTTP Server 配置
email-sequence
coreyhaines31/marketingskills
When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding-cro.
nginx
chaterm/terminal-skills
Nginx configuration and optimization
convex-cron-jobs
waynesutton/convexskills
Scheduled function patterns for background tasks including interval scheduling, cron expressions, job monitoring, retry strategies, and best practices for long-running tasks
programmatic-seo
coreyhaines31/marketingskills
When the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pages," "[keyword] + [city] pages," "comparison pages," "integration pages," "building many pages for SEO," "pSEO," "generate 100 pages," "data-driven pages," or "templated landing pages." Use this whenever someone wants to create many similar pages targeting different keywords or locations. For auditing existing SEO issues, see seo-audit. For content strategy planning, see content-strategy.