API密钥泄露高危自查:vibe-security-skill教你排查NEXT_PUBLIC_等9个环境变量陷阱
API密钥泄露高危自查:vibe-security-skill教你排查NEXT_PUBLIC_等9个环境变量陷阱
vibe-security-skill 是一个专门审计 AI 编程应用(vibe-coded apps)的 Agent 安全审计技能,能自动排查 API 密钥泄露、NEXT_PUBLIC_ 等环境变量误用、支付与数据库漏洞等 9 大类高危问题。如果你的项目是借助 AI 助手快速开发的,这篇文章带你用 10 分钟完成一次环境变量与密钥泄露自查,赶在上线前把漏洞堵上。
为什么 AI 写代码特别容易泄露密钥?
AI 助手写功能很快,但有一个反复踩的坑:它分不清"前端能看到的"和"必须藏起来的"。常见翻车现场:
- 把 Stripe 密钥、Supabase
service_role直接写进源码 - 用
NEXT_PUBLIC_前缀暴露敏感变量 - 把
.env文件提交进 Git 历史 - 在 localStorage 里存 token,价格参数直接信任客户端
vibe-security-skill 的核心原则只有一句话:永不信任客户端。任何价格、用户 ID、角色、订阅状态,都必须在服务端校验或执行——只存在于浏览器或请求体里的东西,攻击者说了算。
💡 该原则定义在技能主文件中:SKILL.md
最快安装方法:3 步给项目加上安全审计
方式一:一键安装(推荐)
git clone https://gitcode.com/gh_mirrors/vi/vibe-security-skill
方式二:手动复制到技能目录
把仓库里的 vibe-security/ 文件夹拷贝到项目中,即可让 Claude Code、Codex 等支持 Agent Skills 格式的助手加载它:
# 项目级(只作用于当前项目)
cp -r vibe-security/ .claude/skills/vibe-security/
# 全局级(所有项目生效)
cp -r vibe-security/ ~/.claude/skills/vibe-security/
安装后,直接在对话里输入 /vibe-security(或问一句"帮我检查代码有没有安全问题")就能触发完整安全审计。技能还会在涉及认证、支付、API 密钥的代码场景自动激活。
技能包含 9 个审计维度,按项目实际用到的技术按需加载对应参考文件,规则明细见:SKILL.md
自查 1~4:四个客户端环境变量前缀陷阱
这是全文最核心的部分。以下前缀的变量会在构建时被打进前端 JS 包,等于公开张贴在浏览器里:
| 框架 | 危险前缀 | 泄露方式 |
|---|---|---|
| Next.js | NEXT_PUBLIC_ |
构建时内联进浏览器 JS |
| Vite | VITE_ |
构建时内联进浏览器 JS |
| Expo / React Native | EXPO_PUBLIC_ |
打包进 App 安装包 |
| Create React App | REACT_APP_ |
构建时内联进浏览器 JS |
对照表完整出处:secrets-and-env.md
陷阱 1:NEXT_PUBLIC_ 前缀滥用
只要变量名带 NEXT_PUBLIC_,就会被内联进浏览器代码。判断标准很简单:名字里带 secret、private、service、key 的,一律别用这个前缀。
陷阱 2:VITE_ 前缀同样吃紧
Vite 项目的 import.meta.env.VITE_XXX 同理,构建后全部可见。很多开发者以为"VITE_ 只是本地变量",这是高危误解。
陷阱 3:EXPO_PUBLIC_ 打进 App 包
移动端更隐蔽——EXPO_PUBLIC_ 变量直接烘焙进安装包,反编译即可见。API 密钥请改为走自建后端代理转发,而不是直接发给 App。
陷阱 4:REACT_APP_ 的老坑
老 CRA 项目同理,REACT_APP_ 前缀全部暴露。存量项目建议逐项检查。
哪些能放心放客户端? 白名单很窄:
- Stripe 可发布密钥(
pk_live_*/pk_test_*) - Supabase anon key
- Firebase 客户端配置
- 公开的统计 ID
这些绝不能上客户端:Supabase service_role 密钥(可绕过全部行级安全)、Stripe 私密密钥(sk_live_* / sk_test_*)、任何数据库连接串、第三方 API 私密密钥、JWT 签名密钥、OAuth client secret。
自查 5~7:源码与 Git 仓库中的密钥泄露
陷阱 5:API 密钥硬编码在源码里
最直白的泄露方式。审计时重点搜索常见密钥模式:
sk_live_、sk_test_、AKIA、ghp_、glpat-、xoxb-、Bearer
以及形如 postgresql://user:password@host 的带密码连接串。
陷阱 6:.env 没进 .gitignore
一条命令确认 .env 是否已被 Git 跟踪:
git ls-files | grep .env
只要输出非空,就说明密钥文件已经进了仓库。重点:密钥一旦进过 Git 历史,删文件也没用,必须立即轮换密钥。 可以用 gitleaks detect 扫描历史提交中的泄露密钥。
.gitignore 应至少包含:.env、.env.local、.env.*.local——而且要在第一次提交之前就配置好。
陷阱 7:.env.example 里写真实密钥
示例文件本应只有占位值(XXX_XXX_XXX),不少项目却图省事把真实 key 复制进了 .env.example,同样等于公开。
以上检测技巧的原始清单见:secrets-and-env.md
自查 8~9:部署阶段的环境变量暗坑
陷阱 8:Preview 预览环境用生产真实密钥
CI/CD 的预览部署(Preview)常常谁拿到 URL 就能访问,却复用了生产密钥。正确做法是环境隔离:
| 环境 | 用途 |
|---|---|
| Production | 线上用户,真实密钥 |
| Preview | PR 预览,必须用测试/预发密钥 |
| Development | 本地开发,本地/测试密钥 |
部署前必查项(关闭 debug、禁用 source maps、确认 .git 目录不可访问)详见:deployment.md
陷阱 9:service_role 等特权密钥进了客户端变量
这是最致命的一种:Next.js 项目把 NEXT_PUBLIC_SUPABASE_SERVICE_KEY 写进客户端,service_role 密钥能绕过全部行级安全(RLS),任何人都能从浏览器包里提取它,读写删数据库每一行。正确写法是客户端用 anon key,service_role 只出现在服务端代码中——vibe-security-skill 的示例输出里就把它列为 Critical 级别问题,要求立即轮换密钥:
自查完成后的修复动作清单
发现泄露别慌,按顺序处理:
- 立即轮换所有进过 Git 历史或暴露在前端包的密钥
- 迁移位置:敏感密钥移到服务端环境变量,客户端只留白名单内的可发布密钥
- 补上 .gitignore,并检查
.env.example是否只剩占位符 - 跑一遍
gitleaks detect确认历史干净 - 部署前对照清单再检查一次 debug 模式、source maps 与 CORS 配置
让 Agent 自动巡检:把审计变成习惯
手动自查只能做这一次,而 vibe-security-skill 可以把安全检查自动化:
- 写认证、支付、数据库访问代码时主动加载对应规则文件,从源头避免引入漏洞
- 审计输出按 Critical → High → Medium → Low 分级,关键问题置顶,每个问题给出文件行号、攻击者能做什么、以及修改前后代码对比
- 覆盖 Secrets、Supabase RLS、JWT 校验、限流、Stripe 支付、移动端、LLM 集成、部署配置、SQL 注入共 9 大类
完整的 9 份参考规则文件都在 vibe-security/references/ 目录下,按技术栈分工:
| 参考文件 | 覆盖范围 |
|---|---|
| secrets-and-env.md | API 密钥、环境变量、.gitignore |
| database-security.md | Supabase RLS、Firebase 规则、Convex |
| authentication.md | JWT 校验、中间件、Session |
| payments.md | Stripe、webhook 验签、价格校验 |
| deployment.md | 生产配置、安全头、环境隔离 |
写在最后
环境变量前缀看着只是几个下划线,却决定了密钥是"私藏"还是"公开"。记住这篇文章的 9 个陷阱,配合 vibe-security-skill 的自动审计,你的 vibe-coded 应用上线前就能多一道真正的安全防线。