文档中心

部署文档

自托管部署到 Cloudflare Workers 的环境、配置与流程。

环境准备

  • Node.js 20 及以上与 npm。
  • Cloudflare 账号，并开通 Workers 与 D1。
  • 已安装并登录 wrangler CLI。
  • 一个用于访问的域名（可选）。

部署到 Cloudflare Workers

项目基于 Next.js，通过 OpenNext 适配后部署到 Workers。

  • 安装依赖并完成本地构建校验。
  • 用 OpenNext 生成 Workers 产物。
  • 使用 wrangler 发布。
  • 首次发布后按提示绑定自定义域名。
npx --yes opennextjs-cloudflare build
npx --yes wrangler deploy

环境变量

在 wrangler 配置或控制台中设置以下变量。

变量说明
JWT_SECRET登录令牌签名密钥，请使用强随机值。
ADMIN_EMAIL初始管理员邮箱。
ADMIN_PASSWORD初始管理员密码，首次登录后请尽快修改。
LLM_BASE_URL默认大模型接口地址（可选）。
DBD1 数据库绑定名称。

初始化与迁移

首次部署需创建 D1 数据库并执行建表脚本。

wrangler d1 create ezp-db
wrangler d1 execute ezp-db --file=./schema.sql
npx --yes wrangler deploy
提示：结构变更后重新执行建表脚本即可完成迁移；生产数据请先备份。

发布流程

  • 本地完成类型检查与单元测试。
  • 执行构建并本地预览，确认页面正常。
  • 发布到 Cloudflare 并在浏览器中回归验证。
建议在正式发布前，先在预览环境验证关键路径。