pip 国内镜像源大全【测试 / 自动化开发常备】

pip 国内镜像源大全【测试 / 自动化开发常备】

    • [1. 常用国内镜像源(优选排序)](#1. 常用国内镜像源(优选排序))
    • [2. 3种使用方式](#2. 3种使用方式)
      • [1. 临时换源(仅当前命令生效)](#1. 临时换源(仅当前命令生效))
      • [2. 永久配置(全局生效)](#2. 永久配置(全局生效))
    • [3. 验证配置是否生效](#3. 验证配置是否生效)
    • [4. 国内镜像升级并查看当前pip版本](#4. 国内镜像升级并查看当前pip版本)
    • [5. 内网环境](#5. 内网环境)
    • [6. 恢复官方源](#6. 恢复官方源)

pip 官方源(PyPI)在国外,国内访问时经常会遇到下载慢或连接超时的问题,换成国内镜像源是目前最通用的解决办法。

下面整理了国内几个主流镜像源的地址,附上配置方法,方便参考使用。

1. 常用国内镜像源(优选排序)

镜像站点 源地址 特点
清华源(TUNA) https://pypi.tuna.tsinghua.edu.cn/simple 更新最快、包最全,通用首选
阿里云 https://mirrors.aliyun.com/pypi/simple/ 企业稳定,云服务器推荐
腾讯云 https://mirrors.cloud.tencent.com/pypi/simple/ 腾讯服务器环境最优
中科大 https://pypi.mirrors.ustc.edu.cn/simple/ 科研稳定
华为云 https://repo.huaweicloud.com/repository/pypi/simple/ 国内机房速度稳
豆瓣源 http://pypi.douban.com/simple/ 老源,http 需加信任主机

豆瓣 http 源报错补充:--trusted-host pypi.douban.com

2. 3种使用方式

1. 临时换源(仅当前命令生效)

安装包时直接通过 -i 参数指定镜像源,适合偶尔加速或测试。

bash 复制代码
# 使用清华源安装 requests
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/

若镜像源使用 HTTP 协议,需额外添加 --trusted-host(新版 pip 一般不需要,但部分环境仍需):

bash 复制代码
pip install requests -i https://pypi.doubanio.com/simple/ --trusted-host pypi.doubanio.com

2. 永久配置(全局生效)

经常使用 Python,建议永久配置,一次配置后续所有 pip 命令自动生效。

方式一:命令一键配置

bash 复制代码
# 设置清华全局源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 配置信任域名(消除ssl警告)
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

# 查看当前配置
pip config list

# 恢复官方默认源
pip config unset global.index-url

方式二:手动修改配置文件

Windows 系统:在 C:\Users\你的用户名\ AppData\Roaming\pip\pip.ini,无文件夹手动创建pip目录,写入以下内容

bash 复制代码
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

macOS / Linux 系统:在终端执行以下命令创建配置文件并写入镜像源地址:

bash 复制代码
mkdir -p ~/.pip
cat > ~/.pip/pip.conf << EOF
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

3. 验证配置是否生效

配置完成后,可以通过以下命令查看当前 pip 使用的镜像源地址:

pip config list

输出中如果出现你配置的国内镜像地址,说明配置已生效。

4. 国内镜像升级并查看当前pip版本

python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple

查看当前pip版本

pip --version

5. 内网环境

在企业内网或代理环境下使用,可能需要额外配置代理,可通过:

pip config set global.proxy http://proxy.server:port 设置

6. 恢复官方源

如需切回 PyPI 官方源,执行 pip config unset global.index-url 即可

相关推荐
无忧.芙桃1 天前
Linux系统编程(四):用户与权限管理
linux·运维·服务器
谙弆悕博士1 天前
多智能体架构详解:层级树状架构(分级主从型)
运维·架构·大模型·agent·多智能体·langgraph·层级树状
HMS工业网络1 天前
工业远程访问的五项安全部署原则
运维·服务器·安全
吴建旭 智宅焕1 天前
智能家居全国交付中执行端能力评估与分级调度架构设计:从注册数量到交付确定性的系统实现
运维·智能家居·devops
IT大白鼠1 天前
eBPF 观测入门:用 bpftrace 给服务器装上“内核摄像头“
运维·服务器·ebpf
分布式存储与RustFS1 天前
Zeppelin 笔记本重启就丢:三个环境变量把 .zpln 存进 RustFS 桶
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
好用斋1 天前
内网测速 LibreSpeed:网页版 Docker 测速服务
运维·docker·容器
江华森1 天前
从零开始:智能运维概念与Linux环境准备完全指南
linux·运维
橙橙子2301 天前
Linux----libevent
linux·运维·服务器
如夏倾城1 天前
五大远程桌面协议:RDP、SSH、VNC/RFB、Citrix ICA/HDX 与 VMware Blast Extreme
运维·windows·网络协议·安全·自动化·ssh·远程工作