Git 安全与仓库治理
Git 会把提交历史长期保存。敏感信息、大文件、生成物和错误配置一旦进入历史,不是删掉当前文件就结束了。仓库治理的重点是:哪些东西不能进仓库、已经进了怎么处理、如何降低再次发生的概率。
不应提交的内容
常见禁止提交:
.env、本地配置、数据库密码。- 私钥、token、访问密钥,以及含私钥的证书容器。
- 构建产物、缓存、日志。
- 本地 IDE 用户配置;团队共享的格式化和调试配置可按约定提交。
- 大型二进制文件,除非使用 Git LFS。
- 用户数据、生产数据、脱敏不完整的数据样本。
.gitignore
.gitignore 只对未被 Git 跟踪的文件生效。已经提交过的文件,即使后来加入 .gitignore,仍然会被继续跟踪。
示例:
text
# 环境配置
.env
.env.*
!.env.example
# 密钥
*.key
*.pem
secrets/
# 日志和缓存
*.log
.cache/
dist/
build/
node_modules/
# 本机 IDE 状态(团队配置按项目约定保留)
.idea/workspace.xml如果文件已经被跟踪,需要先从索引移除:
bash
git rm --cached .env
git commit -m "chore: 停止跟踪本地环境配置"本地文件会保留,但 Git 不再跟踪。
.pem 可能保存私钥,也可能只包含公开证书,扩展名无法判断敏感性。忽略规则用于减少误提交,不能代替内容检查;公开根证书是否入库由发布与更新策略决定。rm --cached 后文件仍在旧提交中,也可能在其他分支继续被跟踪。
.gitattributes
.gitattributes 用于定义文件属性,例如换行、diff、merge、LFS。
示例:
text
* text=auto
*.sh text eol=lf
*.bat text eol=crlf
*.png binary
*.jpg binary团队跨 Windows、macOS、Linux 开发时,建议明确换行策略,减少无意义 diff。
敏感信息已经提交
处理顺序:
- 立即吊销泄露的密钥或 token。
- 从当前代码删除敏感文件。
- 判断是否需要清理 Git 历史。
- 通知团队重新拉取或重置受影响分支。
删除当前文件:
bash
git rm --cached .env
echo ".env" >> .gitignore
git add .gitignore
git commit -m "chore: 从仓库移除本地环境配置"这不会清理历史中的敏感内容。历史清理会改写提交历史,应在团队确认后执行。
清理历史
历史清理适用于密钥、超大文件、误提交数据集等严重问题。
常见工具:
git filter-repo- BFG Repo-Cleaner
清理应在专用的新 Clone 中进行,先冻结受影响引用的写入、保存原始完整对象标识,再使用工具按明确路径或内容规则重写。例如以下只展示清理一个路径的本地步骤:
bash
git filter-repo --path .env --invert-paths
git log --all -- .env
git fsck --full空日志只说明该路径不在当前引用可见历史中,还要检查重命名前路径、其他文件中的同一凭据及需要保留的标签。构建与依赖验收通过后,核对重写前后每条受影响引用的映射。filter-repo 通常会移除 origin,应在本地验证后再恢复已核实的远端地址。
向远端发布时逐条使用明确租约,例如 git push --force-with-lease=refs/heads/main:<清理前远端完整OID> origin refs/heads/main:refs/heads/main。租约不匹配就停止调查,不能重新读取最新值后盲目覆盖。其他分支和标签分别评估、审批与更新;禁止把全量 --all、--tags 强推当成清理模板。平台隐藏的 MR 引用和缓存可能需要管理员按平台机制处理,单次 Push 不会清除所有副本。
风险:
- 所有协作者需要重新同步本地仓库。
- 旧 clone、fork、CI 缓存里可能仍有泄露内容。
- 密钥必须先吊销,不能只依赖历史清理。
大文件治理
Git 不适合直接存储频繁变化的大二进制文件。
检查仓库大小:
bash
du -sh "$(git rev-parse --git-common-dir)"
git count-objects -vH查找大文件:
bash
git rev-list --objects --all |
git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' |
awk '$1 == "blob"' |
sort -k3 -nr |
head处理方式:
- 图片、设计稿、视频、压缩包使用 Git LFS。
- 构建产物放制品仓库。
- 可再生成文件不进入 Git。
Git LFS
初始化:
bash
git lfs install跟踪文件类型:
bash
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "*.mp4"
git add .gitattributes
git commit -m "chore: 使用 LFS 跟踪大型资源"查看 LFS 文件:
bash
git lfs ls-files
git lfs status注意:已经进入普通 Git 历史的大文件,不会因为新增 LFS 规则自动迁移,需要单独清理或迁移。
凭据管理
HTTPS 远端通常使用个人访问令牌或 OAuth 凭据,SSH 远端使用私钥。无论采用哪种方式,都不应把口令和令牌写进远端 URL、脚本、Shell 历史或仓库配置。
查看凭据助手来源:
bash
git config --show-origin --get-all credential.helper常见选择:
- macOS 使用系统钥匙串,例如
osxkeychain。 - Windows 使用 Git Credential Manager。
- Linux 使用桌面密钥环或组织提供的凭据助手。
- CI 使用平台 Secret 和短期凭据,按环境限制权限。
不建议长期使用 credential.helper store,它会把凭据以明文形式保存在用户目录。令牌应遵循最小权限、短有效期、可吊销和定期轮换原则。
提交与标签签名
签名验证提交或标签的内容与签名一致,并证明签名时有人持有相应私钥,常见格式包括 GPG、SSH 和 X.509。提交中的作者字段仍可任意填写,签名者也可能是机器人;真实身份还需可信公钥映射,授权仍需平台策略。它不能替代代码审查和分支保护。
查看签名:
bash
git log --show-signature
git verify-commit <commit>
git verify-tag <tag>创建签名提交或带说明的签名标签:
bash
git commit -S -m "fix(auth): 拒绝过期令牌"
git tag -s v1.4.0 -m "发布 v1.4.0"组织需要同时维护可信公钥来源、密钥吊销流程、机器人签名规则和托管平台的 Verified 状态。签名验证成功只说明加密身份匹配,发布授权仍由组织策略决定。
备份与灾难恢复
Reflog 只记录当前 Clone 的本地引用移动,不是备份。可靠恢复应同时保护远端引用、标签、LFS 对象、发布制品和运行配置。
创建可离线传输的 Git Bundle:
bash
git bundle create repository-backup.bundle --all
git bundle verify repository-backup.bundle
git clone repository-backup.bundle recovered-repositoryBundle 保护所选引用可达的 Git 对象,不包含未提交工作区、独立 LFS 正文、子模块仓库、平台 Issue/MR、CI Secret 或运行数据库。恢复订单项目时,先恢复 Git 快照,再取对应 LFS 与依赖制品,重建配置并执行构建;仅能 git log 不算业务恢复成功。
也可以维护独立镜像:
bash
git clone --mirror <repository-url> repository.git
git -C repository.git remote update --prune镜像会同步删除远端已经删除的引用,因此不能作为唯一的时间点备份。备份需要版本保留、异地副本和定期恢复演练。
发现对象损坏时:
- 停止在原仓库继续提交、维护或清理。
- 复制整个仓库和
.git/保存现场。 - 运行
git fsck --full记录缺失或损坏对象。 - 从可靠远端、其他完整 Clone 或时间点备份确认对象来源。
- 在副本中恢复并重新运行完整性检查与业务构建。
Partial Clone、Shallow Clone 和未下载完整 LFS 对象的工作区不能直接当作完整备份。对象存储和完整性检查详见 对象库与大型仓库。
权限与保护
托管平台上建议配置:
- 主分支保护。
- 必须通过 PR/MR 合并。
- 必须通过 CI。
- 至少一名审查者批准。
- 禁止直接 push 到主分支。
- 限制谁能创建 tag 和发布版本。
Git 本身负责版本历史,平台负责权限和流程治理。
排查清单
git status --ignored查看忽略规则是否生效。git check-ignore -v <file>查看某文件被哪条规则忽略。git ls-files <file>判断文件是否已被跟踪。git log --all -- <file>查看文件历史。- 发现密钥泄露后先吊销,再清理历史。
git log --show-signature检查关键提交和发布标签的签名状态。git fsck --full检查对象与引用完整性。- 定期验证 Bundle、镜像和 LFS 备份能否真实恢复。
