Python包管理：pip镜像源配置指南
Jun 10, 2025·
·
1 min read
Orochi
Python包管理镜像源配置指南
1. 国内主流镜像源
以下是中国地区可靠的PyPI镜像源：
| 镜像源 | 地址 | 特点 |
|---|---|---|
| 清华大学 | https://pypi.tuna.tsinghua.edu.cn/simple | 最受欢迎，更新快，推荐使用 |
| 阿里云 | https://mirrors.aliyun.com/pypi/simple/ | 稳定性好，速度快 |
| 腾讯云 | https://mirrors.cloud.tencent.com/pypi/simple | 服务稳定，全国多节点 |
| 网易 | https://mirrors.163.com/pypi/simple/ | 更新及时，连接稳定 |
| 中国科技大学 | https://pypi.mirrors.ustc.edu.cn/simple/ | 教育网访问快 |
2. 配置方法
2.1 临时使用
# 安装单个包时使用指定镜像源
pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple
# 安装requirements.txt中的包
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
2.2 永久配置
- 命令行配置
# 设置默认镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 设置受信任域名
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
- 配置文件方式
创建或编辑配置文件：
- Linux/MacOS:
~/.pip/pip.conf - Windows:
%APPDATA%\pip\pip.ini
[global]
# 主镜像源
index-url = https://mirrors.cloud.tencent.com/pypi/simple
# 备用镜像源
extra-index-url =
https://pypi.tuna.tsinghua.edu.cn/simple
https://mirrors.aliyun.com/pypi/simple/
# 信任的主机
trusted-host =
mirrors.cloud.tencent.com
pypi.tuna.tsinghua.edu.cn
mirrors.aliyun.com
3. 高级配置
3.1 多镜像源配置
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
extra-index-url =
https://mirrors.aliyun.com/pypi/simple/
https://mirrors.cloud.tencent.com/pypi/simple
[install]
trusted-host =
pypi.tuna.tsinghua.edu.cn
mirrors.aliyun.com
mirrors.cloud.tencent.com
3.2 企业内网配置
[global]
index-url = http://pypi.company.com/simple
trusted-host = pypi.company.com
cert = /path/to/certificate.crt
4. 最佳实践
-
镜像源选择
- 选择地理位置近的镜像源
- 定期测试镜像源速度
- 配置多个备用源
-
安全考虑
- 使用https源
- 配置trusted-host
- 定期更新证书
-
性能优化
- 使用缓存
- 并行下载
- 定期清理缓存
5. 常见问题解决
- SSL证书问题
# 临时忽略SSL验证
pip install package_name --trusted-host pypi.org --trusted-host files.pythonhosted.org
- 镜像源超时
# 设置超时时间
pip install package_name --timeout 100
- 缓存问题
# 清理pip缓存
pip cache purge
