Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

从存储库中删除敏感数据

如果将敏感数据(例如密码或 SSH 密钥)提交到 Git 仓库,您可以将其从历史记录中删除。 要从存储库的历史记录中彻底删除不需要的文件,可以使用 git filter-repo 工具或 BFG Repo-Cleaner 开放源代码工具。

git filter-repo 工具和 BFG Repo-Cleaner 将重写存储库的历史记录,这将更改你更改的现有提交的 SHA,以及任何相关的提交。 更改的提交 SHA 可能会影响存储库中未完结的拉取请求。 我们建议在从存储库中删除文件之前合并或关闭所有未完结的拉取请求。

可以使用 git rm 从最新提交中删除文件。 有关删除在最新提交中添加的文件的信息,请参阅“关于 GitHub 上的大型文件。”

警告:本文说明如何使用无法从 GitHub.com 上存储库中的任何分支或标记访问的敏感数据进行提交。 但是,这些提交在你存储库的任何克隆或分支中、直接通过 GitHub 上缓存视图中其 SHA-1 哈希以及通过引用它们的任何拉取请求可能仍然可访问。 无法从存储库的其他用户的克隆删除敏感数据,但可以通过联系 GitHub Support,永久删除 GitHub 上拉取请求中敏感数据的缓存视图和引用。

如果引入敏感数据的提交存在于存储库的任何分支中,它将继续可供访问,除非分支所有者从其分支中删除敏感数据或完全删除分支。

将提交推送到 GitHub 后,应将提交中的所有敏感数据视为泄露。 如果已提交密码,应更改密码。 如果已提交密钥,请生成一个新密钥。 删除泄露的数据并不能解决其初始暴露问题,尤其是在仓库的现有克隆或复刻中。

在重写仓库历史记录的决定中考虑这些限制。

从仓库的历史记录中清除文件

你可以使用 git filter-repo 工具或 BFG Repo-Cleaner 开源工具从存储库的历史记录中清除文件。

使用 BFG

BFG Repo-Cleaner 是由开源社区生成和维护的工具。 它提供了一种可替代 git filter-branch 的更快、更简单的方法,用于删除不需要的数据。

例如,要删除包含敏感数据的文件并保持最新提交不变,请运行:

$ bfg --delete-files YOUR-FILE-WITH-SENSITIVE-DATA

要替换可以在存储库的历史记录中找到的 passwords.txt 列出的所有文本,请运行:

$ bfg --replace-text passwords.txt

删除敏感数据后,必须强制将更改推送到 GitHub。 强制推送会重写存储库历史记录,这会从提交历史记录中删除敏感数据。 如果强制推送,它可能会覆盖其他人基于其工作的提交。

$ git push --force

有关完整的使用情况和下载说明,请参阅 BFG Repo-Cleaner 的文档。

使用 git filter-repo

警告: 如果在储藏更改之后运行 git filter-repo,则无法使用其他储藏命令检索更改。 在运行 git filter-repo 之前,建议取消储藏所做的任何更改。 要取消储藏你已储藏的最后一组更改,请运行 git stash show -p | git apply -R。 有关详细信息,请参阅 Git 工具 - 储藏和清理

为了说明 git filter-repo 的工作原理,我们将向你展示如何从存储库的历史记录中删除包含敏感数据的文件,并将其添加到 .gitignore,以确保不会意外地重新提交。

  1. 安装 git filter-repo 工具的最新版本。 可以手动安装 git-filter-repo,也可以使用包管理器安装。 例如,若使用 HomeBrew 安装工具,请使用 brew install 命令。

    brew install git-filter-repo
    

    有关详细信息,请参阅 newren/git-filter-repo 存储库中的 INSTALL.md

  2. 如果存储库的本地副本的历史记录中没有敏感数据,请将存储库克隆到本地计算机

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
    > Initialized empty Git repository in /Users/YOUR-FILE-PATH/YOUR-REPOSITORY/.git/
    > remote: Counting objects: 1301, done.
    > remote: Compressing objects: 100% (769/769), done.
    > remote: Total 1301 (delta 724), reused 910 (delta 522)
    > Receiving objects: 100% (1301/1301), 164.39 KiB, done.
    > Resolving deltas: 100% (724/724), done.
  3. 导航到存储库的工作目录。

    $ cd YOUR-REPOSITORY
  4. 运行以下命令,将 PATH-TO-YOUR-FILE-WITH-SENSITIVE-DATA 替换为要删除的文件的路径,而不只是其文件名。 这些参数将:

    • 强制 Git 处理(而不是签出)每个分支和标记的整个历史记录
    • 删除指定的文件,以及作为结果生成的任何空提交
    • 删除存储在 .git/config 文件中的某些配置,例如远程 URL。 你可能需要提前备份此文件,以便稍后还原。
    • 覆盖现有标记
      $ git filter-repo --invert-paths --path PATH-TO-YOUR-FILE-WITH-SENSITIVE-DATA
        Parsed 197 commits
        New history written in 0.11 seconds; now repacking/cleaning...
        Repacking your repo and cleaning out old unneeded objects
        Enumerating objects: 210, done.
        Counting objects: 100% (210/210), done.
        Delta compression using up to 12 threads
        Compressing objects: 100% (127/127), done.
        Writing objects: 100% (210/210), done.
        Building bitmaps: 100% (48/48), done.
        Total 210 (delta 98), reused 144 (delta 75), pack-reused 0
        Completely finished after 0.64 seconds.

    注意: 如果包含敏感数据的文件以前存在于任何其他路径(因为它被移动或重命名),则也必须在这些路径上运行此命令。

  5. 将包含敏感数据的文件添加到 .gitignore,以确保不会意外地再次提交。

    $ echo "YOUR-FILE-WITH-SENSITIVE-DATA" >> .gitignore
    $ git add .gitignore
    $ git commit -m "Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore"
    > [main 051452f] Add YOUR-FILE-WITH-SENSITIVE-DATA to .gitignore
    >  1 files changed, 1 insertions(+), 0 deletions(-)
  6. 仔细检查是否已从存储库的历史记录中删除了所需的所有内容,并且已签出所有分支。

  7. 对存储库的状态感到满意后,请强制推送本地更改以覆盖 GitHub.com 上的存储库,以及已向上推送的所有分支。 需要强制推送才能从提交历史记录中删除敏感数据。

    $ git push origin --force --all
    > Counting objects: 1074, done.
    > Delta compression using 2 threads.
    > Compressing objects: 100% (677/677), done.
    > Writing objects: 100% (1058/1058), 148.85 KiB, done.
    > Total 1058 (delta 590), reused 602 (delta 378)
    > To https://github.com/YOUR-USERNAME.YOUR-REPOSITORY.git
    >  + 48dc599...051452f main -> main (forced update)
  8. 要从标记版本删除敏感文件,还需要针对 Git 标记强制推送:

    $ git push origin --force --tags
    > Counting objects: 321, done.
    > Delta compression using up to 8 threads.
    > Compressing objects: 100% (166/166), done.
    > Writing objects: 100% (321/321), 331.74 KiB | 0 bytes/s, done.
    > Total 321 (delta 124), reused 269 (delta 108)
    > To https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git
    >  + 48dc599...051452f main -> main (forced update)

完全从 GitHub 中删除数据

在使用 BFG 工具或 git filter-repo 删除敏感数据并将更改推送到 GitHub 后,你必须再采取一些步骤,以完全从 GitHub 中删除数据。

  1. 联系 GitHub Support,请求他们删除 GitHub 上拉取请求中敏感数据的缓存视图和引用。 请提供存储库的名称和/或指向需要删除的提交的链接。

  2. 告知协作者对根据旧式(受损)存储库历史记录创建的所有分支进行变基,而不是合并。 一次合并提交可能会重新引入您刚刚遇到清除问题的部分或全部污染的历史记录。

  3. 经过一段时间并且确信 BFG 工具 / git filter-repo 没有任何意外的副作用后,你可以通过以下命令(使用 Git 1.8.5 或更新版本)强制取消引用本地存储库中的所有对象并进行垃圾回收:

    $ git for-each-ref --format="delete %(refname)" refs/original | git update-ref --stdin
    $ git reflog expire --expire=now --all
    $ git gc --prune=now
    > Counting objects: 2437, done.
    > Delta compression using up to 4 threads.
    > Compressing objects: 100% (1378/1378), done.
    > Writing objects: 100% (2437/2437), done.
    > Total 2437 (delta 1461), reused 1802 (delta 1048)

    注意: 你也可以通过以下方法实现此目的:将筛选的历史记录推送到新的或空的存储库,然后从 GitHub 进行全新克隆。

避免将来的意外提交

有一些简单的技巧可避免提交您不想要提交的内容:

  • 使用 GitHub Desktopgitk 等可视化程序提交更改。 可视程序通常可以更容易地查看每次提交时将添加、删除和修改具体哪些文件。
  • 避免在命令行中使用笼统的命令 git add .git commit -a,而是使用 git add filenamegit rm filename 来单独暂存文件。
  • 使用 git add --interactive 单独查看和暂存每个文件中的更改。
  • 使用 git diff --cached 查看为提交暂存的更改。 如果不使用 -a 标志,这就是 git commit 将产生的确切差异。

延伸阅读