快速开始

如果你的目标是“首页看完就能直接部署”，那这一页就是入口。

EdgeChat 推荐直接使用 GitHub Actions 自动部署到 Cloudflare，部署时只需要先配置几个必要的 Secrets。

1. 配置必需项

下面这 4 个配置是自动部署的核心：

配置项	作用	是否必需
CLOUDFLARE_API_TOKEN	让 GitHub Actions 调用 Cloudflare API，完成资源检查和部署。	必需
CLOUDFLARE_ACCOUNT_ID	指定要部署到哪个 Cloudflare 账号。	必需
CFCHAT_ADMIN_USERNAME	首次部署时自动创建的管理员用户名。	必需
CFCHAT_ADMIN_PASSWORD	首次部署时自动创建的管理员密码。	必需

2. 进入自动部署

1. Fork 或克隆仓库到你的 GitHub 账号
2. 到仓库 Settings -> Secrets and variables -> Actions 添加上面 4 个 Secrets
3. 推送到 main 或 master
4. 或者在 Actions 页面手动触发 workflow_dispatch

3. 工作流会自动做什么

• 安装依赖
• 构建前端
• 检查或创建 Cloudflare 资源
• 初始化 D1 数据库
• 写入管理员账号
• 部署 Worker

4. 部署后检查

• 打开首页，确认站点能正常访问
• 用管理员账号登录
• 检查聊天、文件上传和后台页面是否正常

如果你想看更完整的流程说明，可以继续看 GitHub Actions 自动部署。