pip 安装依赖超时/极慢，节点安装卡在 pip install

ERROR: Could not install packages due to an OSError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Read timed out.
（注：以上为转述文本，非逐字原文。）

现象与触发场景

常见触发场景：

• 国内直连 pypi.org / files.pythonhosted.org 速度极慢
• 节点依赖体积很大（torch 相关、insightface 等）
• 便携版内置 Python 从未配置过镜像源

根因

• pip 默认从 pypi.org 拉包，其文件直链落在 files.pythonhosted.org，国内访问经常超时或断流，导致下载中途 Read timed out。
• pip 的镜像源需要通过 pip config 或 -i 参数指定，系统/浏览器代理不会自动作用到 pip；有些人只配了环境变量而没配 pip 配置，重启后失效。
• 对 torch 这类包还要区分 PyPI 镜像与 PyTorch 官方 wheel 源，单纯配 index-url 不一定覆盖全部依赖。

解决步骤

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

1. 永久配置 pip 镜像源（推荐清华 TUNA，也可用阿里云）
   用 pip config set global.index-url 写入 pip 配置文件，之后所有 pip install 都会走镜像，无需每次加参数。注意要针对 ComfyUI 实际使用的那个 python 执行（便携版必须用 python_embeded\python.exe，而不是系统的 python）。
   # Windows 便携版：用内置 Python 执行（路径按实际替换）
   python_embeded\python.exe -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
   # 通用写法
   pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
   # 阿里云镜像
   pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
   # 查看当前配置
   pip config list
2. 临时用 -i 指定镜像并加上超时/重试参数
   不想改全局配置时，可在单条安装命令上用 -i 指定镜像源。加上 --timeout 与 --retries 可以缓解偶发断流；对已下载一半的包，pip 会自动使用本地缓存重试。
   pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <包名> --timeout 60 --retries 5
3. 需要代理时给 pip 单独指定 --proxy
   如果镜像站也不通、必须走代理，curl/wget 类直连的 pip 需要用 --proxy 显式指定，或统一在启动环境里设置 http_proxy/https_proxy。注意 https 代理地址与 http 代理端口可能不同，以你的代理软件实际提供的为准。
   pip install --proxy http://127.0.0.1:7890 <包名>
   set https_proxy=http://127.0.0.1:7890
4. 安装完成后重启 ComfyUI 并确认依赖真的到位
   pip 装完不会热加载，必须重启 ComfyUI 才会导入新依赖。重启后看启动日志里该节点的 import 是否成功，仍失败则检查是不是装到了另一个 Python 环境（便携版最常见的坑是装进了系统 Python）。
   python_embeded\python.exe -m pip show <包名>

验证是否修好

补充说明

[未核实] 本条 error_text 为 pip 超时的通行英文措辞，未逐字取到 ComfyUI 场景原文，故 error_text_verbatim=false。镜像域名（pypi.tuna.tsinghua.edu.cn、mirrors.aliyun.com）为来源文章中出现的真实地址，但公开镜像服务策略可能调整，建议配置后用 pip config list 复核。ComfyUI-Manager 另有 pip_overrides.json / pip_auto_fix.list 机制可自定义包来源。

来源

1. [178] （中文社区）　关于comfyui的pip设置镜像源以及torch缓存位置更改 - 知乎　https://zhuanlan.zhihu.com/p/1946660222451052994
2. [179] （中文社区）　pip install 太慢总是超时？国内镜像源配置的 4 种方法　https://www.w3cschool.cn/article/63578772.html
3. [176] （官方文档）　ComfyUI-Manager 配置（use_uv / pip_overrides.json / pip_auto_fix.list） - 　https://docs.comfy.org/zh/manager/configuration

这条报错要用到的东西

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

同一类别的其他条目

返回报错库