crgwbr/docker-pypi

PyPI Server

镜像概述和主要用途

这是一个简单的PyPI服务器Docker镜像，可用于托管内部Python包以及适合专有产品使用的包版本，提供本地包管理和私有Python依赖托管能力。

核心功能和特性

• 支持本地目录挂载存储Python包
• 通过htaccess文件实现上传认证
• 兼容多种Python包格式（tarball、zip、wheel、egg等）
• 支持内部包上传和第三方包镜像
• 提供包更新检查功能

使用场景和适用范围

适用于企业内部Python项目管理，需要私有PyPI服务器来托管内部开发的Python包，或需要控制第三方依赖版本的场景，尤其适合专有产品的依赖管理。

使用方法

直接运行容器

如果直接从Docker索引运行容器，可使用以下命令：

bash
mkdir -p ./_data                    # 创建本地包存储目录
touch ./_data/.htaccess             # 创建包上传凭据文件
docker run \
    --rm \                          # 停止时自动删除容器
    -v ./_data:/srv/pypi:rw \       # 挂载本地目录到容器内包存储路径
    -p 8000:8000 \                  # 映射容器8000端口到主机
    --name pypi \                   # 指定容器名称
    crgwbr/docker-pypi:latest       # 镜像名称

运行后，访问 http://localhost:8000 即可查看PyPI服务器页面。将Python包文件（tarball、zip、wheel等）放入 ./_data/ 目录即可添加到服务器。

构建自定义镜像

通过克隆Git仓库构建最新版本容器：

bash
# 克隆仓库后执行构建
make build

构建完成后运行自定义镜像：

bash
make run

自定义镜像将在主机8080端口暴露服务，可通过 http://localhost:8080 访问测试。

配置说明

添加内部包

1. 创建用户账户：

   bash
   htpasswd -s htaccess yourusername
   

   每次更新htaccess文件后，需重新运行make run或手动将文件复制到/srv/pypi/.htaccess

2. 配置~/.pypirc文件：

   ini
   [distutils]
   index-servers =
       pypi
       internal
   
   [pypi]
   username:pypiusername
   password:pypipassword
   
   [internal]
   repository: http://localhost:8080
   username:yourusername
   password:yourpassword
   

3. 上传包： 在包含setup.py的项目目录中执行：

   bash
   python setup.py sdist upload -r internal
   

添加第三方包

使用pip命令镜像第三方包：

bash
# 单个包
pip install -d /srv/pypi pkgname

# 从requirements.txt批量镜像
pip install -d /srv/pypi -r requirements.txt

注意根据Python版本使用pip2或pip3

更新镜像包

检查并更新仓库中的包：

bash
pypi-server -U /srv/pypi

该命令将检查每个包的更新并显示更新说明。