跳过主要内容
全部文章
指南

部署到生产环境

如何将应用构建并部署到 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 大小限制。

img

祝你顺利发布。