如何配置cgit无需手动修改URL即可支持git push操作

cgit本身仅作为Git仓库的只读Web浏览前端，不处理Git push相关的POST请求，你之前配置的正则重定向未生效，核心原因是/cgit路径的请求默认全部被交给cgit CGI处理，push类请求根本没有命中重定向规则；如果用301/302外部跳转，Git客户端处理推送请求时不会跟随这类跨路径重定向，自然无法正常推送。

通过Apache规则在后端将/cgit路径下的Git协议请求转发给git-http-backend处理，静态浏览请求仍交给cgit，用户全程使用/cgit前缀的地址即可完成克隆、拉取、推送全操作，无感知。

1. 先启用Apache依赖模块

a2enmod cgi alias env rewrite
systemctl restart apache2

2. 修改Apache站点配置文件（Debian/Ubuntu默认路径为/etc/apache2/sites-available/000-default.conf，按自己实际部署路径调整），添加如下配置：

# 配置Git HTTP后端参数，路径按实际部署情况修改
SetEnv GIT_PROJECT_ROOT /var/lib/git  # 替换为你的Git仓库实际存储根目录
SetEnv GIT_HTTP_EXPORT_ALL
ScriptAlias /git/ /usr/lib/git-core/git-http-backend/  # 替换为系统中git-http-backend的实际路径

# 匹配/cgit路径下所有Git操作请求，内部转发给Git后端处理，客户端无感知
<LocationMatch "^/cgit(/.*\.git/(?:info/refs|git-upload-pack|git-receive-pack))$">
    RewriteRule ^/cgit(/.*)$ /git$1 [L,P,E=PATH_INFO:$1]
    Require all granted
    # 需要做推送鉴权可在此处添加Auth相关配置
</LocationMatch>

# 剩余/cgit路径的请求全部交给cgit处理页面浏览
Alias /cgit/ "/usr/share/cgit/"
<Directory "/usr/share/cgit/">
    AllowOverride None
    Options +ExecCGI
    DirectoryIndex cgit.cgi
    Require all granted
</Directory>

<Files "cgit.cgi">
    SetEnv CGIT_CONFIG /etc/cgitrc
</Files>

3. 修改cgit配置文件/etc/cgitrc，让页面显示的克隆地址统一为/cgit前缀：

clone-prefix = http://192.168.1.124/cgit
enable-http-clone=1

4. 重启Apache生效：systemctl restart apache2
   配置完成后，直接克隆的仓库无需修改任何远程地址，即可正常执行pull、push操作，浏览器访问cgit页面也不受影响。

如果没有服务端配置权限，可以在本地仓库单独为origin设置不同的拉取、推送地址，无需每次手动修改整个URL：

# 保持拉取地址为cgit路径
git remote set-url origin http://192.168.1.124/cgit/myProject.git/
# 单独设置推送地址为/git路径
git remote set-url --push origin http://192.168.1.124/git/myProject.git/

配置完成后执行git remote show origin即可看到Fetch URL和Push URL分别对应不同地址，后续pull、push操作会自动走对应地址，无需重复修改。

内容的提问来源于stack exchange，提问作者Raúl Martín