快速开始
首次部署按下面四步完成。已有站点请看更新指南。新版工作流名为 00 Deploy Worker，旧版显示 Deploy Worker。
1. 准备 Cloudflare
按创建 Cloudflare API 令牌准备 API Token 和账户 ID。需要上传附件时，先在 Cloudflare 开通 R2。
2. Fork 并配置 Secrets
Fork EdgeChat 仓库到自己的 GitHub 账号。
打开 fork 的 Settings → Secrets and variables → Actions → Secrets，点击 New repository secret，添加：
| 名称 | 内容 |
|---|---|
CLOUDFLARE_API_TOKEN | 刚创建的 Cloudflare API Token |
CLOUDFLARE_ACCOUNT_ID | 部署目标账户的 Account ID |
EDGECHAT_ADMIN_USERNAME | 自己设置的首次管理员用户名 |
EDGECHAT_ADMIN_PASSWORD | 自己设置的管理员强密码 |
站点没有默认管理员密码。可选的 EDGECHAT_ADMIN_DISPLAY_NAME 设置管理员显示名，留空时使用用户名。
3. 运行部署
- 打开
Actions，启用 fork 的工作流。 - 选择
00 Deploy Worker → Run workflow。 - 选择默认分支，保持两个加密密钥选项未勾选，确认运行。
- 等待所有步骤成功，在部署日志中找到站点地址。
工作流会运行测试、构建前端、复用或创建资源、初始化或迁移 D1、创建管理员并部署 Worker。首次自动生成加密密钥，后续保留。流程说明见GitHub Actions 自动部署。
4. 登录并检查
- 打开站点，用上面设置的管理员账号登录。
- 进入「注册邀请」，创建用户或生成注册链接。
- 测试两人收发消息；开通 R2 的站点再测试附件上传。
- 在「安装与维护」运行一次自检。
没有开通 R2 也能使用文字聊天；开通后重新运行部署即可启用附件。
接下来
- 站点配置：修改消息自动删除时间等后台没有入口的参数。
- 自动更新：每天同步上游发布并部署。
- Telegram Bridge：连接 Telegram 群聊。
- 管理员初始化与恢复：补配首次账号、手动建号或恢复超管。