Ubuntu下git clone报错gnutls_handshake() failed?3种解决方案实测有效
最近在Ubuntu系统上使用git clone时,不少开发者遇到了gnutls_handshake() failed的错误提示。这个报错通常与TLS握手失败有关,可能由网络环境、系统配置或Git协议等多种因素导致。本文将分享三种经过实测有效的解决方案,帮助你快速恢复代码拉取操作。
1. 更换Git协议:从HTTPS切换到SSH或Git
当HTTPS协议出现TLS握手问题时,最简单的解决方法是尝试其他协议。以下是具体操作步骤:
-
切换到SSH协议(推荐长期使用):
bash复制git clone git@github.com:username/repository.git注意:使用前需先配置SSH密钥,执行以下命令生成密钥并添加到GitHub账户:
bash复制ssh-keygen -t ed25519 -C "your_email@example.com" cat ~/.ssh/id_ed25519.pub -
切换到Git协议(临时解决方案):
bash复制git clone git://github.com/username/repository.git但要注意,Git协议可能被某些网络环境屏蔽,且不支持私有仓库访问。
-
配置全局协议替换(解决后续操作):
bash复制git config --global url."git@github.com:".insteadOf "https://github.com/"
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 更新系统证书和GNUTLS库
TLS握手失败可能是由于系统证书过期或GNUTLS库版本问题导致。执行以下步骤更新:
bash复制sudo apt update
sudo apt install --reinstall ca-certificates
sudo update-ca-certificates --fresh
sudo apt install --only-upgrade libgnutls30
