API密钥泄露高危自查:vibe-security-skill教你排查NEXT_PUBLIC_等9个环境变量陷阱

原创2026-10-14 10:55:251,879 阅读

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 级别问题,要求立即轮换密钥:

SKILL.md

自查完成后的修复动作清单

发现泄露别慌,按顺序处理:

  1. 立即轮换所有进过 Git 历史或暴露在前端包的密钥
  2. 迁移位置:敏感密钥移到服务端环境变量,客户端只留白名单内的可发布密钥
  3. 补上 .gitignore,并检查 .env.example 是否只剩占位符
  4. 跑一遍 gitleaks detect 确认历史干净
  5. 部署前对照清单再检查一次 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 应用上线前就能多一道真正的安全防线。

登录后查看全文
vibe-security-skill