知仓学习社知仓学习社
git clone / git pull 卡住或报 OpenSSL SSL_read: Connection was reset, errno 10054 / 全站资源搜索
搜索 更新 2026-10-02
报错 073 网络、下载与访问（含国内网络环境） 有来源可查

git clone / git pull 卡住或报 OpenSSL SSL_read: Connection was reset, errno 10054

报错原文（原样） 
fatal: unable to access 'https://github.com/xxxx/xxxx.git/': OpenSSL SSL_read: Connection was reset, errno 10054
检索关键词 OpenSSL SSL_read: Connection was reset、errno 10054、fatal: unable to access、git clone 失败、github.com、Failed to connect to github.com port 443
先看这一句 更新 ComfyUI 或拉取节点仓库时 git 长时间卡住，最后报 Connection was reset / errno 10054 或连接 GitHub 443 超时；重试有时能成、有时不成。
适用版本 全版本通用，与 ComfyUI 版本无关，属 git/网络层问题 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 国内直连 github.com，TLS 握手阶段被重置
  • 使用了代理但 git 未配置代理，或代理规则把 github.com 漏了
  • 大仓库 clone 到一半断流

根因

  • errno 10054 是 Windows 下的「对端重置连接」，多见于网络中间设备对 GitHub 的 TLS 流量做干扰/重置，握手或传输中途被打断。
  • git 默认不读系统/浏览器代理，环境里没有 http_proxy/https_proxy 时就直连，因此出现「浏览器能开、git 不通」。
  • 偶发成功是因为重置是概率性的，网络抖动或走不同出口时结果不同。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 给 git 配代理，或改用镜像加速地址
    给 git 显式配代理是最直接的办法；也可以把远程地址改成 GitHub 加速前缀。注意部分加速服务不稳定，需要可用的替代。
    git config --global http.proxy http://127.0.0.1:7890
    git config --global https.proxy http://127.0.0.1:7890
    git config --global http.postBuffer 524288000
  2. 降低单次传输体量：浅克隆 + 分步拉取
    大仓库一次性 clone 容易在中途被重置。用 --depth 1 只拉最新一次提交，显著减小传输量；之后需要历史再逐步加深。对已经 clone 过的 ComfyUI 主仓库，用 fetch --all 后 pull，避免重新整仓下载。
    git clone --depth 1 https://github.com/<owner>/<repo>.git
    git fetch --all && git pull
  3. 改用 ComfyUI-Manager 的 GITHUB_ENDPOINT 或手工 ZIP 安装
    如果只是要装节点，不必和 git 死磕：让 Manager 走 GITHUB_ENDPOINT 反向代理，或直接下载仓库 ZIP 解压到 custom_nodes（目录名必须为仓库名）。这样可绕开 git 的 TLS 重置问题。
    export GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com

验证是否修好

重新执行 git clone/pull 不再出现 Connection was reset；或改用镜像/ZIP 方式后节点成功出现在 custom_nodes 且能被加载。

补充说明

该报错文本在多个中文技术文章中以完全相同措辞出现（见 sources），属高共识现象；本轮未逐字取到 ComfyUI 官方仓库内该报错的 issue。GITHUB_ENDPOINT 的具体镜像地址请以 docs.comfy.org 当前文档为准，公开镜像服务可用性会变化。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [173] （中文社区）　【错误记录】从 GitHub 中 Clone 代码到本地报错 ( OpenSSL SSL_read: Connection was rese　https://developer.aliyun.com/article/865207
  2. [174] （中文社区）　github拉取OpenSSL SSL_read: Connection was reset, errno 10054　https://blog.csdn.net/weixin_47905944/article/details/150847977
  3. [162] （官方文档）　ComfyUI Manager 故障排除（GitHub 访问问题） - ComfyUI　https://docs.comfy.org/zh/manager/troubleshooting

这条报错要用到的东西

按本条报错所属的类别（网络、下载与访问（含国内网络环境））列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

ComfyUI 权重库（167 个文件 / 约 1187 GB）按 ComfyUI 的 models 目录分好类的 167 个权重文件 / 每个文件一份说明（放哪、被哪些工作流引用） 待挂载
模型档案按仓库看体积，估一下要下多久 板块

同一类别的其他条目

【067】启动或加载工作流时连不上 huggingface.co，控制台报最大重试次数已超过 有来源 【068】SSL 证书校验失败：CERTIFICATE_VERIFY_FAILED unable to get local issuer certificate 有来源 【069】transformers 报 We couldn't connect to 'https://huggingface.co' to load this file 有来源 【070】huggingface_hub 本地找不到文件：LocalEntryNotFoundError / EntryNotFoundError 含未核实 【071】Gated 仓库无权访问：需要登录并同意协议（Llama / Flux 等） 含未核实
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库