报错
101
热门自定义节点/工作流专有报错
含未核实说明
ComfyUI-Manager 连不上 Comfy Registry,刷新缓存失败
报错原文(原样)
Cannot connect to comfyregistry
检索关键词
Cannot connect to comfyregistry、ComfyRegistry cache update、outdated cache、fetch failed、registry.comfy.org
先看这一句
打开 Manager 时日志里刷出 Cannot connect to comfyregistry,或者提示 ComfyRegistry 缓存更新仍在进行、正在使用过期缓存;节点列表不全、搜不到包、Install Missing Custom Nodes 也点不动。
适用版本 新版 ComfyUI-Manager(迁移到 Comfy Registry 之后)才会出现;旧版走 GitHub 列表的写法不会有这条报错,但会有对应的 GitHub 连接失败
·
核实日期 2026-09-26
·
状态 可能已过期,正在复核
适用环境:Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、全部主流环境
现象与触发场景
常见触发场景:
- 国内网络直连 registry.comfy.org 超时(最常见)
- 使用了 SOCKS/HTTP 代理,代理配置与 ComfyUI 不匹配
- 维护期或 registry 服务端临时故障,本地缓存又过期
根因
- Manager 新版的节点目录来自 Comfy Registry(registry.comfy.org)这个在线服务,首次启动/缓存过期时要联网拉取;网络不通或代理不生效就会抛连接失败,同时回退到陈旧缓存
- 系统级代理只对浏览器生效,Python 进程没有读到代理环境变量,或者用户配的是 SOCKS 代理而 requests 未装对应支持,报出 WinError 64 这类网络名不可用错误
- 缓存文件被写坏后 Manager 会一直重复拉取并持续报错
解决步骤
已按「最可能有效」排序。请从上往下做,每做完一步用「验证」确认,不要一次改五处。
- 先确认是网络问题:给 Python 进程显式设置代理后再启动Manager 是在 ComfyUI 的 Python 进程内发请求的,浏览器能上网不代表它也能。在启动 ComfyUI 的那个命令行窗口里,先设置 HTTP_PROXY/HTTPS_PROXY 环境变量,再运行启动脚本;如果用的是 Clash 等本地代理,端口按自己软件里显示的实际端口填。设置完必须用这个窗口启动,不要在别的窗口启动。set HTTP_PROXY=http://127.0.0.1:7890set HTTPS_PROXY=http://127.0.0.1:7890python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build
- 换用国内镜像的 Manager 数据源 / 改用 Manager 的离线模式Manager 的设置里可以把节点数据源与 pip 源指向国内镜像(Manager 设置界面的 Channel / pip mirror 相关项)。ComfyUI 官方 Manager 文档专门有一节 Troubleshooting 讲连接失败的处理,先按文档核对设置再考虑重装。若只是想让工作流先跑起来,可以先用 Manager 的本地已装节点模式,不依赖在线目录。
- 删除损坏的 ComfyRegistry 缓存让其重新拉取Manager 会把 Registry 目录缓存在本地(Manager 目录下的 cache/ 相关文件)。先完全关闭 ComfyUI,再删除缓存文件/目录,然后重新启动;启动时保持代理可用,Manager 会重新完整拉取一次。若反复失败,退回安装较新版本的 ComfyUI-Manager 再试。
- 绕过 Manager,直接 git clone 节点(永久可用的兜底方案)Manager 的在线目录只是便利功能,节点本体都在 GitHub。知道仓库地址就直接克隆进 custom_nodes,再用便携版解释器装依赖,完全不依赖 Comfy Registry。这也是断网环境下的标准做法。cd ComfyUI\custom_nodesgit clone https://github.com/<作者>/<仓库名>.git..\..\python_embeded\python.exe -m pip install -r <仓库名>\requirements.txt
验证是否修好
重启后 Manager 日志不再出现 Cannot connect to comfyregistry,节点列表能正常刷新到最新版本号,Install Missing Custom Nodes 能列出可安装项。
补充说明
error_text 取自 Comfy-Org/ComfyUI-Manager issue #2423 标题原文(该 issue 讨论这条报错被当成已关闭问题但仍在复现)。另有 issue #1763 标题为 'SOCKS proxy: [WinError 64] The specified network name is no longer available',属于同一根因的代理分支。Manager 设置项的精确名称与缓存目录名未在搜索结果中逐字确认,标 [未核实],故按功能描述给出而非写死路径。另附一条同属 Manager 的低危日志噪音:issue #12742 记录过 'ComfyUI per-queue preview override detected'(同页真实报错原文为 'Error:DWPreprocessor'),根因是 Manager 的预览覆盖与启动参数 --preview-method 冲突(上游已有修复提交 'Don't override preview method if --preview-method is given');这类提示本身不致命,看到时应以日志里第一条 Traceback 为准去定位真正失败的节点。
来源
按可信度排列:官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。
链接以纯文本给出(本站不做站外跳转),需要核对时请自行复制到浏览器打开。
- [226] (节点仓库 issue) "Cannot connect to comfyregistry" - this is still throwing errors (des https://github.com/Comfy-Org/ComfyUI-Manager/issues/2423
- [175] (节点仓库 issue) SOCKS proxy: [WinError 64] The specified network name is no longer ava https://github.com/Comfy-Org/ComfyUI-Manager/issues/1763
- [80] (官方文档) ComfyUI Manager Troubleshooting - ComfyUI Documentation https://docs.comfy.org/manager/troubleshooting
本条的可靠性边界
下面这些位置带
[未核实] 标记,是采集时没找到一手来源的部分,请自行验证:
- 补充说明
这条报错要用到的东西
按本条报错所属的类别(热门自定义节点/工作流专有报错)列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」,而是这一类问题里最常要动到的东西;具体怎么做,以上面的解决步骤为准。
同一类别的其他条目
【100】打开别人的工作流,节点全变红,提示节点缺少 class_type 属性
有来源
【102】ComfyUI-Impact-Pack 导入失败:No module named 'ultralytics'(缺少检测模型依赖)
有来源
【103】comfyui_controlnet_aux 导入失败:No module named 'timm'
有来源
【104】WanVideoWrapper:No module named 'sageattention'(SageAttention 未安装或装错环境)
含未核实
【105】VideoHelperSuite:ffmpeg is required for video outputs and could not be found
有来源
这个解法对你有效吗
记录只存在你自己的浏览器里,不需要注册账号。
知仓学习社