mosquito/pypi-server

PYPI Server

镜像概述

这是一个快速异步的PyPI服务器实现，可作为自托管的Python包仓库，支持从全球PyPI缓存包，同时允许用户发布和管理自有包。解决了HTTP代理无法处理PyPI的XML-RPC问题，适用于企业内部共享私有包或加速包下载场景。

核心功能

• 缓存全球PyPI的包
• 支持发布和更新自有Python包
• 注册和上传包时的密码认证
• 支持多种数据库：PostgreSQL、MySQL（MariaDB）、SQLite3（仅开发用）

使用场景

• 企业内部搭建私有Python包仓库，共享团队开发的包
• 加速Python包下载，减少对外部PyPI源的依赖
• 离线环境下使用缓存的PyPI包

配置说明

Docker部署示例

使用Docker Compose部署（PostgreSQL数据库）：

yaml
version: '2'
services:
  db:
    image: postgres
    environment:
      POSTGRES_PASSWORD: pypi-server
      POSTGRES_USER: pypi-server
      POSTGRES_DB: pypi-server
    volumes:
      - ./postgresql:/var/lib/postgresql/data
  pypi_server:
    image: mosquito/pypi-server:latest
    links:
      - db
    restart: always
    ports:
      - 8080:80
    volumes:
      - ./packages:/var/lib/pypi-server
    environment:
      DB: "postgres://pypi-server:pypi-server@db/pypi-server"
      # 可选配置：SECRET、PORT、PROXY_MODE等

上传自有包步骤

1. 确保包的setup.py配置正确
2. 在用户目录创建.pypirc文件：

ini
[distutils]
index-servers = mypypi
[mypypi]
repository=http://your-pypi-server:8080/pypi
username=admin
password=admin

3. 打包并上传：

bash
cd your-package-root
python setup.py sdist register upload -r mypypi

下载包步骤

使用pip从私有源安装：

bash
pip install -i http://your-pypi-server:8080/simple --trusted-host your-pypi-server your-package-name

或配置pip默认使用私有源（~/.pip/pip.conf）：

ini
[global]
index-url = http://your-pypi-server:8080/simple/
[install]
trusted-host=your-pypi-server

默认管理员账号：admin/admin