🚀 国内常用 pip 源大全与配置方法

在国内使用 Python 时,pip install 经常遇到下载速度慢、连接超时甚至无法访问的情况。这是因为默认的官方源在国内访问不稳定。解决办法就是换用国内镜像源。

1

阿里云镜像

地址:

https://mirrors.aliyun.com/pypi/simple/

💡特点:由阿里云维护,稳定可靠,更新速度快,几乎实时同步官方源。国内访问速度优秀。

🎯适用场景:国内服务器/CI环境,日常开发环境,推荐首选。

使用方式:

# 临时使用 pip install requests -i https://mirrors.aliyun.com/pypi/simple/
# 全局配置 pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
2

清华大学 TUNA 镜像

地址:

https://pypi.tuna.tsinghua.edu.cn/simple/

💡特点:高校公益镜像,稳定可靠,学术氛围浓厚。同步频率快,稳定性高,适合科研和学习用途。

🎯适用场景:校园网/教育网环境,作为首选或备用源,科研项目。

使用方式:

# 临时使用 pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/
# 全局配置 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
3

中国科学技术大学 (USTC) 镜像

地址:

https://pypi.mirrors.ustc.edu.cn/simple/

💡特点:高校镜像,免费稳定,教育网环境下访问速度快。更新速度略慢于商业源,但稳定性好。

🎯适用场景:适合作为备用源,校园/教育网环境,科研项目。

使用方式:

# 临时使用 pip install requests -i https://pypi.mirrors.ustc.edu.cn/simple/
# 全局配置 pip config set global.index-url https://pypi.mirrors.ustc.edu.cn/simple/
4

豆瓣镜像

地址:

https://pypi.doubanio.com/simple/

⚠️注意:豆瓣的旧域名 http://pypi.douban.com/simple/ 已不再推荐,建议使用新域名。

💡特点:豆瓣提供的镜像服务,历史悠久,稳定性较好。适合作为备用源使用。

🎯适用场景:作为备用源,当主要源不可用时使用。

使用方式:

# 临时使用 pip install requests -i https://pypi.doubanio.com/simple/
# 全局配置 pip config set global.index-url https://pypi.doubanio.com/simple/
5

腾讯云镜像

地址:

https://mirrors.cloud.tencent.com/pypi/simple/

💡特点:腾讯云开源镜像站,稳定可靠,适合部署在腾讯云的环境中。同步频率快,稳定性高。

🎯适用场景:腾讯云服务器上的开发、构建,企业内部统一配置。

使用方式:

# 临时使用 pip install requests -i https://mirrors.cloud.tencent.com/pypi/simple/
# 全局配置 pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple/
6

华为云镜像

地址:

https://mirrors.huaweicloud.com/repository/pypi/simple/

💡特点:华为云开源镜像站,国内节点多,提供更高的带宽和稳定性。适合企业级应用。

🎯适用场景:华为云服务器部署,面向企业的生产环境,企业级应用。

使用方式:

# 临时使用 pip install requests -i https://mirrors.huaweicloud.com/repository/pypi/simple/
# 全局配置 pip config set global.index-url https://mirrors.huaweicloud.com/repository/pypi/simple/
7

其他高校镜像

常用高校镜像源:

网易 (163)
https://mirrors.163.com/pypi/simple/
上海交通大学 (SJTU)
https://mirror.sjtu.edu.cn/pypi/web/simple/
中国科学院 (CAS)
https://mirrors.cstcloud.cn/pypi/web/simple/
官方源
https://pypi.org/simple/

⚠️说明:部分学校镜像可能存在长期不维护或不稳定情况,建议优先使用清华、阿里、腾讯、华为云等主流镜像源。

使用示例:

# 使用网易源 pip install requests -i https://mirrors.163.com/pypi/simple/
⚙️

pip 源的使用方法

1. 临时使用

仅对本次安装有效:

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

2. 永久配置

Linux / macOS 配置文件路径:~/.pip/pip.conf

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

Windows 配置文件路径:%APPDATA%\pip\pip.ini

[global] index-url = https://mirrors.aliyun.com/pypi/simple trusted-host = mirrors.aliyun.com

3. 使用 pip config 命令

通过命令行设置全局配置:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
🐳

Docker 环境中的 pip 源配置

1. 临时指定(适合快速测试)

FROM python:3.10 RUN pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ flask

2. 写入 pip 配置文件(推荐 ✅)

FROM python:3.10 # 配置国内 pip 源 RUN mkdir -p /root/.pip RUN echo "[global]" > /root/.pip/pip.conf RUN echo "index-url=https://mirrors.aliyun.com/pypi/simple" >> /root/.pip/pip.conf RUN echo "trusted-host=mirrors.aliyun.com" >> /root/.pip/pip.conf # 安装依赖 RUN pip install flask requests

3. requirements.txt + 国内源

FROM python:3.10 COPY requirements.txt . RUN pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

4. Docker 构建缓存优化

如果依赖较多,先 COPY requirements.txt,再 pip install,能避免源文件变动导致全部重装:

COPY requirements.txt . RUN pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple COPY . .
💡

技巧与注意事项

🚀 访问

推荐优先选择 清华、阿里、腾讯、华为云,它们的同步频率快、稳定性高。

学校镜像(如 SJTU、USTC)也不错,但有时更新会慢半天。

🔒 SSL 证书问题

某些镜像证书链不完整,可以在 pip.conf 里加 trusted-host 解决。

🔄 多源配置

pip 只能设置一个 index-url,但可以通过 extra-index-url 增补:

[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple extra-index-url = https://mirrors.aliyun.com/pypi/simple

⚡ CI/CD 环境

在 GitLab CI、GitHub Actions、Jenkins 等环境里,也可以通过设置环境变量 PIP_INDEX_URL 来指定源:

export PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple pip install -r requirements.txt

📋 推荐优先级

根据 稳定性、更新频率、速度 排序推荐:

1. 清华 TUNA → https://pypi.tuna.tsinghua.edu.cn/simple

2. 阿里云 → https://mirrors.aliyun.com/pypi/simple/

3. 腾讯云 / 华为云

4. USTC / SJTU(教育网用户可优先)

5. 豆瓣(备用)

总结

在国内使用 pip,换源是提升速度与稳定性的关键。

本地开发环境 建议写入 pip.conf

Docker 环境 建议直接在 Dockerfile 配置

CI/CD 环境 建议用 PIP_INDEX_URL

推荐首选 清华、阿里源,作为国内环境的默认配置

🎯 最佳实践建议

生产环境 优先选择商业云服务商的镜像源(阿里云、腾讯云、华为云)

开发环境 可以使用高校镜像源(清华、USTC)

备用方案 配置多个镜像源,主源不可用时自动切换

定期更新 关注镜像源的维护状态,及时调整配置

温馨提示:定期检查和更新镜像源配置,确保获得最佳的下载体验。如遇到问题,可以尝试切换到其他镜像源。

用户好评

来自真实用户的反馈,见证轩辕镜像的优质服务

oldzhang的头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅,大镜像也能快速完成下载。"

免费获取在线技术支持请 提交工单,官方QQ群:13763429 。
轩辕镜像面向开发者与科研用户,提供开源镜像的搜索和访问支持。所有镜像均来源于原始仓库,本站不存储、不修改、不传播任何镜像内容。
官方邮箱:点击复制邮箱
©2024-2026 源码跳动