用途:把 Doppler 作为工作区统一的密钥来源,所有需要环境变量的 package.json 脚本用 doppler run -c <config> -- 包裹,部署时再同步到 Cloudflare Workers、Fly、GitHub Actions,而非提交 .env 文件。
主要能力与用法:
- 环境约定:项目统一使用 development、preview、production 三个 env slug;新建项目后必须把默认的 dev/stg/prd 重命名,并同步重命名各环境下的根 config,否则 doppler run -c development 会失效。
- 非交互认证:代理或脚本中跳过 doppler login,可用 DOPPLER_TOKEN 环境变量、doppler configure set token="..." --scope=/ 或命令内 --token;令牌分个人令牌、服务账号令牌、服务令牌三类。组织机构/工作区不能在 CLI 创建,需先在仪表板注册。
- 密钥操作:doppler secrets set/upload/get/download 增删查导;secrets set 会静默覆盖已有键。
- 运行注入:doppler run -c CONFIG -- COMMAND;shell 环境变量必须放在 doppler run 之前。
- 部署同步:Cloudflare 用 doppler run --mount 写临时文件再 wrangler secret bulk;Fly 用 doppler secrets download --no-file --format env | flyctl secrets import。
- CI:在 GitHub Actions 作业级设置 DOPPLER_TOKEN(建议服务账号令牌),用 dopplerhq/cli-action 安装二进制,认证靠该环境变量。
限制与注意:命令帮助输出是权威来源,应先完整阅读;env 重命名不会同步重命名子 config;Fly 导入会触发重启,单机应用约 30 秒停机,可用 --stage 暂存;wrangler secret put 逐个交互会挂起,应改用 bulk 加 --mount。
文档:https://docs.doppler.com/docs/cli