CronHub

快速开始

CronHub 是一个运行在 Cloudflare Workers 上的定时任务管理平台，支持 GitHub Actions、Azure DevOps Pipelines、Google Apps Script 和 HTTP Webhook 四种触发方式。

概览页

登录后默认进入概览页，提供平台整体运行状态的一览视图。

统计卡片

最近执行记录

展示最近 8 条执行记录，包含任务名称、状态、开始时间和耗时。点击右上角「↻ 刷新」可手动刷新数据。

定时任务

每个任务包含以下字段：

任务操作

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

失败重试

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

重试记录会在「执行历史」中独立显示，标注「重试 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...」后，可从以下内置模板快速开始：

Azure DevOps Pipelines 任务

通过 Azure DevOps REST API 触发指定 Pipeline 运行，支持传入变量覆盖默认值。

前置条件

1. 在「平台连接」中添加类型为 Azure DevOps 的连接，填写 Organization 名称和 Personal Access Token
2. PAT 需具备 Build（读写） 权限，若需触发 Release Pipeline 还需 Release（读写）

配置字段

Pipeline 可视化预览

选择 Pipeline 后，点击右侧 👁️ 按钮可加载 YAML 文件并以流程图方式展示 Stage → Job → Step 结构，支持多 Stage 依赖关系可视化。

触发示例（API）

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": "azure_devops",
    "platform_connection_id": "<connection-id>",
    "config": {
      "project": "MyProject",
      "pipeline_id": 42,
      "ref": "main",
      "variables": { "ENV": "production" }
    }
  }'

Google Apps Script 任务

通过 Google Apps Script Execution API 定时调用脚本中的指定函数，适合操作 Google Workspace（Sheets、Drive、Gmail 等）的自动化场景。

前置条件

1. 在 Google Cloud Console 启用 Apps Script API
2. 打开脚本编辑器，点击「部署 → 新建部署 → 类型选 API 可执行文件」并发布
3. 获取含 https://www.googleapis.com/auth/script.execute scope 的 OAuth2 Access Token
4. 在「平台连接」中添加类型为 Google Apps Script 的连接，Token 填入上一步获取的 Access Token

配置字段

脚本函数示例

// 脚本中的顶层函数（需部署为 API 可执行文件）
function syncSheetData(env, limit) {
  const sheet = SpreadsheetApp.openById('your-sheet-id').getActiveSheet()
  // 执行数据同步逻辑...
  Logger.log('同步完成，环境：' + env + '，条数：' + limit)
}

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

常见问题