浏览器能访问，Git 克隆却失败？HTTPS、SSH 与代理配置排查

浏览器能打开代码托管网站，并不能说明 Git 使用了同一条代理路径。遇到克隆失败，先确认仓库地址采用 HTTPS 还是 SSH，再查 Git 读到了哪一份配置。把协议、代理入口和报错阶段分清，通常比连续更换机场节点更容易找到原因。

作者：小六。资料核对日期：2026年10月8日。本文适用于桌面电脑上的 Git 命令行；编辑器内置的 Git 若使用另一套程序或运行环境，需要单独核对。

一、先看仓库地址，别把 HTTPS 和 SSH 混在一起

地址形式	使用的连接方式	排查重点
`https://github.com/owner/repo.git`	HTTPS	Git 的 HTTP 代理配置、证书与仓库权限
`git@github.com:owner/repo.git`	SSH	SSH 连接设置、密钥与账号权限
`ssh://git@github.com/owner/repo.git`	SSH	同上，还要核对地址中的端口

Git 的仓库地址文档明确区分这些传输方式。http.proxy 面向 HTTP 类连接，不能把它当成 SSH 代理开关。

如果已经有本地仓库，在该仓库目录查看：

git --version
git remote -v
git ls-remote --get-url origin

origin 要换成实际远程名称。最后一条会展开 Git 的地址重写配置，并且不连接远程，适合检查“看起来是 HTTPS，实际是否被改成了另一种地址”。尚未克隆时，先核对准备使用的完整地址即可。分享输出前隐藏私人仓库路径和可能嵌在地址中的凭据。命令含义见 ls-remote 官方说明。

只看“全局代理设置了没有”不够。Git 可能读取系统、用户和仓库中的配置，还允许针对某个网址设置不同值。对准备连接的 HTTPS 地址，可以查询：

git config get --show-origin --url=https://github.com/git/git.git http.proxy

把示例网址替换为自己的完整 HTTPS 仓库地址。--show-origin 帮助找到配置来源，--url 查询与这个地址匹配的值。旧版 Git 若不支持 get 子命令，可使用兼容写法：

git config --show-origin --get-urlmatch http.proxy https://github.com/git/git.git

当前文档推荐新语法。没有输出可能是未找到这个配置值，不代表连接一定直连：终端的代理环境变量，以及单独的 remote.<名称>.proxy 仍需核对。这些行为可查阅 Git 配置文档。

可能是另一份文件或网址专用配置仍在生效。先记下查询结果的文件位置、代理地址与端口，再定位需要调整的那一项；不要直接删除整份配置。修复后回到相同目录、相同终端，查询同一个地址，才有可比较的结果。

若只在编辑器中失败，也要记录它使用的 Git 路径。命令行与编辑器各自的环境变量不同，是值得核对的方向，不能仅凭浏览器正常就排除这个差别。

确认客户端提供了本机 HTTP 或兼容的混合代理入口后，可用临时参数查询一个公开仓库的引用：

git -c http.proxy=http://127.0.0.1:7890 ls-remote https://github.com/git/git.git HEAD

7890 只是示例，必须换成客户端实际监听端口；不要把订阅链接或远程节点地址填在这里。该命令只查询远程引用，不进行完整克隆，-c 也不会写入全局配置。参数用法见 Git 命令文档，查询范围见 ls-remote 文档。

临时参数不是绕过所有配置的万能开关。若存在更具体的网址代理设置，仍应核对匹配结果；使用远程名称时也要检查它的专用配置。看懂配置来源之后再做对照，才能判断改变的是哪一段路径。

试验时固定网络、节点和仓库，只改一个入口。客户端若能显示连接记录，可同时查看目标域名及所用规则。出现 HEAD 与提交编号，说明这次引用查询成功；它不能保证大仓库下载、子模块或其他下载工具也全部正常。

现象	下一步核对
连本机代理端口都失败	客户端是否运行，端口和协议是否正确
连接超时	失败目标是代理入口还是远程主机，再查对应路径
HTTPS 证书错误	证书、系统时间和信任来源
SSH 提示 `Permission denied (publickey)`	SSH 密钥、账号和仓库权限

证书错误可参考本站代理连接证书报错排查。不要为了让错误消失就长期关闭证书验证。

节点测速与 Git 仓库访问的目标、协议和数据量可能不同。先确认 Git 的请求有没有进入预期入口，再判断节点表现。

先按报错定位原因。换地址会同时改变连接方式和认证要求，未必能解决现有问题。若终端代理本身不清楚，可以先阅读本站curl 代理配置排查，再回到 Git 的配置来源检查。

把仓库地址和授权问题单独核对。不同仓库的权限不同，公开仓库成功不能证明私人仓库的账号验证也成功；此时保留原始错误，比继续换节点更有帮助。

遇到 Git 连接问题，欢迎带着 Git 版本、地址协议和脱敏后的报错交流。不要发送密钥、账号令牌或完整订阅链接：Telegram 联系我。