如何用git filter-repo改写含git LFS的Gitlab仓库历史并处理存储问题？

一、Git LFS存储是否需要重复购买？ #

不需要重复购买额外存储，原因如下：

• GitLab的LFS对象是基于SHA-256哈希值全局存储在实例中的，只要新旧仓库处于同一GitLab实例，新仓库引用的LFS对象哈希与旧仓库一致，GitLab会自动复用已存在的对象，不会重复占用存储额度。
• 如果新旧仓库属于同一命名空间（用户/组），命名空间的存储额度是共享的，更不会产生额外消耗。

注意：不要立即删除原仓库，否则其对应的LFS对象会被清理，导致新仓库无法访问这些文件。

二、git filter-repo分步操作指南 #

准备工作 #

1. 确保本地Git版本≥2.22.0，并安装git filter-repo工具（多数新版Git已内置，若未安装可通过包管理器安装，如apt install git-filter-repo或brew install git-filter-repo）。
2. 提前在GitLab界面创建好空的公开新仓库（不要初始化README、.gitignore等文件）。

步骤1：克隆原仓库的完整镜像（含LFS对象） #

# 克隆原仓库的镜像版本（包含所有分支、标签）
git clone --mirror git@gitlab.com:your-namespace/old-private-repo.git
cd old-private-repo.git

# 拉取所有LFS对象到本地，避免处理过程中丢失
git lfs fetch --all

步骤2：创建仓库备份（关键，防止操作失误） #

# 在上级目录创建备份副本
cp -r ../old-private-repo.git ../old-private-repo-backup.git

步骤3：清理贡献者信息 #

根据需求选择以下两种方式之一：

方式A：批量替换所有贡献者为统一公开身份

创建一个mailmap.txt文件，格式如下（每行对应一组替换规则）：

公开团队名称 <public-team@example.com> <old-user1@example.com>
公开团队名称 <public-team@example.com> <old-user2@example.com>

执行替换命令：

git filter-repo --mailmap mailmap.txt

方式B：替换特定贡献者为匿名信息

通过--commit-callback精准替换指定用户的姓名和邮箱：

git filter-repo --commit-callback '
# 替换指定作者信息
if commit.author_email == b"target-user@example.com":
    commit.author_name = b"Anonymous"
    commit.author_email = b"anonymous@example.com"
# 替换指定提交者信息（若作者与提交者为同一人可省略）
if commit.committer_email == b"target-user@example.com":
    commit.committer_name = b"Anonymous"
    commit.committer_email = b"anonymous@example.com"
'

步骤4：验证清理结果 #

# 查看所有提交的作者信息，确认已完成替换
git log --format="%an <%ae>" | sort | uniq

# 检查LFS文件指针是否正常，无损坏
git lfs ls-files

步骤5：推送到新公开仓库 #

# 添加新仓库的远程地址
git remote add new-origin git@gitlab.com:your-namespace/new-public-repo.git

# 推送所有分支、标签到新仓库
git push new-origin --mirror

# 推送所有LFS对象到新仓库（GitLab会自动复用已存在的对象）
git lfs push new-origin --all

步骤6：验证新仓库可用性 #

cd ..
# 克隆新仓库到本地
git clone git@gitlab.com:your-namespace/new-public-repo.git
cd new-public-repo

# 拉取LFS文件并验证
git lfs pull
# 检查文件是否可正常打开，提交历史是否已清理

内容的提问来源于stack exchange，提问作者Red