GitHub Actions 自动部署
工作流位于 .github/workflows/deploy-worker.yml，新版显示名为 00 Deploy Worker（旧名 Deploy Worker）。首次部署操作见快速开始。
运行一次部署
- 在自己的 fork 打开
Actions → 00 Deploy Worker。 - 点击
Run workflow，选择部署分支。 - 正常部署保持
apply_encryption_keyring和rotate_encryption_key未勾选。 - 运行结束后，检查最后的 Worker 地址和部署状态。
推送到 master 或 main 的前后端、测试、共享代码和部署配置变更也会触发部署。仅修改说明文档时，可手动运行。自动更新会在合并发布后主动派发部署。
部署凭据
在 Settings → Secrets and variables → Actions → Secrets 添加：
| Repository Secret | 用途 |
|---|---|
CLOUDFLARE_API_TOKEN | 调用 Cloudflare API，权限设置见令牌教程 |
CLOUDFLARE_ACCOUNT_ID | 目标 Cloudflare 账户 |
EDGECHAT_ADMIN_USERNAME | 首次管理员用户名 |
EDGECHAT_ADMIN_PASSWORD | 首次管理员密码 |
管理员凭据成对填写；已有有效超管的站点更新可省略。初始化只创建不存在的账号，补配与恢复见管理员初始化。
工作流做什么
- 安装依赖、运行测试、构建前端。
- 复用或创建 D1、会话 KV、R2，并生成
wrangler.ci.toml。 - 新库执行完整 schema，旧库应用待执行迁移，再验证结构。
- 按 Secrets 初始化管理员，检查有效超管和加密密钥。
- 部署 Worker；配置了 TURN 时注入对应 Secrets。
这些步骤按顺序执行，失败时可展开对应步骤查看日志。常见配置入口：
| 要调整的内容 | 文档 |
|---|---|
| 消息保留天数、上传限制、站点域名 | 站点配置 |
| 附件、头像、R2 开通 | 附件与存储 |
| 语音中继 Secrets | 语音通话与 TURN |
| 数据库升级、迁移失败 | D1 迁移 |
| 加密密钥轮换或备份 | 加密密钥 |
| 部署后检查 | 安装自检与版本检查 |
资源名称
默认复用同名 cfchat Worker、cfchat-db 数据库和 cfchat-files 存储桶。
会话 KV 默认使用 cfchat-sessions。已有站点使用其他名称时，在 Repository Variables 设置 EDGECHAT_KV_NAMESPACE_TITLE 为原命名空间标题，保持登录会话库一致。
其他工作流
演示站单独使用 deploy-demo.yml，读取 DEMO_CLOUDFLARE_ACCOUNT_ID 和 DEMO_CLOUDFLARE_API_TOKEN，不操作生产数据库。见纯前端 Demo。
Android 工作流与 Worker 独立，构建与签名说明见客户端文档。