ustcmirror/pypi

USTC PyPI镜像Docker镜像

概述

本Docker镜像提供了中国科学技术大学(USTC)维护的PyPI镜像服务，用于搭建本地PyPI镜像，加速Python包的下载和安装过程。通过部署本地PyPI镜像，可以显著提高Python项目依赖的安装速度，同时减少对外部网络的依赖和带宽消耗。

核心功能和特性

• 完整同步PyPI官方仓库的Python包资源
• 提供本地缓存机制，减少重复下载
• 支持增量同步，降低带宽消耗
• 轻量级部署，易于维护
• 支持HTTP/HTTPS访问
• 可自定义同步频率和范围

使用场景和适用范围

• 企业内部Python开发环境
• 网络条件有限或需要节省带宽的场景
• 教育机构和科研单位的内部网络
• CI/CD流水线中的依赖管理
• 需要提高Python包安装速度的开发团队

使用方法和配置说明

基本使用

Docker Run命令

bash
docker run -d -p 8080:80 --name pypi-mirror ustclug/pypi-mirror

Docker Compose配置

yaml
version: '3'
services:
  pypi-mirror:
    image: ustclug/pypi-mirror
    container_name: pypi-mirror
    ports:
      - "8080:80"
    volumes:
      - ./data:/var/www/pypi
    restart: always
    environment:
      - SYNC_INTERVAL=86400  # 同步间隔，单位：秒
      - SYNC_TIMEOUT=3600    # 同步超时时间，单位：秒

配置参数

环境变量

数据持久化

为确保镜像数据在容器重启后不丢失，建议挂载数据卷到/var/www/pypi目录：

bash
docker run -d -p 8080:80 -v /path/to/local/data:/var/www/pypi --name pypi-mirror ustclug/pypi-mirror

客户端配置

pip配置

创建或修改~/.pip/pip.conf文件：

ini
[global]
index-url = http://your-mirror-ip:8080/simple/

[install]
trusted-host = your-mirror-ip

pip命令行临时使用

bash
pip install -i http://your-mirror-ip:8080/simple/ package-name

pipenv配置

bash
pipenv install --pypi-mirror http://your-mirror-ip:8080/simple/

poetry配置

bash
poetry config repositories.ustc http://your-mirror-ip:8080/simple/
poetry config pypi-mirror http://your-mirror-ip:8080/simple/

维护和更新

手动同步

bash
docker exec -it pypi-mirror /usr/local/bin/sync-pypi

查看日志

bash
docker logs -f pypi-mirror

更新镜像

bash
docker pull ustclug/pypi-mirror
docker stop pypi-mirror
docker rm pypi-mirror
docker run -d -p 8080:80 -v /path/to/local/data:/var/www/pypi --name pypi-mirror ustclug/pypi-mirror

注意事项

• 首次同步会消耗较多带宽和时间，请确保网络条件良好
• 建议至少分配100GB以上的存储空间
• 生产环境中建议配置HTTPS以确保安全
• 根据实际需求调整同步频率，避免过于频繁的同步