cr0hn/docker-pypi

PyPI服务器镜像

镜像概述

本镜像提供一个轻量的PyPI服务器，用于托管内部Python包及适合专有产品的包版本，支持上传、镜像第三方包等功能，帮助团队高效管理Python依赖。

核心功能

• 托管内部Python包（支持tarballs、zips、wheels、eggs等格式）
• 镜像第三方PyPI包，加速内部构建
• 基于.htpasswd的认证上传机制
• 可配置存储路径、端口、包覆盖权限等参数

使用场景

• 企业/团队内部私有Python包的分发与管理
• 镜像常用第三方包以减少外部依赖
• 管理专有Python包的版本控制

配置说明

通过环境变量可调整镜像行为：

• PYPI_ROOT：容器内包存储路径，默认/srv/pypi
• PYPI_PORT：监听端口，默认80
• PYPI_PASSWD_FILE：认证文件路径，默认/srv/pypi/.htpasswd
• PYPI_OVERWRITE：是否允许覆盖现有包，默认false

部署示例

Docker Run命令

bash
sudo mkdir -p /srv/pypi             # 创建本地包存储目录
sudo touch /srv/pypi/.htpasswd      # 初始化认证文件
docker run -t -i --rm \             # 停止后自动移除容器
    -h pypi.local \                 # 设置容器主机名
    -v /srv/pypi:/srv/pypi:rw \     # 挂载本地目录到容器
    -p 8080:80 \                    # 映射容器80端口到主机8080
    --name pypi \                   # 指定容器名称
    cr0hn/docker-pypi               # 使用目标镜像

运行后访问http://localhost:8080即可进入PyPI服务器首页。

添加内部包

1. 创建上传用户：

bash
htpasswd -s /srv/pypi/.htpasswd 你的用户名

2. 配置~/.pypirc文件：

ini
[distutils]
index-servers =
    pypi
    internal

[pypi]
username: pypi官方账号
password: pypi官方密码

[internal]
repository: http://localhost:8080
username: 你的用户名
password: 你的密码

3. 上传包到内部服务器：

bash
python setup.py sdist upload -r internal

镜像第三方包

• 单个包：pip install -d /srv/pypi 包名
• 批量镜像requirements.txt中的依赖：pip install -d /srv/pypi -r requirements.txt

更新镜像包

检查并更新已镜像的第三方包：

bash
pypi-server -U /srv/pypi