Nuxt Starter

部署到 Cloudflare

建正式库、上传一次密钥、发布到自定义域名。

站点名,以及正式环境的 Worker 名、域名和 D1 ID,都在根目录的 site.config.ts。wrangler.jsonc 只给本地用。

第一次发布

npm install -g cf
cf auth login
npx wrangler login                  # cf 和 wrangler 登录不通用
cf d1 create --name 你的库名         # 把返回的 uuid 填进 site.config.ts
npm run db:migrate:production

上传密钥,只需一次:

cp .env.production.example .env.production   # 填好;已被 Git 忽略
npx wrangler secret bulk .env.production --name 你的Worker名   # Worker 还不存在时会问是否先建空 Worker,选 y

NUXT_AUTH_SECRET 新生成:node -e "console.log(require('crypto').randomBytes(32).toString('base64url'))"。也可以在 Cloudflare 后台 Worker → Settings → Variables and Secrets 里逐个填。

npm run deploy:production:check     # 预演,看绑定是否是正式库和正式域名
npm run deploy:production

之后的发布

npm run db:migrate:production   # 有新迁移时
npm run deploy:production

普通发布不带密钥,已上传的会保留(Cloudflare 说明)。修改公开配置并影响预渲染内容时,也需要重新构建发布;新增服务端变量应在依赖它的代码启用前完成配置。

改线上变量

本地 .env 不会同步到线上。服务端运行变量需要单独配置;公开值如果已经写入预渲染 HTML(例如统计 ID、联系邮箱),修改后必须重新构建发布。统计配置的完整流程见GA4 与 Clarity。

npx wrangler secret put 变量名 --name 你的Worker名              # 改一个
npx wrangler secret bulk .env.production --name 你的Worker名    # 改多个
npx wrangler secret delete 变量名 --name 你的Worker名           # 删除
npx wrangler secret list --name 你的Worker名                   # 查看名字

secret bulk 只改文件里出现的变量,其它不动。文件里留空的 KEY= 会把线上值改成空字符串,不改的变量整行删掉。

检查

curl https://你的域名/api/health
curl https://你的域名/api/auth-providers
curl https://你的域名/robots.txt      # Sitemap 一行应是正式域名
curl https://你的域名/sitemap.xml

sitemap 里的地址和日期说明见 robots 与 sitemap。 Google 客户端要登记的地址见 Google 登录。

原理

nuxt build 生成 .output/server/wrangler.json,wrangler 发布读的是它。这份配置不能分环境,所以 scripts/use-production-config.ts 在构建后把 Worker 名、域名、D1 和线上地址改成正式值。

/docs 预渲染成静态 HTML,Markdown 不会上线。静态资源请求免费、不计入 Worker 调用(Cloudflare 说明,2026-10-20)。