如何在自定义Git服务器实现克隆前显示仓库预估大小？

核心思路：通过包装Git服务器的git-upload-pack命令，在实际执行克隆传输前计算仓库大小并输出提示信息。Git原生钩子没有克隆前触发的类型，因此需要替换服务器端的git-upload-pack执行逻辑来实现需求。

具体步骤 #

1. 备份原始git-upload-pack命令
   先确认系统中git-upload-pack的路径（通常为/usr/bin/git-upload-pack），执行备份：

   cp /usr/bin/git-upload-pack /usr/bin/git-upload-pack-original
   

2. 创建自定义包装脚本
   新建脚本文件/usr/bin/git-upload-pack（替换原命令路径，或放在其他路径后单独配置），内容如下：

   #!/bin/bash
   
   # 获取克隆请求对应的仓库路径
   REPO_PATH="$1"
   
   # 进入仓库目录，失败则退出
   cd "$REPO_PATH" || exit 1
   
   # 统计仓库打包对象的总大小（单位：KiB）
   SIZE_KiB=$(git count-objects -v | grep size-pack | awk '{print $2}')
   
   # 转换为更易读的GiB单位（保留两位小数）
   SIZE_GiB=$(echo "scale=2; $SIZE_KiB / 1024 / 1024" | bc)
   
   # 输出提示信息，必须以remote:开头才能被客户端识别显示
   echo "remote: Sending approximately $SIZE_GiB GiB ..."
   
   # 调用原始的git-upload-pack命令完成克隆传输
   exec /usr/bin/git-upload-pack-original "$@"
   

3. 赋予脚本执行权限

   chmod +x /usr/bin/git-upload-pack
   

补充说明 #

• 大小计算逻辑：git count-objects -v输出的size-pack是仓库所有打包对象的总大小，和克隆时实际传输的数据包大小接近，是比较准确的近似值。
• 多场景适配：
  • 若使用git daemon，确保启动时未指定其他--upload-pack路径，或显式指定自定义脚本路径。
  • 若使用HTTP服务器（如Nginx+git-http-backend），替换系统全局的git-upload-pack即可，git-http-backend会自动调用该命令。
  • 若只想针对单个仓库生效，可在目标仓库的.git/config中添加配置：

    [uploadpack]
        command = /usr/local/bin/git-upload-pack-wrapper
    

    此时无需替换系统全局命令，只需将自定义脚本放在指定路径并赋予权限。

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