pip自定义镜像地址

pip 在不同网络环境下,可以临时制定pypi镜像地址来加速包下载。


正确写法(信任阿里云 PyPI 镜像):

1
2
3
4
5
6
7
8
9
10
# 互联网地址
pip install -i https://mirrors.aliyun.com/pypi/simple some_package

pip install -r xx.txt -i https://mirrors.aliyun.com/pypi/simple/

pip install -r xx.txt -i https://pypi.tuna.tsinghua.edu.cn/simple


# vpc加速地址(仅支持http)
pip install -i http://mirrors.cloud.aliyuncs.com/pypi/simple --trusted-host mirrors.cloud.aliyuncs.com some_package

说明:

  • -i 指定 PyPI 镜像地址(使用 HTTP 时要配合 --trusted-host,否则会报错)
  • --trusted-host 明确告诉 pip 信任这个地址,否则默认会警告或拒绝非 HTTPS 请求

安装一个包:

1
pip install -i http://mirrors.cloud.aliyuncs.com/pypi/simple --trusted-host mirrors.cloud.aliyuncs.com requests

配置为默认源

编辑或创建 ~/.pip/pip.conf(Linux/macOS)或 %APPDATA%\pip\pip.ini(Windows),加入:

1
2
3
[global]
index-url = http://mirrors.cloud.aliyuncs.com/pypi/simple
trusted-host = mirrors.cloud.aliyuncs.com