切换语言
中文 English Русский Deutsch Español Français Italiano Українська Tiếng Việt Türkçe Bahasa Indonesia हिन्दी 日本語 Português
菜单
价格
代理
代理类型
解决方案
资源

如何在 Git 中设置代理

主题: 按设备和应用设置 全部解答

简而言之: 运行 git config –global http.proxy http://LOGIN:PASSWORD@HOST:PORT,让 Git 通过 HTTP 代理访问;SOCKS5 则使用 socks5h://HOST:PORT。它只对 http 和 https 远程仓库生效,对 SSH 远程仓库无效。取消设置用 git config –global –unset http.proxy。登录信息会以明文形式保存在 Git 配置文件中。

Git 通过 libcurl 访问 http 和 https 远程仓库,因此遵循与 如何在 curl 中使用代理相同的代理规则。主机、端口、登录名和密码,请取自 控制台中“我的代理”里的同一行。

为所有仓库设置代理

git config --global http.proxy http://LOGIN:PASSWORD@HOST:PORT

这条命令会在 ~/.gitconfig 中写入一行。这一项设置同时适用于 http 和 https 远程仓库。 可用 git config --get http.proxy 检查。

如果订单使用 SOCKS5,请先通过“更改协议”切换订单的协议,重新复制连接信息,然后使用:

git config --global http.proxy socks5h://LOGIN:PASSWORD@HOST:PORT

其中的 h 表示由代理来解析主机名。协议本身的介绍见 SOCKS5 代理页面。

对特殊字符进行编码

登录信息写在 URL 里,所以 @ 必须写作 %40,: 写作 %3A,/ 写作 %2F,# 写作 %23,% 写作 %25。未编码的密码会被截断,代理会返回 407。

只对一个仓库或一个主机生效

在仓库目录内去掉 --global,即可只对该仓库生效:

git config http.proxy http://LOGIN:PASSWORD@HOST:PORT

若要把代理限定在某一个主机,把主机写进键名:

git config --global http.https://example.com.proxy http://LOGIN:PASSWORD@HOST:PORT

环境变量

Git 还会读取 shell 中的 http_proxy、https_proxy 和 all_proxy,以及用来跳过某些主机的 no_proxy 列表。配置项一旦设置,优先级高于这些环境变量。

该选哪种作用范围

全局设置最简单,但它会让所有 http 和 https 远程仓库都走代理,包括代理无法到达的内部服务器。 遇到这种情况,请把代理限定在某个主机或某个仓库,或者把内部主机写进 no_proxy。只有一个远程 仓库需要代理时,按主机设置的键最稳妥。

取消设置

git config --global --unset http.proxy

注意事项

  • 密码以明文形式保存在 Git 配置文件中。请妥善保管该文件,不要把它提交到仓库。
  • SSH 远程仓库(git@host:...)会忽略 http.proxy。
  • git clone 返回 407,说明代理拒绝了登录信息: 代理错误 407列出了排查步骤, 代理身份验证失败则介绍许可列表模式。
  • 请仅对您有权访问的仓库使用代理,这是可接受使用政策的要求。 套餐见 ISP 代理页面。

关于 Git 和代理的快速解答

代理对 git@ 开头的远程仓库有效吗?

无效。http.proxy 只作用于 http 和 https 远程仓库。git@ 开头的远程仓库走 SSH,SSH 有它自己的代理设置。

如何只对某一个主机使用代理?

把主机写进配置项的键名里:git config --global http.https://example.com.proxy http://HOST:PORT,其中的 example.com 换成您自己的主机。

如何查看 Git 发出了什么请求?

在命令前加上 GIT_CURL_VERBOSE=1 再运行。输出中会显示发往代理的 CONNECT 请求。

相关页面