Git 泄漏预防
目的
防止敏感文件、密钥和构建产物被推送到 GitHub。扫描、检测并自动修复 .gitignore。
指令
第 1 步 — 扫描敏感文件
运行此命令查找不应出现在 GitHub 上的文件:
git ls-files | findstr /i ".env .env.local .env.production .env.staging node_modules dist build releases *.key *.pem *.p12 secrets"
在 PowerShell 上:
git ls-files | Select-String -Pattern "\.env|node_modules|dist|build|releases|\.key$|\.pem$|\.p12$|secrets|\.log$|\.cache$"
同时检查未跟踪的敏感文件:
git status --porcelain
第 2 步 — 检查常见敏感模式
在已跟踪文件中查找以下模式:
| 模式 | 风险 | 操作 |
|---|---|---|
.env / .env.* | API 密钥、数据库密码 | 从 git 中删除 + 添加到 .gitignore |
node_modules/ | 依赖项(庞大,不需要) | 删除 + .gitignore |
dist/ / build/ | 编译输出 | 删除 + .gitignore |
releases/ | 二进制发布包 | 删除 + .gitignore |
*.key / *.pem | 私钥 | 删除 + .gitignore |
*.p12 / *.pfx | 证书 | 删除 + .gitignore |
.DS_Store | macOS 元数据 | .gitignore |
Thumbs.db | Windows 元数据 | .gitignore |
*.log | 日志文件 | .gitignore |
.cache/ | 缓存文件夹 | .gitignore |
coverage/ | 测试覆盖率 | .gitignore |
.turbo/ / .next/ | 构建缓存 | .gitignore |
*.sql | 数据库转储(有时含密钥) | 检查内容 |
第 3 步 — 检查代码中的密钥
在已跟踪文件中搜索硬编码的密钥:
rg -i "(api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*['\x22]" --type-add 'code:*.{ts,tsx,js,jsx,json,yaml,yml,env,config}' -t code
查找类似这样的模式:
API_KEY=sk-...SECRET=...PASSWORD=...PRIVATE_KEY-----BEGINtoken: "eyJ..."
第 4 步 — 自动修复 .gitignore
如果发现敏感文件,自动更新 .gitignore:
# 检查当前 .gitignore
cat .gitignore
添加缺失的条目。Web 项目标准的 .gitignore:
# 环境文件
.env
.env.local
.env.production
.env.staging
.env.development
# 依赖项
node_modules/
# 构建输出
dist/
build/
release/
releases/
# 密钥
*.key
*.pem
*.p12
*.pfx
# IDE
.vscode/settings.json
.idea/
# 操作系统
.DS_Store
Thumbs.db
# 日志
*.log
npm-debug.log*
# 缓存
.cache/
.turbo/
.next/
.nuxt/
# 覆盖率
coverage/
# 其他
*.swp
*.swo
第 5 步 — 从 Git 跟踪中删除敏感文件(如果已被跟踪)
如果敏感文件已被跟踪:
# 从跟踪中删除但保留本地
git rm --cached .env
git rm --cached -r node_modules/
git rm --cached -r dist/
git rm --cached -r build/
# 然后添加到 .gitignore
警告: 如果密钥已被推送到 GitHub,它们已经泄露。用户应:
- 立即轮换所有暴露的密钥/凭证
- 绝不重复使用相同的密钥
第 6 步 — 向用户展示报告
清晰呈现发现结果:
🔍 安全检查报告
风险文件:
❌ .env — 已被跟踪(包含密钥)
❌ node_modules/ — 已被跟踪(应被忽略)
⚠️ dist/ — 已被跟踪(构建输出)
已采取措施:
✅ .env 已添加到 .gitignore
✅ node_modules/ 已添加到 .gitignore
✅ dist/ 已添加到 .gitignore
✅ .env 已从 git 跟踪中删除(本地保留)
⚠️ 如果 .env 包含真实密钥,请立即轮换它们。
GitHub 历史记录中仍保留旧版本。
第 7 步 — 提交修复
git add .gitignore
git commit -m "chore(security): update gitignore to prevent secret leaks"
禁止操作
- ❌ 绝不能在实际报告中显示密钥值(应掩码:
sk-****...****) - ❌ 绝不能提交 .env 或密钥,即使是“临时”原因
- ❌ 如果密钥已被推送,绝不能忽略警告
- ❌ 绝不能跳过检查
git ls-files— 未跟踪文件没问题,已跟踪文件才是风险
预期输出
一份清晰的安全报告,显示:
- 发现的风险内容
- 自动修复的内容
- 用户需要手动完成的操作(轮换密钥)