在Django程序中运行Git服务器，Nginx根路径下Git服务无法访问的解决方案

要让Nginx的根路径/同时支持Django应用和Git HTTP服务器，核心思路是通过Nginx的location匹配规则，区分Git相关请求和普通Django请求，把对应请求转发到各自的服务。下面是具体的配置方案和细节说明：

核心配置思路 #

Nginx会按照location的匹配优先级处理请求：正则表达式的location优先级高于普通的/ location。我们可以先定义一个匹配Git请求的location，剩下的所有请求交给Django处理。

完整Nginx配置示例 #

假设你的Git仓库存放在/var/git/repos目录下，使用git-http-backend配合fcgiwrap处理Git HTTP请求，Django用uWSGI运行：

server {
    listen 80;
    server_name your-domain.com; # 替换成你的域名

    # 处理所有Git相关请求：匹配以.git结尾的路径（比如/myrepo.git/info/refs）
    location ~ ^/.+\.git(/|$) {
        root /var/git/repos; # Git仓库的根目录，每个仓库是这里的子目录
        fastcgi_pass unix:/var/run/fcgiwrap.socket; # fcgiwrap的socket路径，根据实际情况调整
        
        # 配置git-http-backend的必要参数
        fastcgi_param SCRIPT_FILENAME /usr/lib/git-core/git-http-backend;
        fastcgi_param GIT_PROJECT_ROOT /var/git/repos;
        fastcgi_param PATH_INFO $uri;
        
        include fastcgi_params;
    }

    # 所有非Git请求转发给Django
    location / {
        include uwsgi_params;
        uwsgi_pass unix:/path/to/your/django/uwsgi.sock; # 替换成你的uWSGI socket路径
        # 如果用Gunicorn，换成 proxy_pass http://127.0.0.1:8000;
    }
}

关键细节说明 #

1. Git请求匹配规则：
   正则~ ^/.+\.git(/|$)会匹配所有包含.git的路径（比如/myrepo.git、/myrepo.git/info/refs等），这些请求会被转发到git-http-backend处理。

2. fcgiwrap的依赖：
   git-http-backend是CGI脚本，需要通过fcgiwrap转换成FastCGI协议供Nginx调用。你需要先安装fcgiwrap并确保它在运行：

   # Debian/Ubuntu系统安装
   sudo apt-get install fcgiwrap
   sudo systemctl enable --now fcgiwrap
   

3. Git仓库权限配置：
   确保Nginx运行用户（通常是www-data）对Git仓库目录有读取权限；如果需要支持HTTP推送，还要给写入权限，并在仓库中启用接收功能：

   # 给仓库目录设置权限
   sudo chown -R www-data:www-data /var/git/repos
   sudo chmod -R 755 /var/git/repos
   
   # 在目标仓库中启用HTTP推送
   cd /var/git/repos/myrepo.git
   git config http.receivepack true
   

4. 测试验证：

   • 测试Django：访问http://your-domain.com，确认应用正常运行。
   • 测试Git：使用git clone http://your-domain.com/myrepo.git尝试克隆仓库，验证是否能正常访问。

常见问题排查 #

• 如果Git请求失败，查看Nginx错误日志（通常在/var/log/nginx/error.log），检查是否存在路径错误、权限不足或fcgiwrap未运行的问题。
• 确保git-http-backend的路径正确（不同系统可能路径不同，可以用which git-http-backend查看）。

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