# 创建每天早上 9 点运行的定时任务
hoody cron create root \
--schedule "0 9 * * *" \
--command "/usr/local/bin/backup.sh" \
--comment "Daily backup at 9 AM"
# 响应
[
"id": "7d3f2a1b-8c4e-4f9a-b2d5",
"schedule_human": "At 09:00",
"enabled": true
]
# 临时禁用任务
hoody cron update root $ENTRY_ID --enabled false
# 条目已禁用
你所需的每种模式
八个表达式及其易读等价形式——直接来自 API 的 schedule_human 字段。
一览调度计划
四个托管条目在滚动轴上呈现——即将触发的条目显示为蓝色，已禁用的条目变暗。由 schedule_human 和 enabled 状态驱动。
daily-backup
02:00
health-check
每 15 分钟
log-rotate
周日 00:00
sync-reports
周一至周五 09:00
托管或原始——随你选择
通过 JSON API 使用 UUID 跟踪的条目（含开关和过期功能），或直接访问 crontab 文件以完全掌控工作流。
托管条目
5 个接口UUID 支持的 CRUD——通过 JSON 创建、读取、更新、删除定时任务。添加注释、切换启用状态、设置自动过期，无需触碰原始 crontab。
# 创建托管条目
POST /users/[user]/entries
[
"schedule": "0 9 * * *",
"command": "/usr/local/bin/backup.sh",
"comment": "Daily backup",
"enabled": true,
"expires_at": null
原始 Crontab
3 个接口对每个系统用户的 crontab 文件具有完整读写权限。当需要完全控制或有现有 crontab 工作流时使用此模式。
# 读取原始 crontab
GET /users/[user]/crontab
# 替换整个 crontab
PUT /users/[user]/crontab
["crontab": "0 5 * * * /usr/local/bin/backup.sh"]
常用 Cron 表达式
可直接复制粘贴的表达式——每个均经过上方表达式参考验证。
* * * * *
每分钟
每个时钟滴答触发一次，适合持续轮询任务、指标采集器或看门狗进程。
0 * * * *
每小时
每小时整点触发，适合小时摘要、缓存预热或定期 API 同步。
0 9 * * 1-5
工作日早 9 点
仅在周一至周五 09:00 触发，适合发送每日摘要或生成报告等工作时段任务。
0 0 1 * *
每月第一天
每月 1 日午夜触发，适合月度汇总、计费周期和归档任务。
*/5 * * * *
每 5 分钟
每 5 分钟触发，适合健康检查、队列消费和近实时数据同步。
@daily
每日宏
等同于 0 0 * * *——每天午夜触发。表达每日一次调度最简洁的方式。
9 个接口。两种模式。
五个托管条目 CRUD 接口、三个原始 crontab 接口和一个健康检查——均按系统用户作用域隔离。
托管条目
5 个接口GET /users/root/entries → [[id, schedule_human, enabled]]
原始 Crontab
3 个接口PUT /users/root/crontab → [crontab, user]
系统
1 个接口GET /health → [status: ok]