CF-Cron - Cloudflare Worker 定时任务管理系统#

前端技术栈#

• React + TypeScript：构建现代化、类型安全的前端应用
• Vite：快速的前端构建工具
• Ant Design：提供丰富的 UI 组件
• React Router：管理前端路由
• Fetch API：处理 HTTP 客户端请求

后端技术栈#

• Cloudflare Workers：无服务器计算平台
• Hono Web 框架：轻量高效的 API 框架
• Cloudflare D1 数据库：SQLite 兼容的边缘数据库
• JWT 认证：安全的用户身份验证
• Cron 表达式解析：精确调度定时任务

1. 环境准备#

• Node.js 20+ 运行环境
• npm 或 yarn 包管理工具
• Cloudflare 账户
• Wrangler CLI 工具（npm install -g wrangler）

2. 依赖安装#

1
cd client
2
npm install

1
cd server
2
npm install

3. 本地开发#

1
cd server
2
npm run dev -- --test-scheduled

1
cd client
2
npm run dev

4. Cloudflare 部署#

1
name = "cf-cron"
2
main = "index.ts"
3
compatibility_date = "2025-12-08"
4

5
d1_databases = [
6
  {
7
    binding = "DB",
8
    database_name = "cf-cron-db",
9
    database_id = ""  # 填写 Cloudflare 控制台中的数据库 ID
10
  }
11
]
12

13
[vars]
14
JWT_SECRET = ""  # 配置安全的 JWT 密钥
15

16
[triggers]
17
crons = ["* * * * *"]  # 每分钟检查一次任务

1
cd server
2
npm run db:migrate

1
cd server
2
npm run deploy

1
VITE_SERVER_URL=https://YOUR_WORKER_NAME.YOUR_ACCOUNT.workers.dev/api

1
cd client
2
npm run build

用户表 (users)#

• id: 用户唯一标识
• username: 用户名（唯一）
• password: 密码哈希值
• salt: 密码加密盐值
• email: 邮箱地址（唯一）
• is_admin: 是否为管理员
• status: 用户状态（启用/禁用）
• created: 创建时间
• updated: 更新时间

任务表 (tasks)#

• id: 任务唯一标识
• name: 任务名称
• level: 任务优先级
• spec: Cron 表达式
• protocol: 执行协议（1=HTTP）
• command: 请求 URL
• http_method: HTTP 请求方法
• timeout: 超时时间（秒）
• retry_times: 失败重试次数
• retry_interval: 重试间隔（秒）
• status: 任务状态（启用/禁用）
• request_headers: HTTP 请求头（JSON 格式）
• request_body: HTTP 请求体
• created: 创建时间
• deleted: 删除时间

1. 登录系统#

访问部署后的前端页面，使用默认账户登录。

2. 任务管理#

3. 用户管理（管理员功能）#

• 查看系统用户列表
• 创建新用户并分配权限
• 编辑现有用户信息
• 禁用或启用用户账户

常用表达式示例#

• * * * * * - 每分钟执行
• 0 * * * * - 每小时执行
• 0 0 * * * - 每天午夜执行
• 0 0 * * 0 - 每周日午夜执行
• 0 0 1 * * - 每月1日午夜执行

任务执行失败#

• 检查任务是否已启用
• 验证 Cron 表达式是否正确
• 确认目标 URL 是否可访问
• 查看任务日志获取详细错误信息

登录问题#

• 确认用户名和密码是否正确
• 检查后端服务是否正常运行
• 查看浏览器控制台的错误信息

部署问题#

• 确认 Wrangler 配置文件中的 crons 触发器已设置
• 检查 Cloudflare Worker 的运行状态
• 验证数据库连接配置是否正确