Cloudflare Workers 部署
该形态下:Proxy 与 Admin 各为一个 Worker 项目,共享同一 D1(绑定名在仓库中一般为 DB)。适合希望利用 边缘网络、减少自有主机运维的团队。
- Cloudflare 账号与
wrangler登录(或 API Token)。 - 已 Fork/克隆 octafuse-gateway 且本地
npm install可通过。
推荐操作顺序
Section titled “推荐操作顺序”- 创建 D1:在控制台或
wrangler d1 create创建数据库,复制 Database ID。 - 写入配置:将仓库内 三处 Wrangler 相关文件中的
database_id全部替换为真实 UUID(占位符会导致部署失败)。 - 安装依赖并迁移远程库:仓库根执行
npm install与npm run db:migrate:remote(或 CI 等价物)。 - 部署 Proxy:在
packages/proxy执行wrangler deploy(或 Connect to Git 指定 Root directory)。 - 部署 Admin:在
packages/admin执行npm run build:cf后wrangler deploy。 - 配置 Secret:
ADMIN_PASSWORD等敏感项使用wrangler secret put,勿提交到 Git。 - 绑定域名:为 Proxy、Admin 分别绑定 HTTPS 域名,与
GATEWAY_URL/GATEWAY_MASTER_URL对齐。 - 验收:
GET /health、登录 Admin、用测试 Key 走一条聊天请求(参见 快速开始)。
与 Docker 自建如何选
Section titled “与 Docker 自建如何选”- 更强 数据驻留与内网 控制 → Docker 部署。
- 更强 边缘与托管数据库 诉求 → 本页路径。