CronHub

快速开始

CronHub 是一个运行在 Cloudflare Workers 上的定时任务管理平台，支持 GitHub Actions 触发和 HTTP 请求两种方式。

定时任务

每个任务包含以下字段：

任务操作

• 暂停 / 启用：点击任务行的「暂停」或「启用」按钮，立即生效，不影响历史记录。
• 立即执行：点击「▶ 运行」可跳过等待，立即触发一次执行。
• 编辑：修改任务配置后保存，下次执行时生效。
• 删除：删除任务及其所有执行历史，不可恢复。

Cron 表达式

格式：分 时 日 月 周，共 5 段，均为 UTC 时区。

平台连接

平台连接保存第三方服务的访问凭证，任务执行时通过对应连接调用目标平台。

连接 GitHub（推荐：OAuth 设备码）

1. 点击「平台连接」页右上角 Connect GitHub
2. 填写连接名称（如「个人账号」「公司账号」），点击「开始授权」
3. 浏览器自动打开 github.com/login/device
4. 在 GitHub 页面输入显示的 8 位验证码
5. 授权完成后弹窗自动显示头像和用户名，点击「完成」

手动添加 Token

点击「+ 其他连接」，选择平台类型并填写 Token：

GitHub Actions 任务

通过调用 GitHub API 触发仓库的 workflow_dispatch 事件来执行任务。

配置字段

新建 / 编辑 Workflow 文件

• 在 Workflow 下拉选「➕ 创建新 Workflow...」，选择模板（HTTP 请求 / Python / Node.js / 空白），在编辑器中修改后点「创建文件」，文件将直接提交到 GitHub 仓库。
• 选中已有 Workflow 后，点右侧 ✏️ 按钮可加载当前内容进行编辑，保存后自动提交更新。

Workflow 示例

name: 定时数据同步

on:
  workflow_dispatch:
    inputs:
      env:
        description: '环境'
        default: 'production'

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 执行同步脚本
        run: python sync.py
        env:
          DB_URL: ${{ secrets.DB_URL }}

HTTP 任务

直接向指定 URL 发送 HTTP 请求，适合调用 Webhook、触发自有服务接口等场景。

API 调用

所有操作均可通过 REST API 完成，适合与 CI/CD 或其他系统集成。请求时需在 Header 中携带 API Key。

Authorization: Bearer <your-api-key>

常用接口

创建任务示例

curl -X POST https://your-worker.workers.dev/api/tasks \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "每日备份",
    "cron": "0 2 * * *",
    "platform": "github",
    "platform_connection_id": "<connection-id>",
    "config": {
      "owner": "your-org",
      "repo": "your-repo",
      "workflow_id": "backup.yml",
      "ref": "main"
    }
  }'

常见问题