解决 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
相关推荐
草梅友仁3 小时前
草梅 Auth 1.1.0 发布与最新动态 | 2025 年第 30 周草梅周报
开源·github·ai编程
即使再小的船也能远航4 小时前
【Git】实用Git操作指南:从入门到高效协作
git
mortimer4 小时前
安装NVIDIA Parakeet时,我遇到的两个Pip“小插曲”
python·github
心之语歌7 小时前
Spring AI MCP 客户端
人工智能·spring·github
yeshan3339 小时前
使用 Claude Code 的自定义 Sub Agent 完善博文写作体验
ai·github·agent·claudecode
程序视点10 小时前
望言OCR 2025终极评测:免费版VS专业版全方位对比(含免费下载)
前端·后端·github
玩个冰球11 小时前
Stata 18下载安装教程(非常详细),看完这一篇就够了(附安装包)
github
Xi_Xu11 小时前
Xget:下一代开源资源获取加速引擎,让你的文件下载、储存库克隆和镜像拉取快如闪电
开源·github
用户40993225021213 小时前
FastAPI的查询白名单和安全沙箱机制如何确保你的API坚不可摧?
前端·后端·github
<但凡.14 小时前
Git 完全手册:从入门到团队协作实战(4)
git·bash