docker-devpi Docker镜像文档

镜像概述和主要用途

本镜像基于coatldev/python:3.13-slim构建，预安装了devpi-client、devpi-server和devpi-web组件，用于快速搭建私有PyPI服务器。devpi是一个功能完善的Python包管理解决方案，支持包存储、缓存、索引管理及Web界面操作，适用于企业或团队内部的Python依赖管理。

核心功能和特性

• 完整组件集成：包含devpi-client（客户端管理工具）、devpi-server（核心服务器）、devpi-web（Web管理界面），无需额外安装
• 轻量基础环境：基于Python 3.13-slim镜像，体积小、启动快，适合资源受限环境
• 数据持久化：支持通过卷挂载持久化存储服务器数据（包、用户配置、索引信息等）
• 即开即用：预配置组件，启动容器即可提供PyPI服务，简化部署流程

使用场景和适用范围

• 企业私有PyPI服务器：管理内部开发的Python包，控制访问权限和版本分发
• 开发环境包缓存：缓存公共PyPI包，加速团队依赖下载，减少网络带宽消耗
• 离线/隔离环境：在无法访问公共PyPI的内网或隔离环境中，提供本地Python依赖分发
• 多环境版本控制：维护开发、测试、生产等不同环境的Python包版本，确保依赖一致性

详细的使用方法和配置说明

快速启动（docker run）

通过以下命令启动devpi服务器容器：

bash
docker run \
  --name devpi-server \
  --detach \
  --publish 3141:3141 \
  --volume devpi-data:/data \
  --env DEVPI_PASSWORD=password \
  coatldev/devpi:latest

参数说明：

• --name devpi-server：指定容器名称，便于识别和管理
• --detach：后台运行容器
• --publish 3141:3141：端口映射，将容器内3141端口（devpi默认端口）映射到主机3141端口，通过[***]访问服务
• --volume devpi-data:/data：挂载数据卷，持久化存储服务器数据（包、配置等）
• --env DEVPI_PASSWORD=password：设置管理员密码（替换password为实际安全密码）
• coatldev/devpi:latest：使用最新版本镜像

Docker Compose配置示例

创建docker-compose.yml文件，简化部署和管理：

yaml
version: '3.8'
services:
  devpi:
    image: coatldev/devpi:latest
    container_name: devpi-server
    restart: always  # 容器退出时自动重启
    ports:
      - "3141:3141"  # 端口映射
    volumes:
      - devpi-data:/data  # 数据卷持久化
    environment:
      - DEVPI_PASSWORD=your_secure_password  # 替换为实际密码

volumes:
  devpi-data:  # 自动创建命名卷，存储服务器数据

启动命令：docker-compose up -d（后台启动）

配置参数说明

环境变量

• DEVPI_PASSWORD：必填，设置devpi管理员用户密码，用于Web界面登录和客户端认证

数据管理

• 数据存储路径：容器内/data目录为数据根目录，包含所有包、用户配置和索引信息
• 持久化建议：必须通过卷挂载（--volume或volumes）持久化/data，避免容器删除导致数据丢失

端口配置

• 默认端口：3141（devpi标准端口）
• 自定义端口：如需修改主机端口，调整端口映射参数（如-p 8080:3141将主机8080端口映射到容器3141端口）

支持的标签

镜像提供多个版本标签，完整标签列表可查看Docker Hub标签页。建议根据需求选择特定版本，或使用latest标签获取最新稳定版。