macOS下搭建私有Git HTTPS仓库遇认证失败问题求助

1. 配置Nginx转发Git请求至git-http-backend #

当前Nginx仅将请求当作静态文件处理，但Git的HTTP协议需要通过git-http-backend CGI程序生成动态内容（比如info/refs）。需在Nginx的server块中添加以下location规则：

location ~ ^/(.*/git-receive-pack|.*\.git/info/refs|\.git/objects/.*|\.git/git-receive-pack|\.git/git-upload-pack)$ {
    auth_basic "Private Git Repository";
    auth_basic_user_file /path/to/your/.htpasswd;

    # 配置fcgiwrap转发CGI请求，需先安装fcgiwrap工具
    fastcgi_pass unix:/var/run/fcgiwrap.socket;
    fastcgi_param SCRIPT_FILENAME /usr/lib/git-core/git-http-backend;
    fastcgi_param PATH_INFO $uri;
    fastcgi_param GIT_PROJECT_ROOT /Users/me/server/git; # 裸仓库所在的父目录
    fastcgi_param GIT_HTTP_EXPORT_ALL "";
    include fastcgi_params;
}

注意：需先安装fcgiwrap（macOS用brew install fcgiwrap，Debian/Ubuntu用apt install fcgiwrap），它负责将Nginx的FastCGI请求转交给Git的CGI程序处理。

2. 开启仓库的HTTP接收权限 #

裸仓库默认未开启HTTP推送权限，执行以下命令配置：

cd /Users/me/server/git/test-repo.git
git config http.receivepack true

也可在初始化仓库时直接配置：

git --bare init test-repo.git
git -C test-repo.git config http.receivepack true

3. 修正目录权限与路径 #

• 确认GIT_PROJECT_ROOT指向裸仓库的父目录（即/Users/me/server/git），确保Git能正确定位仓库。
• 赋予Nginx运行用户对仓库目录的读写权限：

# macOS下Nginx默认用户为_www，Linux通常为www-data
chown -R _www:_www /Users/me/server/git
chmod -R 755 /Users/me/server/git

4. 验证配置 #

重启Nginx后，在客户端重新执行克隆命令：

git clone https://git.example.com/test-repo.git

若仍有问题，查看Nginx的error.log与access.log，排查是否存在fcgiwrap连接失败或权限异常。

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