跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash大前端

Git 连接失败 fatal: unable to access 错误排查与修复方案

Git 连接失败(fatal: unable to access)的核心原因,包括代理配置异常、DNS 解析失败及网络限制。提供了清除/重置 Git 代理配置和切换 SSH 协议两种解决方案,指导用户通过命令行检查代理设置、清除错误配置或生成 SSH 密钥并修改远程仓库地址,以恢复正常的代码拉取与推送功能。

修罗发布于 2026/3/26更新于 2026/9/810K 浏览

一、核心原因分析

代理配置异常:本地开启了代理(如梯子、公司代理),但 Git 未配置代理,或代理配置错误;DNS 解析失败:本地 DNS 缓存过期 / 污染,导致无法解析 github.com 域名;网络 / 防火墙限制:本地防火墙、杀毒软件、公司 / 校园网络屏蔽了 443 端口;GitHub 服务器临时故障:极少情况,可通过 GitHub Status 验证;HTTPS 协议限制:部分网络环境对 HTTPS 协议的 443 端口做了拦截。

二、解决方案

方案 1:清除 / 重置 Git 代理配置(最常见解决方式)

很多开发者开启了代理但未同步配置到 Git,或代理配置错误,是导致 443 报错的首要原因。

步骤 1:查看当前 Git 代理配置
# 查看 Git 全局代理配置
git config --global --get http.proxy
git config --global --get https.proxy
步骤 2:清除错误的代理配置

如果代理配置错误 / 不需要代理,直接清除:

# 清除 http/https 代理
git config --global --unset http.proxy
git config --global --unset https.proxy
步骤 3:配置 Git 全局代理
# 方案 1:SOCKS5 代理(推荐,兼容性更好)
git config --global http.https://github.com.proxy socks5://127.0.0.1:7891
git config --global https.https://github.com.proxy socks5://127.0.0.1:7891

# 方案 2:HTTP 代理(若 SOCKS5 不行)
git config --global http.https://github.com.proxy http://127.0.0.1:7890
git config --global https.https://github.com.proxy http://127.0.0.1:7890

方案 2:切换 SSH 协议

GitHub 的 HTTPS 协议易被网络拦截,SSH 协议更稳定,且无需频繁验证身份。

步骤 1:生成 / 配置 SSH 密钥(首次使用需操作)
  1. 打开终端,执行密钥生成命令(替换为你的 GitHub/Gitee 邮箱):
# 推荐 ED25519 算法(更安全)
ssh-keygen -t ed25519 -C "[email protected]"
# 若系统不支持 ED25519,改用 RSA
ssh-keygen -t rsa -b 4096 -C "[email protected]"
  • 执行后全程按回车(默认路径、无密码),密钥会生成在:
    • Windows:C:\Users\你的用户名\.ssh\id_ed25519.pub(或 id_rsa.pub)
    • Mac/Linux:~/.ssh/id_ed25519.pub(或 id_rsa.pub)
  1. 复制公钥内容:

    • Windows(Git Bash):cat ~/.ssh/id_ed25519.pub,复制输出的全部内容;
    • Mac/Linux:pbcopy < ~/.ssh/id_ed25519.pub(直接复制到剪贴板)。
  2. 将公钥配置到远程仓库平台:

    • GitHub:登录后 → 右上角头像 → Settings → SSH and GPG keys → New SSH key → 粘贴公钥 → Add SSH key;
    • Gitee:登录后 → 个人设置 → SSH 公钥 → 粘贴公钥 → 确定。
步骤 2:修改仓库远程地址为 SSH 格式
协议类型地址示例
HTTPShttps://github.com/xxx/xxx.git
SSH[email protected]:xxx/xxx.git(GitHub)
SSH[email protected]:xxx/xxx.git(Gitee)

若已克隆仓库:修改本地仓库的远程地址:

# 进入仓库目录
cd 你的仓库名
# 查看当前远程地址
git remote -v
# 修改为 SSH 地址
git remote set-url origin [email protected]:xxx/xxx.git

若未克隆仓库:直接用 SSH 地址克隆:

git clone [email protected]:xxx/xxx.git

目录

  1. 一、核心原因分析
  2. 二、解决方案
  3. 方案 1:清除 / 重置 Git 代理配置(最常见解决方式)
  4. 步骤 1:查看当前 Git 代理配置
  5. 查看 Git 全局代理配置
  6. 步骤 2:清除错误的代理配置
  7. 清除 http/https 代理
  8. 步骤 3:配置 Git 全局代理
  9. 方案 1:SOCKS5 代理(推荐,兼容性更好)
  10. 方案 2:HTTP 代理(若 SOCKS5 不行)
  11. 方案 2:切换 SSH 协议
  12. 步骤 1:生成 / 配置 SSH 密钥(首次使用需操作)
  13. 推荐 ED25519 算法(更安全)
  14. 若系统不支持 ED25519,改用 RSA
  15. 步骤 2:修改仓库远程地址为 SSH 格式
  16. 进入仓库目录
  17. 查看当前远程地址
  18. 修改为 SSH 地址

更多推荐文章

查看全部
  • Python + MySQL + Web 构建私有 Apple 设备监控系统
  • ToDesk 发布 ToClaw:AI 可直接操作电脑
  • GitHub 仓库配置与推送:从 SSH 到冲突解决
  • HUSKYLENS 2 AI 相机视觉传感器识别条形码输出数据
  • Java 在 AI 时代的演进:从机器学习到 AIGC 实战
  • Docker 拉取镜像超时解决方案:配置镜像加速器及隐藏设置
  • OpenClaw Windows 10 本地 AI 智能体一键部署教程
  • 傅里叶级数与变换:从连续到离散的完整体系梳理
  • Python 基于 LangGraph 搭建带记忆与人工干预的搜索机器人
  • Linux 进程创建与终止:fork 与 exit 底层逻辑解析
  • Linux 下 GCC 编译入门与基础用法
  • Stable Diffusion 3.5 FP8 量化实战与工作流优化探索
  • 资源有限场景下的大模型微调方法汇总与优化策略
  • OpenClaw 安装配置指南:Minimax/DeepSeek 模型及飞书机器人接入
  • 无人机接单平台推荐及求职指南
  • GitHub Copilot 学生身份认证流程与材料准备指南
  • 安装 Microsoft Visual C++ Build Tools 配置指南
  • 基于自然语言交互的 AI 爬虫工具实战解析
  • 前端直连模型 vs 完整 MCP:大模型驱动地图原理与实践
  • Spring AI 框架入门指南

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online