解决Git SSL握手失败的8种方法

Git SSL Handshake 错误分析与解决方案

在使用 Git 进行远程仓库操作时，可能会遇到 fatal: Server aborted the SSL handshake 错误。该错误通常与 SSL/TLS 协议协商失败有关，可能由网络配置、证书问题或 Git 客户端设置导致。

错误原因分析

SSL 握手失败通常由以下原因引起：

• 服务器 SSL 证书过期或不受信任
• 客户端 Git 版本过旧，不支持服务器要求的 TLS 协议
• 网络代理或防火墙干扰 SSL 连接
• 系统时间不准确导致证书验证失败

验证 SSL 连接

使用 OpenSSL 测试到 Git 服务器的连接：

openssl s_client -connect github.com:443 -showcerts

检查输出中的证书链和错误信息，确认是否出现 SSL handshake failure。

解决方案：更新 Git 配置

对于自签名证书或内部 Git 服务器，可以暂时禁用 SSL 验证：

git config --global http.sslVerify false

注意：此方法会降低安全性，仅建议在测试环境使用。

解决方案：升级 Git 客户端

旧版 Git 可能使用不安全的 TLS 协议。升级到最新版本：

# Linux (Debian/Ubuntu)
sudo apt-get update && sudo apt-get install git

# macOS
brew update && brew upgrade git

# Windows
choco upgrade git

解决方案：修改 SSL 后端

切换 Git 使用的 SSL 后端可能解决兼容性问题：

# 使用 OpenSSL 后端
git config --global http.sslBackend "openssl"

# 或使用 Schannel (Windows 原生)
git config --global http.sslBackend "schannel"

解决方案：设置最低 TLS 版本

在 Git 配置中强制使用 TLS 1.2：

git config --global http.sslVersion "tlsv1.2"

代理环境下的解决方法

如果通过代理访问，需要配置 Git 使用代理：

#