启动或加载工作流时连不上 huggingface.co，控制台报最大重试次数已超过

Cannot connect to host huggingface.co:443 ssl:default [信号灯超时时间已到]

现象与触发场景

常见触发场景：

• 国内网络直连 huggingface.co 被墙或极慢
• 用公司/校园网，出口对该域名不可达
• 本地开了代理软件但 ComfyUI 进程没有走代理
• 首次运行需要自动下载模型权重（如人脸识别、打标、CLIP 等）

根因

• huggingface.co 及其 CDN（cdn-lfs.hf.co 等）在部分网络环境下不可达或丢包严重，请求在 TCP/TLS 阶段就超时，重试若干次后抛出 MaxRetryError。
• 自定义节点的代码里写死了 https://huggingface.co 地址（很多是 huggingface_hub 的 snapshot_download / hf_hub_download 默认端点），不会读系统代理设置，因此只在浏览器里挂梯子不生效。
• 把代理只设成了用户级环境变量而 ComfyUI 已由别的会话启动，进程环境里没有 http_proxy/https_proxy。

解决步骤

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

1. 改用国内 Hugging Face 镜像端点（首选，非侵入式）
   huggingface_hub 工具链会读取 HF_ENDPOINT 环境变量来决定下载地址，把它指向国内镜像即可让所有基于 huggingface_hub 的下载走镜像站。Linux/macOS 写入 shell 配置持久化，Windows 用 setx 写入用户环境变量；改完必须完全重启 ComfyUI（连同启动器/终端窗口），只重启网页无效。
   # Linux / macOS（写入 ~/.bashrc 或 ~/.zshrc 后 source 生效）
   export HF_ENDPOINT=https://hf-mirror.com
   # Windows PowerShell（当前会话）
   $env:HF_ENDPOINT = "https://hf-mirror.com"
   # Windows CMD（永久，需重开终端与 ComfyUI）
   setx HF_ENDPOINT https://hf-mirror.com
   # 临时、非侵入式：只对这一次运行生效
   HF_ENDPOINT=https://hf-mirror.com python main.py
2. 给 ComfyUI 进程显式设置 HTTP 代理
   如果已经有一个可用的本地代理，把代理写进 ComfyUI 的启动环境，而不是只依赖系统代理。Windows 便携版直接改 run_nvidia_gpu.bat（先备份再改），在调用 python 之前加 set 行；同时用 no_proxy 把本机地址排除，避免 ComfyUI 自己访问 127.0.0.1:8188 也被代理。改完请用这个 bat 启动，不要从其他快捷方式启动。
   :: Windows 便携版 run_nvidia_gpu.bat，加在 python_embeded 调用之前
   set http_proxy=http://127.0.0.1:7890
   set https_proxy=http://127.0.0.1:7890
   set no_proxy=localhost,127.0.0.1
   # Linux
   export http_proxy=http://127.0.0.1:7890
   export https_proxy=http://127.0.0.1:7890
   export no_proxy=localhost,127.0.0.1
3. 绕开在线下载：手动下载模型并放入节点指定目录
   对于节点在启动/首次运行时自动拉取的小模型（人脸识别、打标模型等），最稳的办法是自己在能访问的机器或镜像站上下载好，按节点 README 或日志提示的目录放进去，让它走本地缓存路径。日志里通常会打印 "Downloading ... to: <路径>"，把文件放到那个路径即可。

验证是否修好

补充说明

issue #5184 报告者只贴了报错、未给出解决结论（issue 状态为 closed/Stale），因此该条目的解决方案取自官方 Manager 文档的 HF_ENDPOINT 说明、hf-mirror 官方用法页与社区实践。注意 hf-mirror 不支持登录，Gated 仓库需要先在官网申请许可并取 token。

来源

1. [160] （官方 issue）　Cannot connect to host huggingface.co:443 ssl:default [信号灯超时时间已到] · Is　https://github.com/Comfy-Org/ComfyUI/issues/5184
2. [161] （官方文档）　🤗 HF-Mirror — 如何使用HF-Mirror　https://hf-mirror.com/
3. [162] （官方文档）　ComfyUI Manager 故障排除 - ComfyUI　https://docs.comfy.org/zh/manager/troubleshooting

这条报错要用到的东西

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

同一类别的其他条目

返回报错库