You need to enable JavaScript to run this app. Windows10执行git clone拉取GitHub Pages仓库报errno 10054错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Windows10执行git clone拉取GitHub Pages仓库报errno 10054错误如何解决?

Git克隆GitHub Pages仓库报错errno 10054排查解决方案

报错信息如下:

Cloning into 'username.github.io'...
fatal: unable to access 'https://github.com/username/username.github.io/': OpenSSL SSL_read: Connection was reset, errno 10054

该报错为Windows环境下Git通过HTTPS协议连接GitHub时触发的网络连接中断类问题,可按以下优先级排查解决:

  • 优先检查Git代理配置
    如果你本地正在使用网络代理,需为Git配置对应代理规则,执行以下命令(将端口号替换为你本地代理的实际端口):
    git config --global http.proxy http://127.0.0.1:本地代理端口
    git config --global https.proxy http://127.0.0.1:本地代理端口
    
    如果你未使用任何代理,需清空Git可能存在的错误代理配置:
    git config --global --unset http.proxy
    git config --global --unset https.proxy
    
  • 调整SSL校验规则
    部分场景下SSL证书校验异常会触发连接中断,可临时关闭SSL校验验证是否能正常克隆:
    git config --global http.sslVerify false
    
    注意:验证完成后建议执行git config --global http.sslVerify true重新开启校验,避免后续出现安全风险
  • 扩大Git HTTP缓冲区
    如果仓库体积较大,默认缓冲区不足会导致连接被重置,执行以下命令将缓冲区调整为500M:
    git config --global http.postBuffer 524288000
    
  • 刷新本地DNS缓存
    Windows下DNS解析异常也会导致连接失败,按下Win+R输入cmd打开命令提示符,执行以下命令刷新DNS:
    ipconfig /flushdns
    
  • 替换克隆协议
    如果HTTPS协议始终无法正常连接,可以切换为SSH协议克隆,提前在GitHub账户中配置好本地SSH公钥后,执行以下克隆命令即可:
    git clone git@github.com:username/username.github.io.git
    
  • 检查本地拦截规则
    临时关闭Windows Defender防火墙、第三方杀毒软件后重试克隆,确认是否为安全软件拦截了Git的网络请求。

内容的提问来源于stack exchange,提问作者Ryan Wang

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 03:15:02