成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Vercel 环境变量 Config/Secret 配置简报

按 Environment 作用域、Config 可读 vs Secret 写后不可读、变更仅作用于新部署与轮换步骤,整理多环境变量配置简报;不代改生产密钥。

场景说明

面向独立开发者与轻量企业:把「Preview/Production 密钥别串台」写成可对账步骤,区别于仅看部署日志。

案例叙事

01他们做了什么

独立站或小团队常在 Preview 误用生产支付密钥,或改完环境变量却仍看到旧值——因为只看了当前部署,没触发新部署。

Vercel Docs《Environment variables》说明:环境变量是配置在源码之外的键值对,使同一键可随 Environment 变化;这些值在静态存储时加密。添加时可选择 Config 或 Secret:Config 对具有项目访问权限的成员保持可读;Secret 保存后为写后不可读(write-only)。需要替换 API key/token 等凭据时,应遵循轮换环境变量步骤,以便在不停机的前提下更新。源码可在 Build Step 或 Function 执行期读取这些值以改变行为。对变量的任何变更不会应用到既有部署,只作用于新部署。文档还覆盖创建变量、大小限制、Preview/Development/Integration 变量、跨环境管理、保留名、轮换、共享变量与系统环境变量等子题。本场景据此输出多环境配置简报。禁止声称「生产密钥已轮换完毕」。

02实际效果

  • 源未披露量化「串台事故平均修复时长」;公开文只描述 Environment、Config/Secret、加密与「仅新部署生效」。
  • 能把「改了没 redeploy / Preview 误挂生产密钥 / Secret 无法回读」拆开处理。
  • 为企业自动化与独立项目提供可复用的密钥治理提问清单。

03值得知道

  • 系统/保留环境变量名与限额以当前文档为准,勿覆盖保留键。
  • 有项目读权限者仍可能读到 Config;敏感值应优先 Secret 并最小授权。
  • 上面写的是文档机制,不是你项目变量的实时清单。

04可复制提示词

Vercel 环境变量配置简报

你是 Vercel 环境变量助手。只给配置核对简报,不要编造已写入成功。

变量用途:{{var_purpose}}
目标 Environment:{{environments}}
拟用 Config 或 Secret:{{config_or_secret}}
症状/现状:{{symptom}}

输出 Markdown:
1. 该键应落在哪些 Environment
2. Config vs Secret 选择提问
3. 变更后为何必须新部署
4. 轮换步骤提问(不要索要真实密钥值)
禁止代写生产 Secret;禁止回显用户粘贴的密钥全文。

Preview 串台复盘提纲

Preview 或 Development 疑似用到生产凭据,请写复盘提纲。

时间线:{{timeline}}
涉及键名(勿给值):{{key_names}}
部署类型:{{deployment_kind}}

输出:
1. 作用域是否勾错
2. 是否未 redeploy 导致旧值
3. 临时缓解(撤密钥、限制访问)
4. 防再发(命名约定、Secret、评审)
不要伪造「已全部轮换」。

05一手来源

怎么做

  1. 粘贴变量用途(构建期/运行期)、目标 Environment、现为 Config 还是 Secret,以及串台或缺失症状
  2. Agent 按官方说明输出:键值在源码外按 Environment 变化→Config/Secret 差异→改完须新部署→轮换提问清单
  3. 人工在 Dashboard/CLI 变更并 redeploy;Agent 不代写入生产 Secret

实用提示

  • 值在静态存储侧加密;Config 对有项目权限成员仍可读,Secret 保存后写后不可再读,轮换须走官方 rotating 流程
  • 与 vercel-deploy-log-digest 不同:本条管变量作用域与密钥形态,不是部署日志摘要
#Vercel#环境变量#Secret#Preview#独立开发者