Windows下git使用代理服务器的设置方法

时间：2023-08-21 22:34:04

在我朝独有的无敌GFW关照下（当然，也有可能IP被网站封了），要下载网络上开源的软件是非常困难的一件事情，在这种情况下，使用VPN或者代理服务器就非常有必要了。对于单个应用*来说，个人比较喜欢用*代理。

SVN中，使用TortoiseSVN来进行版本控制时，设置代理非常简单，只需要在设置里面添加代理的信息即可。而 git 在GUI(v0.17.GITGUI)中却无法找到类似的设置，只能求助 git bash 来设置。

Git支持四种协议 1 ，而除本地传输外，还有：git://, ssh://, 基于HTTP协议，这些协议又被分为哑协议（HTTP协议）和智能传输协议。对于这些协议，要使用代理的设置也有些差异：

  1. 使用 git协议 时，设置代理需要配置 core.gitproxy
  2. 使用 HTTP协议 时，设置代理需要配置 http.proxy
  3. 而是用 ssh协议 时，代理需要配置ssh的 ProxyCommand 参数

由于个人需求仅仅是HTTP的代理（相对来说，HTTP有比较好的通适性，Windows配置git/ssh比较棘手），设置的时候，只需要针对单个设置 http.proxy 即可，在需要使用代理的项目下面使用 git bash 如下命令进行设置 ——你的Uri和port可能和我的不同，你懂的。：

git config http.proxy http://127.0.0.1:8088  # 也可以是uri:port形式

这个是不需要鉴权的代理设置，如果需要鉴权，可能需要添加用户名密码信息：

git config http.proxy http://username:password@127.0.0.1:8088

如果git的所有项目都需要启用代理，那么可以直接启用全局设置：

git config --global http.proxy http://127.0.0.1:8088

为了确认是否已经设置成功，可以使用 --get 来获取：

git config --get --global http.proxy

这样可以看到你设置在global的 http.proxy 值。

需要修改的时候，再次按照上面的方法设置即可，git默认会覆盖原有的配置值。

当我们的网络出现变更时，可能需要删除掉原有的代理配置，此时需要使用 --unset 来进行配置：

git config --global --unset http.proxy

在命令之后，指定位置的设置值将会被清空，你可以再次使用 --get 来查看具体的设置情况。

如果使用了HTTPS，肯呢个会碰到HTTPS 证书错误的情况，比如提示： SSL certificate problem 。。。，此时，可以尝试将 sslVerify 设置为 false ：

git config --global http.sslVerify false

恩，到此，可以试试git来获取/更改项目了，此时，项目应该是使用代理来进行通讯的。

后记：

  1. 如果非必要，一般不使用 --global 的方式来设置代理，毕竟代理有的时候访问一些项目比直接访问还慢，特别是当代理在国外，项目源在国内的时候，按需使用才是王道。
  2. 不要多次使用不同的参数来设置代理，一般使用文中两种方式酌情选用即可， --global ， --system ， --local 各级设置后，可能会给自己带来不必要的麻烦。git默认是先到git Repository的配置文件中查找配置文件，如果没有才会到 --global 设置的文件中查找，因此，单个项目文件中的设置会覆盖 --global 的设置。
  3. 使用 --global 来配置的信息保存在当前用户的根目录下的 .config 文件中，而仓库中的配置保存在项目仓库的根目录下的 .git/config 文件中。
  4. 如果是Linux的用户，再使用 git/ssh协议 时，根据网上的说法，需要使用 connect

    工具来做代理的转换。—— 本人Linux下的暂时没有配置git使用代理，暂时无法验证，摘录方法如下：

    GIT协议配置：安装完毕 connect 之后，你可以在特定的目录中建立一个 socks5_proxy_wrapper (或其他的文件名亦可)，然后文件内容改为：

    #!/bin/sh
    
connect -S 127.0.0.1:8088 "$@"

    而后即可以配置git了，设置 gitproxy ：

    git config core.gitproxy /path/to/socks5_proxy_wrapper

# 路径要改

    抑或 export GIT_PROXY_COMMAND ：

    export GIT_PROXY_COMMAND="/path/to/socks5_proxy_wrapper"

    SSH协议配置，同样需要建立一个文件，假设命名为： socks5_proxy_ssh ，文件内容为：

    #!/bin/sh
    
ssh -o ProxyCommand="/path/to/socks5_proxy_wrapper %h %p" "$@"

    配置git使用该文件：

    export GIT_SSH="/path/to/socks5_proxy_ssh"

    亦可配置" ~/.ssh/config "中的 ProxyCommand 。

    HTTP协议配置，这里直接使用 http.proxy 设置成 socks5 即可：

    git config http.proxy socks5://127.0.0.1:8088

    如果要全部使用HTTP代理，可以将上面的 socks5_proxy_wrapper 文件设置为：

    #!/bin/sh
    
connect -H 192.168.1.100:8080 "$@"

    其他保持不变即可。而 http.proxy 设置同本文设置即可.

参考：

  1. git文档中指明服务器上的Git协议有：Local, HTTP, Secure Shell(SSH) and Git.
  2. 使用 git config --help 查看设置帮助
  3. Linux配置一节是来自 segmentfault ，权利归作者所有，本文作为个人博客，以备后用，如若不妥请告知。

相关文章