Git代理

June 15, 2024

我们知道，常用的 Git 远程协议有 HTTP 协议和 SSH 协议。

要设置代理，实际上就是分别为这两种协议配置代理。

HTTP 协议

git config 命令用于修改 Git 本身的配置文件，包含全局配置（~/.gitconfig）和本地（当前仓库 .git/config）配置。

Git 本身是支持 http_proxy https_proxy all_proxy 环境变量的。

http.proxy 键用于强制设置 HTTP 代理的服务器地址，支持 HTTP 和 HTTPS 代理。
（有关更多高级配置，参见文档）

git config [--global] http.proxy [protocol://][user[:password]@]proxyhost[:port]
# e.g. git config --global http.proxy http://127.0.0.1:7890

对应配置如下

config

[http]
    proxy = [protocol://][user[:password]@]proxyhost[:port]

Git 允许使用特殊的配置键 http.<url>.* 为指定 url 模式设置代理

git config [--global] http.<url>.proxy [protocol://][user[:password]@]proxyhost[:port]
# <url> 的模式示例（https://username@git-server.domain:8080/repo.git）:
# https
# git-server.domain
# 8080
# repo.git
# username

对应配置如下

config

[http "<url>"]
    proxy = [protocol://][user[:password]@]proxyhost[:port]

SSH 协议

对于 SSH 协议，Git 实际上是通过本机的 ssh 命令来进行通信的，因此实际上是要配置 ssh 而非 git。

对于 Git for Windows，默认安装选项是使用其捆绑的 ssh，不过 Windows 本身也提供 ssh。

ssh 的用户配置文件位于 ~/.ssh/config

ssh_config 的 ProxyCommand 项，用于指定一个命令来处理对指定 Host （占位符 %h）和 Port （占位符 $p）的连接。

Unix 一般使用 nc（netcat）命令（这里不会说明 nc 的细节，见具体 man 手册），Git for Windows 则可以使用捆绑的 connect 命令。

BSD nc 命令

usage: nc [-46CDdFhklNnrStUuvZz] [-I length] [-i interval] [-M ttl]
          [-m minttl] [-O length] [-P proxy_username] [-p source_port]
          [-q seconds] [-s source] [-T keyword] [-V rtable] [-W recvlimit] [-w timeout]
          [-X proxy_protocol] [-x proxy_address[:port]]           [destination] [port]

       -X proxy_protocol
           Requests	that nc	should use the specified protocol when talking
           to the proxy server.  Supported protocols are "4" (SOCKS	 v.4),
           "5"  (SOCKS  v.5) and "connect" (HTTPS proxy).  If the protocol
           is not specified, SOCKS version 5 is used.

       -x proxy_address[:port]
           Requests	that nc	should connect to destination using a proxy at
           proxy_address and port.	If port	is not	specified,  the	 well-
           known port for the proxy	protocol is used (1080 for SOCKS, 3128
           for HTTPS).

~/.ssh/config

Host github.com
    User git
  #  -X connect 为 http 代理
    ProxyCommand nc -X connect -x 127.0.0.1:7890 %h %p
  #  -X 5 为 socks5 代理（默认）
  # ProxyCommand nc -X 5 -x 127.0.0.1:7891 %h %p

Nmap ncat 命令

Ncat 7.80 ( https://nmap.org/ncat )
Usage: ncat [options] [hostname] [port]

~/.ssh/config

Host github.com
    User git
  #  --proxy-type http 为 http 代理
    ProxyCommand ncat --proxy 127.0.0.1:7890 --proxy-type http %h %p
  #  --proxy-type socks5 为 socks5 代理
  # ProxyCommand ncat --proxy 127.0.0.1:7891 --proxy-type socks5 %h %p

Windows 下，connect 命令

connect --- simple relaying command via proxy.
Version 1.105
usage: C:\Program Files\Git\mingw64\bin\connect.exe [-dnhst45] [-p local-port]
          [-H proxy-server[:port]] [-S [user@]socks-server[:port]]
          [-T proxy-server[:port]]
          [-c telnet-proxy-command]
          host port

%USERPROFILE%/.ssh/config

Host github.com
    User git
  # -H 设置 http 代理
    ProxyCommand connect -H 127.0.0.1:7890 %h %p
  # -S 设置 socks 代理
  # ProxyCommand connect -S 127.0.0.1:7891 %h %p

Git 还允许通过环境变量来指定其调用的 ssh

例如：

export GIT_SSH_COMMAND='ssh -o ProxyCommand="nc -x 127.0.0.1:7891 %h %p"'

对于 Linux，也可以使用通用的工具来应用代理，如 tsocks proxychains go-graft

←Back to home

This work is licensed under CC BY-NC-SA 4.0

NickName

E-Mail

Website

Comments

Latest
Oldest
Hottest

No comment yet.

YieldRay

Git代理

Preview: