开发工具连接排查 · Git

Git 一直连接旧代理端口:查配置来源,再按仓库修复

浏览器正常,Git 却连接已关闭的 127.0.0.1 端口?核对远程协议、配置来源与 URL 专用规则,用单次请求验证,再恢复或修正当前仓库设置。

查配置来源单次验证修复与恢复

浏览器恢复了,Git 为什么仍连接旧端口

代理客户端从 7890 换成了另一个端口,浏览器已经正常,git fetch 却继续报连接 127.0.0.1:7890 失败。这时先查 Git 正在使用的设置,不要把订阅删掉重建,也不必重装 Git。

Git 的 HTTP 传输可以有自己的代理配置;它可能来自当前仓库、用户配置、系统配置,或某个特定 URL 的规则。终端环境也可能提供代理。浏览器的成功只能说明浏览器那条路径可用,不能替 Git 作结论。

本文处理 HTTPS 远程仓库的代理入口问题。命令依据 Git 官方文档整理;没有声称在你的 IDE、企业代理或操作系统上完成实机测试。所有查询结果都可能包含内部地址或带账号的 URL,先在本机查看,分享前去掉凭据。

先看实际远程 URL,不急着改代理

进入出错的仓库目录,在发生错误的同一个终端中执行。示例远程名是 origin;如果实际使用其他名字,应对应替换。

示例代码
git --version
git remote get-url origin
git remote get-url --push origin

确认取回和推送 URL 是否相同。get-url 会展开 Git 的 URL 重写规则,因此它比只看记忆中的仓库地址更有用。若 URL 是 git@host:owner/repo.git 或 ssh://,属于 SSH 路径,本文的 HTTP 代理设置不负责它;不要为了套用命令直接改远程协议。

尚未克隆、目录里没有仓库时,不存在当前仓库的 local 配置,origin 查询也不适用。先检查用户级配置和当前环境,不能把“没有远程”当网络故障。IDE 里的 Git 与终端可能来自不同安装位置或启动环境,也要分别核对。

把代理值和来源一起查出来

在仓库中查询代理相关键,输出保留作用范围与来源路径:

示例代码
git config --show-origin --show-scope --get-regexp '^(http\..*proxy|remote\..*\.proxy)$'

重点看三列信息:范围是 local、global、system、worktree 还是 command;来源是哪一个文件;键是通用 http.proxy、URL 专用项,还是 remote.origin.proxy。一个旧端口可能在不止一处出现。条件 include 也可能引入额外配置,不能只打开一个用户配置文件就认定已经查全。

没有匹配结果时,查询可能以非零状态退出,这不表示远程连接失败。它也不证明请求必定直连:还要检查当前进程继承的代理环境变量。本文使用兼容常见既有 Git 的查询语法;若旧版本不识别 --show-scope,先去掉这一项保留来源路径,按该版本文档判断范围,不猜测配置层级。

为何只改 http.proxy 仍可能没用

对 HTTPS 地址,HTTP 配置键仍叫 http.proxy,不是随手新增一个 https.proxy。此外,针对某个 URL 的配置和针对某个 remote 的配置需要单独核对。

以下用 Git 项目的公开 URL 演示匹配查询,不发起网络请求。排查自己仓库时,把它换成刚刚读到的实际 HTTPS URL;不要把包含令牌的地址粘进公共截图。

示例代码
git config --get-urlmatch http.proxy https://github.com/git/git.git
git config --show-origin --get-all remote.origin.proxy

第一条帮助判断这个 URL 命中的 HTTP 代理值,再回到上一节的来源列表定位文件;第二条单独查看命名远程的代理值。这里不把 --show-origin 与 --get-urlmatch 组合,避免旧版 Git 不支持该组合。前者不是全部配置与环境的最终判决。典型情况是:你改了通用值,但站点专用项仍写着旧端口,或者 origin 本身另有设置。

例如,其他 HTTPS 仓库可用,只有一个站点失败,应优先检查它的 URL 专用配置;只有当前仓库失败,则先比较 local、worktree 或 remote 项。这样的差异比反复修改全局代理更有定位价值。

先做一次只读远程查询,不写永久配置

确认当前客户端的 HTTP 入口正在监听,并且你有权使用该路径后,可为这一次命名远程请求指定代理。7890 只是示例,必须替换成实际端口;不要把 HTTP 入口和 SOCKS 入口混用。

示例代码
git -c remote.origin.proxy=http://127.0.0.1:7890 ls-remote origin HEAD

-c 为本次 Git 调用提供配置,不写进仓库或用户配置文件。这里使用 remote 专用键,避免只设置通用 HTTP 项却漏看 origin 的情况。ls-remote 读取远程引用,不执行 push,也不会把远程分支合并进工作区;但私有仓库仍可能要求已有合法凭据。

返回提交标识与 HEAD,说明这次读取路径成功,不等于推送权限、所有分支或大文件传输都已验证。若长时间没有返回,可用 Ctrl+C 结束并保留错误阶段。出现认证或访问拒绝时,按正常授权处理,不反复换出口;若变成 TLS 证书错误,接着查程序与信任库,不要关闭证书校验。

只修已确认的范围,留下恢复依据

单次测试成功后,先记下准备修改的键、文件、原值,以及它原来是否存在。配置文件可能含凭据,备份应保存在自己控制的位置,不上传为公开附件。

如果只有当前仓库需要这个代理,并且已确认它原来没有 local 的 remote.origin.proxy,可以写入该仓库:

示例代码
git config --local remote.origin.proxy http://127.0.0.1:7890

这条命令改变当前仓库,不能拿来修复所有仓库。若查询发现真正的旧值在 global、system 或 include 文件里,应先判断它是否还服务其他项目,再由配置的维护者修正对应项;不要照抄一组全局删除命令。

如果只是撤回本文刚新增的 local 项,而且已确认修改前这个键不存在,可以删除它:

示例代码
git config --local --unset-all remote.origin.proxy

如果原来已有值或多条配置,应恢复记录中的原值,而不是执行上面的删除命令。删除 local 项之后,下层继承的旧代理可能重新生效,因此删除不等于直连,也不等于修好。命名远程的空代理值有禁用代理的含义,与“未设置”不同,不要混为一谈。

验证配置,再验证原来的操作

  1. 重新运行带来源的查询,确认改的是预期文件和范围,其他项目的配置没有一起变化。
  2. 这次不加临时 -c,执行 git ls-remote origin HEAD,检查持久配置下是否可读。
  3. 回到最初出错的终端或 IDE,重试原操作。不要只在另一个新终端成功后就结束排查。

如果再次指向旧端口,核对远程名、URL 重写、条件 include 和启动环境是否相同。如果入口根本没有监听,先按本地端口排查检查客户端;如果请求已经到达远程并返回 HTTP 状态,则转入对应连接阶段,不继续盲改代理。

恢复时按修改前记录还原本次配置,再查一次来源。单次 -c 请求结束后不会持久保存参数;本文没有要求重置 Git、删远程、改凭据或修改系统安全设置。

官方资料与延伸阅读

相关基础:代理环境变量 · HTTP 与 SOCKS 入口 · curl 请求分层验证。