[python]镜像源

482 阅读2分钟

Python 镜像源列表

常用国内镜像源

  1. 清华大学(推荐)

    https://pypi.tuna.tsinghua.edu.cn/simple
    
  2. 阿里云

    https://mirrors.aliyun.com/pypi/simple
    
  3. 中国科学技术大学

    https://pypi.mirrors.ustc.edu.cn/simple
    
  4. 豆瓣

    https://pypi.douban.com/simple
    
  5. 华为云

    https://mirrors.huaweicloud.com/repository/pypi/simple
    
  6. 腾讯云

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

国外镜像源

  1. 官方源(默认)

    https://pypi.org/simple
    
  2. 微软

    https://pypi.microsoft.com/simple
    

需要使用镜像源的情况

1. 网络访问问题

  • 在中国大陆访问国外源速度慢或无法访问
  • 企业内网限制访问境外网站
  • 网络连接不稳定

2. 提高下载速度

  • 批量安装大量包时
  • CI/CD 流水线中需要快速安装依赖
  • 开发团队共享相同的依赖源

3. 特定环境需求

  • 离线环境:搭建本地私有镜像源
  • 安全要求:企业内网不允许访问外网
  • 稳定性:避免官方源宕机影响开发

4. 版本控制

  • 固定依赖版本,避免因官方源更新导致版本变化
  • 保证不同环境安装的一致性

使用方法

临时使用

# 安装单个包时指定镜像源
pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple

# 或使用 --index-url
pip install --index-url https://pypi.tuna.tsinghua.edu.cn/simple package_name

永久配置

Linux/macOS

# 创建配置文件
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
timeout = 120
EOF

Windows

# 在用户目录创建 pip.ini
# C:\Users\<用户名>\pip\pip.ini

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

使用代理(备选方案)

如果镜像源仍然有问题,可以使用代理:

pip install --proxy http://proxy-server:port package_name

注意事项

  1. 镜像同步延迟:镜像源可能比官方源延迟几小时到一天
  2. HTTPS 证书:如果使用 HTTPS 遇到问题,可以尝试:
    • 添加 --trusted-host 参数
    • 或使用 HTTP 协议(不推荐)
  3. 依赖完整性:确保镜像源包含所有需要的包
  4. 企业环境:建议搭建私有镜像源(使用 devpi 或 bandersnatch)

选择哪个镜像源主要取决于你的地理位置和网络环境,国内用户通常使用清华或阿里云的镜像源体验最佳。