GitHub HTTPS 连接问题解决方案

在服务器运维过程中，有时会遇到 SSH 可以正常连接 GitHub，但使用 HTTPS 协议克隆仓库时却连接超时的问题。本文记录了这个问题的原因分析和解决方案。

问题现象#

在服务器上使用 HTTPS 协议克隆 GitHub 仓库时，连接超时：

1
git clone https://github.com/xxx/xxx.git
2
# 报错：Failed to connect to github.com port 443 after xxxxx ms: Connection timed out

而使用 SSH 协议则可以正常工作。这种情况通常让人感到困惑，因为 SSH 能通，说明网络本身是可以连接到 GitHub 的。

经过排查发现，问题的根源在于：DNS 解析到的 GitHub IP 地址的 443 端口被阻断了。

虽然 GitHub 有多个 IP 地址，但由于网络环境、地理位置或 DNS 解析策略的不同，不同服务器解析到的 IP 地址可能不同。当解析到的某个 IP 的 443 端口不可达时，就会出现 HTTPS 连接失败的情况。

首先，我们需要在能够正常访问 GitHub 的服务器上查询 GitHub 的 IP 地址：

1
ping -c 1 github.com

记录返回的 IP 地址。例如，输出可能是：

1
PING github.com (20.205.243.166) 56(84) bytes of data.
2
64 bytes from 20.205.243.166: icmp_seq=1 ttl=112 time=5.23 ms

这里的 IP 地址 20.205.243.166 就是我们需要的可用 IP。

在出现问题的服务器上，编辑 /etc/hosts 文件：

1
sudo vim /etc/hosts

在文件末尾添加以下内容（使用你在步骤 1 中获取的 IP 地址）：

1
20.205.243.166 github.com

保存并退出编辑器。

修改完成后，进行验证：

1
# 测试 HTTPS 连接
2
curl -v https://github.com
3

4
# 尝试克隆仓库
5
git clone https://github.com/xxx/xxx.git

如果一切正常，应该可以成功连接和克隆了。

如果上述修改 hosts 的方案配置后仍然失败，可以尝试临时禁用 HTTP/2 协议。这个方法在某些网络环境下非常有效：

1
# 临时禁用 HTTP/2，仅对当前命令生效
2
GIT_CURL_VERBOSE=1 GIT_TRACE=1 git -c http.version=HTTP/1.1 push

这个命令会：

如果临时禁用有效，可以将其设置为全局配置：

1
# 全局禁用 HTTP/2
2
git config --global http.version HTTP/1.1

这样设置后，所有的 Git HTTPS 操作都会使用 HTTP/1.1 协议，无需每次都手动指定。

如果以后想恢复使用 HTTP/2，可以执行：

1
# 恢复默认设置（使用 HTTP/2）
2
git config --global --unset http.version

在我遇到的实际案例中：