知仓学习社知仓学习社
Manager 列表刷不出来：Due to a network error, switching to local mode（含 SOCKS 代理场景） / 全站资源搜索
搜索 更新 2026-10-02
报错 074 网络、下载与访问（含国内网络环境） 有来源可查

Manager 列表刷不出来：Due to a network error, switching to local mode（含 SOCKS 代理场景）

报错原文（原样） 
[ComfyUI-Manager] Due to a network error, switching to local mode.
=> extension-node-map.json
=> [WinError 64] The specified network name is no longer available
检索关键词 Due to a network error, switching to local mode、FETCH DATA from、[WinError 64] The specified network name is no longer available、extension-node-map.json、SOCKS proxy、PySocks
先看这一句 打开 ComfyUI-Manager 时 Custom Nodes Manager 加载不出来或列表是旧的，控制台反复打印 FETCH DATA 失败并退回本地模式；列表停留在缓存版本，搜不到新节点。
适用版本 全版本通用；Manager 各版本均保留本地模式回落行为 · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • 使用 SOCKS 代理（如 socks5://127.0.0.1:1080），Manager 的请求走不通
  • raw.githubusercontent.com 被墙，Manager 拉取 extension-node-map.json 失败
  • 代理只对部分域名生效，GitHub 相关域名没被代理覆盖

根因

  • Manager 启动时需要从网络获取 extension-node-map.json、custom-node-list.json 等数据库；请求失败时它的设计是回落到本地缓存文件，所以界面看着能用、但数据是旧的。
  • Manager 的 HTTP 请求对 SOCKS 代理支持有限，出现 WinError 64（网络名不再可用）这类底层 socket 错误时会被判定为网络失败并切本地模式。
  • raw.githubusercontent.com 与 api.github.com 往往是比 github.com 更容易被拦的域名，容易出现「网页能开、Manager 拉不到」的情况。

解决步骤

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

  1. 把 SOCKS 代理换成 HTTP 代理再试
    Manager 的请求链路对 SOCKS 支持不佳，出现 WinError 64/SOCKS 相关失败时，改用 HTTP 代理端口（例如把 socks5 换成同一代理软件提供的 http 端口）通常能直接恢复。若必须用 SOCKS，注意 PySocks 是否已安装。
    set http_proxy=http://127.0.0.1:7890
    set https_proxy=http://127.0.0.1:7890
  2. 配置 GITHUB_ENDPOINT / HF_ENDPOINT 走镜像
    让 Manager 从可访问的镜像拉数据库与节点，避免直连 raw.githubusercontent.com。改完完全重启 ComfyUI。
    setx GITHUB_ENDPOINT https://mirror.ghproxy.com/https://github.com
    setx HF_ENDPOINT https://hf-mirror.com
  3. 用离线模式/本地缓存兜底，并注意缓存更新时间
    Manager 的 config.ini 支持 network_mode = public|private|offline：offline 表示不建外部连接、可用则用缓存。网络不稳时把它设为 offline 可以避免长时间卡在 FETCH DATA 上，但要清楚此时节点列表来自本地缓存，可能不是最新的。
    # <USER_DIRECTORY>/__manager/config.ini（v0.3.76 及以后）
    network_mode = offline

验证是否修好

重启 ComfyUI 后打开 Manager：控制台不再出现 Due to a network error, switching to local mode，且日志里能看到 FETCH DATA ... [DONE]；节点列表能搜到较新的节点。

补充说明

issue #1763 报告了 SOCKS 代理下 WinError 64 的具体日志，属真实原文；其自身状态为 open、无维护者定论，因此解决方案以官方 config.ini 的 network_mode 文档、GITHUB_ENDPOINT 文档和社区实践为准。network_mode 的取值与语义引自 docs.comfy.org 的 Manager 配置页。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [175] （节点仓库 issue）　SOCKS proxy: `[WinError 64] The specified network name is no longer av　https://github.com/Comfy-Org/ComfyUI-Manager/issues/1763
  2. [176] （官方文档）　ComfyUI-Manager 配置（config.ini / network_mode / GITHUB_ENDPOINT / HF_EN　https://docs.comfy.org/zh/manager/configuration

这条报错要用到的东西

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

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 等） 含未核实
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库