technical

Staging 环境变量与 Cloudflare 绑定

固定 Toolplane 当前 staging 的环境变量基线、D1 / 双 R2 / Worker 绑定,以及 local 与 staging 的真实差异。

Audience

开发者 / 部署维护

Updated

2026-03-30

Source

docs/staging-bindings.zh-CN.md

当前结论

  • 公开 staging 主机仍是 toolplane.fluentreact.com
  • 发布 proof 继续只认 WSL2-first 路径
  • wrangler.jsonc 现在已经固定 D1 / 双 R2 / Worker / Assets / Images 绑定
  • local 与 staging 的差异现已写成单独真相页

当前绑定

  • PLATFORM_DB -> toolplane-ai-staging
  • NEXT_INC_CACHE_R2_BUCKET -> toolplane-ai-opennext-cache
  • EVIDENCE_R2_BUCKET -> toolplane-ai-private
  • WORKER_SELF_REFERENCE -> toolplane-ai
  • ASSETS -> .open-next/assets
  • IMAGES 已启用,workers_dev 仍保持开启

当前变量分层

  • .env.example 现在记录 host baseline、Cloudflare 占位与 AUTOFILL_AI 基线
  • .dev.vars 当前只保留 NEXTJS_ENV 这一条安全 Worker 基线
  • remote D1 脚本真实依赖 CLOUDFLARE_ACCOUNT_ID 与 CLOUDFLARE_API_TOKEN
  • AUTOFILL_AI_* 与 TOOLPLANE_ENABLE_*_LOCAL_FALLBACK 现在都是代码里的真实消费项

local 与 staging 的差异

  • 本机通常走 127.0.0.1:3000;若端口陈旧可改走 127.0.0.1:3200
  • staging 固定走 https://toolplane.fluentreact.com
  • 本机 local D1 走 .wrangler/state/v3/d1,staging remote D1 走 PLATFORM_DB 与远端校验脚本
  • 本机只有显式打开 TOOLPLANE_ENABLE_*_LOCAL_FALLBACK 时才允许回退到文件存储