Python pip国内镜像源地址大全：清华、阿里、腾讯等常用URL

键盘旁的猫

发布时间：2026-10-23| 6人浏览过

原创

在默认情况下，Python 的包管理工具 pip 会从官方的 PyPI 服务器（pypi.org）拉取安装包。由于官方源部署在境外，国内直接下载常因跨国链路高延迟或网络波动出现连接超时、下载龟速甚至构建失败等情况。使用国内高校和头部云厂商提供的镜像源，能够直接将下载节点切换到国内高速 CDN，提升安装速度与构建稳定性。本文汇总主流镜像源地址，并详解单次使用、全局配置以及多系统配置路径。

图 1：pip 直连官方源与国内镜像源的网络请求与传输对比

一、常用国内镜像源地址汇总

国内的开源镜像站主要由高校开源软件镜像团队和头部云服务商维护，与 PyPI 官方保持定期同步。在配置或使用时，请务必完整输入包含 /simple 后缀的标准地址，因为该接口遵循 PEP 503 规范（Simple Repository API），pip 需要通过该路径获取索引与包元数据。

机构 / 平台	完整镜像源 URL（包含 simple 路径）	网络特点与建议场景
清华大学 (TUNA)	`https://pypi.tuna.tsinghua.edu.cn/simple`	教育网与综合公网带宽充裕，更新频率高，个人开发推荐
阿里云	`https://mirrors.aliyun.com/pypi/simple/`	阿里骨干 CDN 节点广，电信、联通、移动访问稳定，生产环境首选
腾讯云	`https://mirrors.cloud.tencent.com/pypi/simple/`	腾讯云服务器内网互通免公网流速限制，公网带宽也极充裕
华为云	`https://repo.huaweicloud.com/repository/pypi/simple/`	电信和华南华北网络体验极佳，企业级基础设施保障稳定
中国科学技术大学	`https://pypi.mirrors.ustc.edu.cn/simple/`	国内老牌镜像站，华东地区和高校科研网络访问速度出色
豆瓣 (Douban)	`https://pypi.douban.com/simple/`	历史较早的 Python 专用镜像源，轻量快速，但同步机制更偏被动缓存

注意事项：大部分镜像源使用 HTTPS 协议，且地址末尾带有 /simple 或 /simple/。若漏写该层级，pip 访问主页将无法正确解析索引列表，直接抛出 404 或 Invalid Requirement 异常。

二、单次临时使用镜像源安装

在排查环境问题、临时测试特定库或者不希望改变系统全局配置时，可以通过命令行参数 -i（或 --index-url）在单次安装命令中指定镜像源。

基本语法格式如下：

pip install <包名> -i <镜像源URL>

例如安装 requests 并指定清华大学镜像源：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

如果镜像站因内部网络环境证书链不完整，或用户在内网环境使用自建源触发 SSL 证书校验错误时，可补充 --trusted-host 参数将该域名添加为受信主机：

pip install requests -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com

注意：--trusted-host 后面只需填写主机域名或 IP（例如 pypi.tuna.tsinghua.edu.cn），不要包含 https:// 协议头或 /simple 路径。

三、永久配置镜像源的方法

频繁在命令行中拼接 -i 参数较为繁琐，建议将常用镜像源写入 pip 的持久配置文件。自 pip 10.0.0 版本起，官方提供了原生的 pip config 子命令，无需手动创建文件即可自动写入。

图 2：通过 pip config 命令持久化写入国内源的三个标准步骤

1. 使用命令行一键设置（推荐）

打开终端（Windows 系统的 CMD 或 PowerShell，macOS / Linux 的 Terminal），执行以下两条命令：

# 设置镜像源为清华大学
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 设置该域名为受信任主机
pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn

若计划使用阿里云镜像源，则对应替换为：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip config set install.trusted-host mirrors.aliyun.com

2. 手动创建或编辑配置文件

如果不便使用命令行，可以直接在文件系统指定路径创建配置文件。不同操作系统存放配置文件的默认路径不同：

图 3：Windows、Linux 与 macOS 的 pip 配置文件默认路径与命名规格

无论在哪个系统中，配置文件的文本格式均为 INI 结构。打开文本编辑器，填入以下内容并保存：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
timeout = 120

[install]
use-wheel = true

配置项说明：

index-url：基础包检索与下载主地址。
trusted-host：允许未经过本地信任根证书严格校验的主机白名单。
timeout：请求超时限制（单位为秒），网络不佳时可设大到 120。

四、验证与常见排查处理

1. 确认当前生效配置

运行以下命令可以打印 pip 当前加载的全部配置项及所属范围：

pip config list

预期输出示例：

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

若需要排查某个具体包是从哪一个地址下载的，可以执行带有详细日志标记 -v 的命令：

pip install requests -v

在控制台输出中搜索 Looking in indexes: ...，即可确认 pip 是否命中了设定的国内镜像源。

2. 常见问题排查与解决

SSL/TLS 证书错误（SSLError: certificate verify failed）：
常见于较旧的 Python 版本（缺少更新的 certifi 证书包）或公司内部安装了 HTTPS 解密根证书的场景。解决方法是在配置文件中明确加入 trusted-host = <对应域名>，跳过该特定域名的证书链校验。
部分新发布的包在镜像站提示 404：
镜像站需要周期性同步上游 PyPI 的全量索引。对于作者刚发布几分钟内的新版本包，镜像站可能尚未同步。此时可用临时命令 pip install <包名> -i https://pypi.org/simple 强制走官方源拉取，或等待 10~30 分钟同步完成。
清理损坏的 pip 本地缓存：
切换源后若曾发生中断，可能留存不完整的 wheel 文件导致后续安装反复报错，可运行缓存清理命令：
```
pip cache purge
```
还原默认官方源：
若日后需要切回官方 PyPI 源，只需注销该配置项：
```
pip config unset global.index-url
pip config unset install.trusted-host
```