DEPLOY / 02

几步部署到 Cloudflare

三个版本都是独立 Worker 单文件,不需要编译;敏感信息请写入 Secrets,不要提交到仓库。

01 / 选择实现

Lite/worker.js

只需要单一 OpenAI 兼容上游、Key 校验与月度配额时选择。

CN/worker.js 或 EN/worker.js

需要注册、管理后台、双上游和知识库时选择;两者业务逻辑一致,注释语言不同。

02 / 准备资源与绑定

Lite

创建 Cloudflare Worker + KV Namespace,并以 USER_KEYS_KV 作为绑定名。

完整版本

除 USER_KEYS_KV 外,还需 D1 数据库绑定 KNOWLEDGE_D1。建表 SQL:CREATE TABLE IF NOT EXISTS knowledge (id TEXT PRIMARY KEY, name TEXT, text TEXT NOT NULL);

03 / 设置变量

共同核心

UPSTREAM_BASE_URL、UPSTREAM_MODEL_ID、REAL_API_KEY(Secret);可设置 REQUIRED_MODEL_NAME、QUOTA_PER_USER_PER_MONTH(默认 999)。

完整版本追加

ADMIN_PASSWORD(Secret);可设置 ADMIN_USERNAME、LIMIT_PER_IP_PER_MONTH、DAILY_LIMIT 及第二上游、检索上游相关变量。

04 / 测试与访问

代理请求

对 Worker 的 /v1/chat/completions 发送 JSON POST,Authorization 使用 Bearer <用户邮箱>,model 使用配置的对外模型名。

完整版本激活流程

必须另行部署邮件验证 Worker,由该 Worker 消费 pending:<email> 并写入 userkey:<email>,否则注册不会完成。

Lite 创建用户

在 KV 创建 userkey:<email> 对应的 active 用户记录;Lite 本身没有注册页面。

内容依据 cfRelay 主分支 README 整理。涉及部署时,请以源代码为最终依据。查看完整 README ↗