使用git filter-repo清理GitLab LFS仓库后体积反增，求解决方法

• 先确保本地仓库清理彻底
  本地未清理干净的冗余对象推送到远程会导致体积上涨，执行以下命令：

  • 找出所有未被引用的Git对象：git fsck --unreachable
  • 清理本地引用日志和冗余对象：

    git reflog expire --expire=now --all
    git gc --prune=now --aggressive
    

  完成后强制推送所有分支和标签到远程：git push --force --all && git push --force --tags

• 手动清理未引用的LFS对象
  自动清理可能因配置或任务调度问题未触发，直接手动处理：

  • 若使用GitLab EE或自托管实例，管理员可在服务器运行rake任务：

    gitlab-rake gitlab:cleanup:orphan_lfs_files
    

  • 普通用户可通过GitLab API触发清理（替换<项目ID>为实际项目ID，<你的访问令牌>为个人私有令牌）：

    curl --request DELETE --header "PRIVATE-TOKEN: <你的访问令牌>" "https://gitlab.example.com/api/v4/projects/<项目ID>/lfs/objects"
    

  操作后在项目的Settings > Repository > Large File Storage里确认用量变化

• 清理隐藏引用与冗余资源
  GitLab的CI流水线、合并请求临时分支、已合并分支会保留引用，阻止对象被清理：

  • 批量删除已合并的旧分支：进入Settings > Repository > Repository cleanup，启用"Delete merged branches"或手动删除废弃分支
  • 清理旧CI流水线：在CI/CD > Pipelines中批量删除不再需要的旧流水线，移除关联的临时引用

• 强制触发GitLab仓库维护
  重新执行仓库清理并强制触发housekeeping：

  • 进入项目Settings > Repository > Repository cleanup，再次点击"Clean up"按钮
  • 若上述操作无效，通过API触发housekeeping（替换参数同前）：

    curl --request POST --header "PRIVATE-TOKEN: <你的访问令牌>" "https://gitlab.example.com/api/v4/projects/<项目ID>/housekeeping"
    

• 彻底移除历史中的大文件
  如果是历史提交中的大文件未被彻底清除导致体积上涨，使用git filter-repo工具（替代老旧的git filter-branch）：

  1. 安装git filter-repo（部分系统可通过包管理器安装，或从官方仓库获取）
  2. 移除历史中指定的大文件（替换<大文件路径>为实际路径）：

  git filter-repo --path <大文件路径> --invert-paths
  

  3. 强制推送清理后的仓库到远程：

  git push --force --all && git push --force --tags
  

  4. 再次触发GitLab的cleanup和housekeeping操作

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