EdgeChat 文档

主题

GitHub Actions 自动部署 ​

EdgeChat 的核心部署方式就是 GitHub Actions + Cloudflare Workers。

工作流文件在仓库的 .github/workflows/deploy-worker.yml，推送代码后就能自动完成部署。

必需配置 ​

配置项作用
CLOUDFLARE_API_TOKEN允许 Actions 调用 Cloudflare API，创建、检查并部署资源。
CLOUDFLARE_ACCOUNT_ID指定部署目标账号。
CFCHAT_ADMIN_USERNAME首次部署时自动创建管理员用户名。
CFCHAT_ADMIN_PASSWORD首次部署时自动创建管理员密码。

可选配置 ​

配置项作用
CFCHAT_ADMIN_DISPLAY_NAME管理员显示名称，不填时默认使用用户名。

触发方式 ​

  • 推送到 master 或 main
  • 在 GitHub Actions 页面手动触发 workflow_dispatch

工作流步骤 ​

  1. 拉取代码
  2. 安装依赖
  3. 构建前端
  4. 检查或创建 Cloudflare 资源
  5. 生成 CI 专用 wrangler.ci.toml
  6. 首次创建 D1 时初始化数据库
  7. 可选写入管理员账号
  8. 部署 Worker

推荐权限 ​

CLOUDFLARE_API_TOKEN 至少需要：

  • Workers Scripts:Edit
  • Workers Routes/Cron Triggers:Edit
  • D1:Edit
  • Workers KV Storage:Edit
  • R2:Edit

建议 ​

  • 第一次使用前先确认仓库 Secrets 已填完整
  • 如果已经有现成资源，优先检查资源 ID 和命名空间是否正确
  • 管理员账号建议直接通过 Secrets 管理，不要手工修改数据库