2026-11-21·6 分钟
Worker 配置:Wrangler 与资源绑定
wrangler.toml 项目配置、D1 / R2 / KV / Email 资源绑定与 Workers 环境变量密钥管理。
wrangler 配置文件与资源绑定#
Cloudflare Workers 部署的核心是 wrangler.toml(或 wrangler.jsonc):声明入口、兼容日期与全部资源绑定。本项目的推荐骨架:
资源创建命令
npx wrangler d1 create saasone-db、npx wrangler r2 bucket create saasone-assets、npx wrangler kv namespace create CACHE —— 创建后把返回的 id 填回 wrangler.toml。tomlwrangler.toml
name = "saasone"
main = ".open-next/worker.js" # OpenNext 构建产物入口
compatibility_date = "2026-01-01"
compatibility_flags = ["nodejs_compat"] # Next.js 必需
# D1 数据库绑定(结构化数据)
[[d1_databases]]
binding = "DB"
database_name = "saasone-db"
database_id = "<d1-database-id>"
# R2 对象存储绑定(大文件资产)
[[r2_buckets]]
binding = "ASSETS"
bucket_name = "saasone-assets"
# KV 绑定(热点缓存)
[[kv_namespaces]]
binding = "CACHE"
id = "<kv-namespace-id>"环境变量与密钥管理#
非敏感配置直接写在 wrangler.toml 的 [vars];密钥类(数据库密码、支付密钥、OAuth Secret)必须用 wrangler secret 注入,绝不入仓:
bash密钥注入与本地模拟
# 生产密钥(加密存储于 Workers 环境)
npx wrangler secret put BETTER_AUTH_SECRET
npx wrangler secret put STRIPE_SECRET_KEY
npx wrangler secret put GOOGLE_CLIENT_SECRET
# 本地 dev 模拟生产绑定与密钥(读 .dev.vars 文件)
npx wrangler devbash构建并部署(OpenNext 适配层)
pnpm add -D @opennextjs/cloudflare wrangler
pnpm cf:build # 构建 Workers 产物
pnpm cf:deploy # 部署上线