ARTICLE · 1138896

零基础国漫创作入门指南 -- 装插件总卡住?先给 pip 换个国内源

发布时间：2026-10-08 10:58:42 最近访问：2026-10-08 10:58:43

本篇目标

读完这篇，你要能做到：

知道为什么 pip 要换国内源。
用一条命令把 ComfyUI 便携版的 pip 源永久改成清华源。
验证镜像是否生效。
知道清华源不行时，怎么切换到阿里源或中科大源。
遇到 Read timed out、SSL 报错时能快速排查。

前置条件

已完成第 3 篇（AMD）或第 4 篇（NVIDIA），ComfyUI 能正常启动。
知道你的 ComfyUI 安装路径，例如 D:\ComfyUI 或 D:\ComfyUI_NVIDIA。
能找到 python_embeded 文件夹。

保姆级步骤：一步一图一命令

第 1 步：先搞懂为什么要换 pip 源

pip 是 Python 的包管理工具。ComfyUI 装插件、装依赖，背后都是 pip 在干活。

pip 默认从官方 PyPI 仓库下载包，地址是 https://pypi.org/simple/。这个服务器在国外，国内访问要经过跨境链路。

2026 年 8 月的一份实测数据显示，拉取 numpy 包的索引页（约 1.2MB）：

源	耗时	结果
腾讯云	548 ms	成功
清华 TUNA	555 ms	成功
阿里云	756 ms	成功
PyPI 官方	超过 30000 ms	超时失败

官方源不是“慢一点”，而是在 30 秒超时窗口内根本拉不完包列表。这就是你会看到 Read timed out 的根本原因。

换源就是把 PyPI 上的包完整复制一份放到国内服务器上，你直接从国内取。内容一致，距离近了，速度就上来了。

第 2 步：先验证当前 pip 源

这一步确认你的 pip 当前用的是哪个源。

打开命令提示符（CMD），进入你的 ComfyUI 根目录。AMD 用户：

cd /d D:\ComfyUI

NVIDIA 用户：

cd /d D:\ComfyUI_NVIDIA

然后用便携版内置的 Python 来跑 pip：

.\python_embeded\python.exe -m pip config list

如果输出是空的，或者显示 index-url 指向 pypi.org，说明还在用官方源。

注意：不要直接敲pip config list。你系统里可能没有独立的 pip，或者有多个 Python 版本导致混淆。用 .\python_embeded\python.exe -m pip 才能确保操作的是 ComfyUI 便携版内置的 pip 环境。

第 3 步：一条命令换成清华源

这一步是核心操作。在 ComfyUI 根目录下，运行：

.\python_embeded\python.exe -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

再运行第二条，声明信任该镜像主机，避免 SSL 证书报错：

.\python_embeded\python.exe -m pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

两条命令都要跑。第一条换源地址，第二条解决证书信任。少跑第二条，后面可能遇到 SSL: CERTIFICATE_VERIFY_FAILED 报错。

执行成功后，pip 会自动在配置文件中写入这两项设置。

第 4 步：验证镜像是否生效

再跑一次：

.\python_embeded\python.exe -m pip config list

正常应该输出：

global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'global.trusted-host='pypi.tuna.tsinghua.edu.cn'

看到这两行，说明配置成功。

第 5 步：实测一下速度

装一个小包试试：

.\python_embeded\python.exe -m pip install requests

如果之前装过 requests，会显示 Requirement already satisfied。换一个包：

.\python_embeded\python.exe -m pip install rich

正常情况下，几秒内就能装完。如果还是卡住，回到第 2 步检查配置，或者看下面的常见坑。

第 6 步：备选源——清华不行换阿里

清华源偶尔会维护或临时不可用。这时候换阿里源，配置方法一模一样，只换 URL：

.\python_embeded\python.exe-mpipconfigsetglobal.index-urlhttps://mirrors.aliyun.com/pypi/simple/.\python_embeded\python.exe-mpipconfigsetglobal.trusted-hostmirrors.aliyun.com

其他可选源：

源	index-url	trusted-host
清华 TUNA	https://pypi.tuna.tsinghua.edu.cn/simple	pypi.tuna.tsinghua.edu.cn
阿里云	https://mirrors.aliyun.com/pypi/simple/	mirrors.aliyun.com
中科大	https://pypi.mirrors.ustc.edu.cn/simple	pypi.mirrors.ustc.edu.cn
腾讯云	https://mirrors.cloud.tencent.com/pypi/simple	mirrors.cloud.tencent.com
华为云	https://repo.huaweicloud.com/repository/pypi/simple	repo.huaweicloud.com

这张表建议截图保存。

第 7 步：如果 pip config 命令不生效，手动改配置文件

少数情况下，pip config set 可能写入的不是你期望的文件。这时候手动编辑。

方法一：找到 pip.ini 的位置

在 ComfyUI 根目录下运行：

.\python_embeded\python.exe -m pip config debug

输出里会显示 pip 读取的配置文件路径。通常在：

D:\ComfyUI\python_embeded\pip.ini

或者：

C:\Users\你的用户名\AppData\Roaming\pip\pip.ini

方法二：直接创建 pip.ini

在 python_embeded 文件夹下新建一个 pip.ini 文件（用记事本），写入：

[global]index-url = https://pypi.tuna.tsinghua.edu.cn/simpletrusted-host = pypi.tuna.tsinghua.edu.cntimeout = 120

保存，关闭，再跑 pip config list 确认。

注意：如果你系统里同时有多个 pip 配置文件（比如用户级的 %APPDATA%\pip\pip.ini 和 ComfyUI 便携版自己的），它们可能互相覆盖。如果你在用户级配置过其他 Python 的 pip 源，建议在 ComfyUI 的 python_embeded 目录下单独放一份 pip.ini，确保便携版用自己的一份。

第 8 步：如果 pip 源已改好，但装插件还是卡

有些 ComfyUI 插件不只用 pip 装依赖，还会从 GitHub 克隆仓库，或者从 HuggingFace 下载模型。pip 源只管 Python 包，管不了 GitHub 和 HuggingFace。

GitHub 卡住 → 第 8 篇讲 GitHub 加速。
HuggingFace 卡住 → 第 7 篇讲 HF 镜像。
插件本身在 ComfyUI Manager 里装不动 → 第 8 篇讲 Manager 配置。

所以这篇先把 pip 这一关过了，后面两关再一个一个解决。

常见坑

坑 1：Read timed out

报错原文：

pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='pypi.org', port=443): Read timed out.

原因：pip 还在用官方源，跨境链路超时。

解决：回到第 3 步，把清华源配上。如果已经配了还是报这个错，检查 pip config list 输出是否真的显示了清华源的地址。如果显示的还是 pypi.org，说明配置没写进去，用手动改 pip.ini 的方式重新配。

坑 2：SSL 证书报错

报错原文：

WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.

或者：

SSLError: Can't connect to HTTPS URL because the SSL module is not available.

原因：缺少 trusted-host 配置，或者便携版 Python 的 SSL 模块加载异常。

解决：先确认第 3 步的第二条命令跑了：

.\python_embeded\python.exe -m pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

如果还是报 SSL 错，临时在安装命令里加 --trusted-host：

.\python_embeded\python.exe -m pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn

注意 --trusted-host 后面填的是域名，不带 https://，也不带路径。

坑 3：pip config 命令找不到

报错原文：

ERROR: unknown command "config"

原因：pip 版本太旧，低于 10.0。

解决：先升级 pip：

.\python_embeded\python.exe -m pip install --upgrade pip

然后再跑 pip config set 命令。

坑 4：配置生效了，但装某个包还是走官方源

报错原文：无固定报错，表现为安装速度忽快忽慢。

原因：项目根目录下存在 .pip 文件夹里的局部配置，覆盖了全局设置。

解决：检查 ComfyUI 根目录下是否有 pip.ini 或 .pip 文件夹。如果有，删掉或者改成和全局一致。也可以加 --no-cache-dir 禁用缓存后重试。

坑 5：公司/学校网络限制了镜像源

报错原文：

Could not fetch URL https://pypi.tuna.tsinghua.edu.cn/simple/: connection error

原因：内网防火墙或代理屏蔽了外部镜像源。

解决：尝试把 https 改成 http，或者换一个源试试（阿里源、腾讯云源通常在内网兼容性更好）。如果都不行，可能需要联系网络管理员。

本篇目标

前置条件

保姆级步骤：一步一图一命令

第 1 步：先搞懂为什么要换 pip 源

第 2 步：先验证当前 pip 源

第 3 步：一条命令换成清华源

第 4 步：验证镜像是否生效

第 5 步：实测一下速度

第 6 步：备选源——清华不行换阿里

第 7 步：如果 pip config 命令不生效，手动改配置文件

第 8 步：如果 pip 源已改好，但装插件还是卡

常见坑

坑 1：Read timed out

坑 2：SSL 证书报错

坑 3：pip config 命令找不到

坑 4：配置生效了，但装某个包还是走官方源

坑 5：公司/学校网络限制了镜像源

相关学习资料