🚀 国内常用 pip 源大全与配置方法
在国内使用 Python 时，pip install 经常遇到下载速度慢、连接超时甚至无法访问的情况。这是因为默认的官方源在国内访问不稳定。解决办法就是换用国内镜像源。
阿里云镜像
地址：
💡特点：由阿里云维护，稳定可靠，更新速度快，几乎实时同步官方源。国内访问速度优秀。
🎯适用场景：国内服务器/CI环境，日常开发环境，推荐首选。
使用方式：
清华大学 TUNA 镜像
地址：
💡特点：高校公益镜像，稳定可靠，学术氛围浓厚。同步频率快，稳定性高，适合科研和学习用途。
🎯适用场景：校园网/教育网环境，作为首选或备用源，科研项目。
使用方式：
中国科学技术大学 (USTC) 镜像
地址：
💡特点：高校镜像，免费稳定，教育网环境下访问速度快。更新速度略慢于商业源，但稳定性好。
🎯适用场景：适合作为备用源，校园/教育网环境，科研项目。
使用方式：
豆瓣镜像
地址：
⚠️注意：豆瓣的旧域名 http://pypi.douban.com/simple/ 已不再推荐，建议使用新域名。
💡特点：豆瓣提供的镜像服务，历史悠久，稳定性较好。适合作为备用源使用。
🎯适用场景：作为备用源，当主要源不可用时使用。
使用方式：
腾讯云镜像
地址：
💡特点：腾讯云开源镜像站，稳定可靠，适合部署在腾讯云的环境中。同步频率快，稳定性高。
🎯适用场景：腾讯云服务器上的开发、构建，企业内部统一配置。
使用方式：
华为云镜像
地址：
💡特点：华为云开源镜像站，国内节点多，提供更高的带宽和稳定性。适合企业级应用。
🎯适用场景：华为云服务器部署，面向企业的生产环境，企业级应用。
使用方式：
其他高校镜像
常用高校镜像源：
⚠️说明：部分学校镜像可能存在长期不维护或不稳定情况，建议优先使用清华、阿里、腾讯、华为云等主流镜像源。
使用示例：
pip 源的使用方法
1. 临时使用
仅对本次安装有效：
2. 永久配置
Linux / macOS 配置文件路径：~/.pip/pip.conf
Windows 配置文件路径：%APPDATA%\pip\pip.ini
3. 使用 pip config 命令
通过命令行设置全局配置：
Docker 环境中的 pip 源配置
1. 临时指定（适合快速测试）
2. 写入 pip 配置文件（推荐 ✅）
3. requirements.txt + 国内源
4. Docker 构建缓存优化
如果依赖较多，先 COPY requirements.txt，再 pip install，能避免源文件变动导致全部重装：
技巧与注意事项
🚀 访问
推荐优先选择 清华、阿里、腾讯、华为云，它们的同步频率快、稳定性高。
学校镜像（如 SJTU、USTC）也不错，但有时更新会慢半天。
🔒 SSL 证书问题
某些镜像证书链不完整，可以在 pip.conf 里加 trusted-host 解决。
🔄 多源配置
pip 只能设置一个 index-url，但可以通过 extra-index-url 增补：
⚡ CI/CD 环境
在 GitLab CI、GitHub Actions、Jenkins 等环境里，也可以通过设置环境变量 PIP_INDEX_URL 来指定源：
📋 推荐优先级
根据 稳定性、更新频率、速度 排序推荐：
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）
• 备用方案 配置多个镜像源，主源不可用时自动切换
• 定期更新 关注镜像源的维护状态，及时调整配置
温馨提示：定期检查和更新镜像源配置，确保获得最佳的下载体验。如遇到问题，可以尝试切换到其他镜像源。
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
"Docker访问体验非常流畅，大镜像也能快速完成下载。"