宝塔面板pip安装卡在“Retrying”或ConnectionTimeout，主因是默认PyPI源不可达，豆瓣源自2025年底起频繁503/证书错误，华为云源存在地域限速与IP拦截，清华源或中科大源更稳定可靠。
宝塔面板里 pip 安装总卡在 “Retrying” 或直接报 ConnectionTimeout，不是网络问题，而是默认源根本连不上——必须换国内镜像源，豆瓣源已基本不可用，华为云源目前不稳定，清华源或中科大源更可靠。
为什么豆瓣源和华为云源在宝塔里容易失效
豆瓣源 http://pypi.douban.com/simple/ 自 2025 年底起频繁返回 503 或证书错误，宝塔 Python 项目管理器调用 pip 时不会自动加 --trusted-host，导致握手失败；华为云源 https://repo.huaweicloud.com/repository/pypi/simple/ 虽支持 HTTPS，但其 CDN 节点对宝塔所在服务器（尤其是低配轻量云）存在地域性限速，实测超时率高于清华源 3 倍以上。
常见错误现象包括：Read timed out、Unable to fetch URL、SSLError: certificate verify failed。
- 豆瓣源不建议再用于生产环境，临时测试可加
--trusted-host pypi.douban.com，但仅治标 - 华为云源需额外配置
--trusted-host repo.huaweicloud.com，且仍可能因 IP 黑名单被拦截 - 宝塔的「依赖安装」框本质是执行 shell 命令，不读取用户级
pip.ini，必须显式带参数
宝塔 Python 项目管理器中直接生效的换源写法
在宝塔面板「Python 项目管理器」→ 对应项目 → 「依赖安装」栏中，**不要只写 pip install -r requirements.txt**，必须把镜像源和可信主机一次性写全：
立即学习“Python免费学习笔记（深入）”；
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn
这是唯一能在宝塔界面中稳定触发的方案。原因：宝塔调用的是项目绑定的 Python 解释器下的 pip，且以非交互方式执行，不加载全局配置。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 若用中科大源，替换为
-i https://pypi.mirrors.ustc.edu.cn/simple/ --trusted-host pypi.mirrors.ustc.edu.cn - 如果项目含二进制包（如
numpy、torch），清华源兼容性优于中科大源，优先选前者 - 避免混用多个
-i，pip 不支持多源 fallback，只会用最后一个
永久生效但需 SSH 配合的 pip 配置
如果想让宝塔后台所有 Python 项目（包括后续新建的）都默认走国内源，得登录服务器改 pip 的 site 级配置——因为宝塔的 Python 环境通常独立于系统 Python，且用户级配置（%APPDATA%\pip\pip.ini 或 ~/.pip/pip.conf）对它无效。
操作路径（以宝塔常用路径为例）：
- 先确认项目用的 Python 路径：
which python或看宝塔项目设置里的「Python 版本」，常见如/www/server/python/bin/python - 找到对应 pip 可执行文件：
/www/server/python/bin/pip - 执行：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/ - 再执行：
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
注意：该配置写入的是 /www/server/python/pip.conf（site 配置），不是用户目录。如果 pip 报 command not found，说明要用完整路径：/www/server/python/bin/pip config set ...。
超时仍发生？检查这三点
换源后还超时，大概率不是源的问题，而是宝塔或服务器层面的限制：
- 宝塔防火墙是否放行了 outbound HTTPS（443）？某些厂商云默认限制出站连接
- 服务器 DNS 是否异常？在终端执行
nslookup pypi.tuna.tsinghua.edu.cn，看能否解析出 IPv4 地址 - 宝塔 Python 环境是否被手动降级过？
pip --version应 ≥ 22.0；低于此版本不支持config子命令，需先升级：python -m pip install --upgrade pip
最易忽略的一点：宝塔「Python 项目管理器」的「依赖安装」按钮背后会加 --no-cache-dir，这会导致每次重下 wheel，增大超时概率——如果你确认网络稳定，可在命令末尾手动加 --cache-dir /tmp/pip_cache 缓解。
