报错
072
网络、下载与访问(含国内网络环境)
有来源可查
ComfyUI-Manager 安装节点失败:连不上 GitHub(Failed to connect to github.com port 443)
报错原文(原样)
E:\com\ComfyUI\custom_nodes>git clone https://github.com/ltdrdata/ComfyUI-Manager Cloning into 'ComfyUI-Manager'... fatal: unable to access 'https://github.com/ltdrdata/ComfyUI-Manager/': Failed to connect to github.com port 443 after 2084 ms: Could not connect to server
检索关键词
fatal: unable to access、Failed to connect to github.com port 443、Could not connect to server、git clone、ComfyUI-Manager、GITHUB_ENDPOINT
先看这一句
在 Manager 里点安装/更新节点后弹出安装失败,或手动 git clone 节点仓库时直接连不上 github.com,443 端口超时。
适用版本 全版本通用;与 Manager 版本和网络环境相关
·
核实日期 2026-09-26
·
状态 已核实
适用环境:Windows 便携版、秋叶/绘世整合包、Linux + 云 GPU、Docker/服务器
现象与触发场景
常见触发场景:
- 国内网络直连 github.com 被重置或超时
- Manager 需要 git clone 节点仓库,但没有配任何镜像/代理
- 企业内网禁止直连 443 外网
根因
- Manager 安装自定义节点的主要方式是 git clone 对应 GitHub 仓库,git 走的是 raw HTTPS(默认不读浏览器代理设置),所以网页能开不代表 git 能通。
- ComfyUI-Manager 提供了 GITHUB_ENDPOINT 环境变量用于重定向 GitHub 请求,但很多用户不知道这个变量,或设置了之后没有重启整个 ComfyUI 进程,导致不生效。
- 如果本机装了代理但只配了系统代理、且 git 没有配 http.proxy,git 仍会直连。
解决步骤
已按「最可能有效」排序。请从上往下做,每做完一步用「验证」确认,不要一次改五处。
- 设置 GITHUB_ENDPOINT 让 Manager 走 GitHub 反向代理ComfyUI-Manager 官方文档给出的做法是设置环境变量 GITHUB_ENDPOINT,指向一个 GitHub 反向代理前缀。环境变量必须在启动 ComfyUI 之前生效,改完完全重启 ComfyUI。注意反向代理服务的可用性会变化,若某个镜像不可用需更换。# 官方文档示例GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com# Windows 永久设置setx GITHUB_ENDPOINT https://mirror.ghproxy.com/https://github.com# Linuxexport GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com
- 单独给 git 配置代理(不依赖系统代理)把 git 自己的 http/https 代理指向本地代理端口,这样 git clone 才真正走代理。若代理只对特定域名生效,可用 http.<url>.proxy 精确指定。git config --global http.proxy http://127.0.0.1:7890git config --global https.proxy http://127.0.0.1:7890# 取消git config --global --unset http.proxy
- 代理不通时改为手工下载 ZIP 并正确解压到 custom_nodes在能访问的网络里下载节点仓库的 ZIP,解压到 ComfyUI/custom_nodes 下,注意目录名必须是仓库名本身,不要留下 -main 后缀,也不要出现双层同名目录,否则 Manager 会识别异常(官方文档专门列出了这几类错误装法)。
验证是否修好
重启 ComfyUI 后重新在 Manager 里安装同一个节点,安装日志不再出现 Failed to connect to github.com;节点出现在 custom_nodes 下且被正常加载。手工安装的则确认路径形如 custom_nodes/<仓库名>/__init__.py。
补充说明
issue #1766 只有报错、没有维护者回复,因此解决方式取自 Manager 官方文档的 GITHUB_ENDPOINT 说明与官方安装路径要求;同仓库 issue #1697 也反映了「在系统变量里设置了 GitHub 镜像变量但不生效」的困惑,注意务必在启动 ComfyUI 前生效。
来源
按可信度排列:官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。
链接以纯文本给出(本站不做站外跳转),需要核对时请自行复制到浏览器打开。
- [171] (节点仓库 issue) ComfyUI-Manager??why · Issue #1766 · Comfy-Org/ComfyUI-Manager https://github.com/Comfy-Org/ComfyUI-Manager/issues/1766
- [162] (官方文档) ComfyUI Manager 故障排除(GitHub 访问问题 / 安装路径不正确) - ComfyUI https://docs.comfy.org/zh/manager/troubleshooting
- [172] (节点仓库 issue) About Github Mirror · Issue #1697 · Comfy-Org/ComfyUI-Manager https://github.com/Comfy-Org/ComfyUI-Manager/issues/1697
这条报错要用到的东西
按本条报错所属的类别(网络、下载与访问(含国内网络环境))列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」,而是这一类问题里最常要动到的东西;具体怎么做,以上面的解决步骤为准。
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 等)
含未核实
这个解法对你有效吗
记录只存在你自己的浏览器里,不需要注册账号。
知仓学习社