指南
部署到生产环境
如何将应用构建并部署到 Cloudflare Workers。
当应用准备就绪后,你可以用一条命令完成部署。
构建
创建优化后的生产构建:
pnpm build
CF 将构建产物写入 .cloudflare/output/v0/。默认 Worker 的代码和静态资源分别位于其中的 workers/default/bundle/ 和 workers/default/assets/。构建流程使用 Cloudflare Vite 插件,因此产物可以直接用于 Workers。
部署到 Cloudflare
如果使用模板内置的 CF 配置:
pnpm run deploy
这会执行 cf deploy,完成构建和部署。请在 cloudflare.config.ts 中配置你的账号和绑定,并用 pnpm sync-worker-secrets 设置所需环境变量或密钥。
首次创建 Worker 时,把初始密钥一起部署:
pnpm run deploy --secrets-file .env.production
请勿把该文件提交到 Git。后续可用 pnpm sync-worker-secrets 更新已有 Worker 的密钥。
检查 Worker Bundle 大小
Cloudflare Workers 免费和付费计划现在都允许最多 64 MiB 的未压缩 Worker Bundle。压缩大小不再受限,CF 输出中的 gzip 大小仅供参考。
部署前可以检查 Bundle:
pnpm exec cf deploy --dry-run
输出中的 Total Upload 是计入 64 MiB 限制的未压缩大小。最新规则请参考
Cloudflare 的 Worker 大小限制。

祝你顺利发布。