配置分层
区分构建常量、运行时绑定、密钥、站点设置与业务数据。
区分构建常量、运行时绑定、密钥、站点设置与业务数据。
| 配置 | 放在哪里 | 何时生效 |
|---|---|---|
| schema 兼容常量、compatibility date、API 契约 | 放在哪里构建产物 | 何时生效发布后 |
| 数据库连接、域名、存储绑定和实现选择 | 放在哪里Wrangler 或进程环境 | 何时生效重新部署/启动后 |
| 主密钥环和运维令牌 | 放在哪里Workers secrets 或受保护环境 | 何时生效重新部署/启动后 |
| 认证、通知、翻译、网络等站点设置 | 放在哪里加密字段受保护的 system.settings | 何时生效下一次读取,按版本短缓存 |
| 商品、渠道实例、服务器、模板等业务配置 | 放在哪里对应业务表 | 何时生效按业务规则立即生效 |
部署期配置决定“连接哪里”,后台设置决定“如何运营”。不要把支付渠道和邮件提供商密钥加入 vars 或源码。读取密钥字段只显示已设置状态,不能读回明文。
查阅运行时变量与绑定和全部设置域。配置统一放在 apps/api/.env,从 apps/api/.env.example 复制;使用当前变量名,运行模式由 NODE_ENV 决定。