CronHub

快速开始

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

定时任务

每个任务包含以下字段：

任务操作

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

失败重试

新建或编辑任务时，可在「失败重试」区域配置自动重试策略：

重试记录会在「执行历史」中独立显示，标注「重试 N」或「待重试」，可追溯完整的重试链路。重试不会影响下一次正常调度时间。

Cron 表达式

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

平台连接

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

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

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

手动添加 Token

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

编辑平台连接

点击平台连接卡片上的「编辑」按钮，可以：

• 修改名称：所有连接类型均可修改显示名称
• 更换 Token：手动添加的连接可替换 Token（GitHub PAT 更换后会自动同步用户名和头像）；OAuth 设备码连接的 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 }}

Workflow 可视化编辑器

Workflow 编辑器内置实时流程图，让 YAML 结构一目了然。点击右上角标签切换三种视图：

流程图元素说明

• 触发器卡片：识别 schedule（⏰，展示 cron 表达式）、workflow_dispatch（🖱️ 手动）、push（📤）、pull_request（🔀）等类型
• Job 容器：显示 Job 名称和 Runner 环境（如 ubuntu-latest）
• 步骤列表：每个 Step 按顺序编号，区分 uses（引用 Action，紫色标签）和 run（执行命令，黄色标签）

新建 Workflow 时的模板选择

点击「➕ 创建新 Workflow...」后，可从以下内置模板快速开始：

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"
    }
  }'

常见问题