解决 Git 访问 GitHub 时的 SSL 错误

在使用 Git 访问 GitHub 仓库时，有时会遇到 SSL 错误，这通常是由于 SSL 证书问题、网络设置问题或者 Git 配置问题引起的。本文将详细介绍解决这些问题的方法，帮助您顺利访问 GitHub。

一、常见的 SSL 错误及原因

1. SSL certificate problem: self signed certificate这是由于 SSL 证书不被信任或是自签名证书引起的。
2. SSL certificate problem: unable to get local issuer certificate这是由于无法验证 SSL 证书链中的一个或多个证书引起的。
3. fatal: unable to access 'https://github.com/...': SSL certificate problem: certificate has expired这是由于 SSL 证书已过期引起的。

二、解决方法

1. 更新 CA 证书

更新系统的 CA 证书，确保本地的证书链是最新的。

# 对于Debian/Ubuntu
sudo apt-get update
sudo apt-get install --reinstall ca-certificates

# 对于RedHat/CentOS
sudo yum update ca-certificates
​

2. 配置 Git 使用系统的 CA 证书

通过设置 Git 配置，指定 CA 证书文件的位置。

git config --global http.sslCAInfo /etc/ssl/certs/ca-certificates.crt

3. 禁用 SSL 验证（不推荐）

如果以上方法无效，您可以暂时禁用 SSL 验证以解决紧急问题，但这会降低安全性，不推荐长期使用。

git config --global http.sslVerify false

4. 使用 SSH 方式访问 GitHub

将 GitHub 仓库地址从 HTTPS 改为 SSH，可以绕过 SSL 验证问题。

git remote set-url origin git@github.com:username/repository.git

然后配置 SSH 密钥：

1. 生成 SSH 密钥

   ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

2. 添加 SSH 密钥到 ssh-agent

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_rsa

3. 将 SSH 公钥添加到 GitHub 账户

   复制公钥内容并添加到 GitHub 账户的 SSH keys 设置中：

   cat ~/.ssh/id_rsa.pub

三、验证解决方案

1. 测试 Git 连接

使用以下命令测试 Git 连接：

git ls-remote https://github.com/username/repository.git

或使用 SSH：

git ls-remote git@github.com:username/repository.git

2. 确认配置

确保 Git 配置已经正确应用：

git config --list