pypiserver搭建自用PyPI仓库

自建PyPI仓库

pypiserver

最简单、最轻量，适合个人、小团队或快速搭建。只需一个目录存放 .whl / .tar.gz 包。

Docker部署

准备docker-compose.yml

version: '3.8'  
services:  
  pypi-server:  
    image: pypiserver/pypiserver:latest          # 官方镜像  
    container_name: private-pypi  
    ports:  
      - "8080:8080"                              # 宿主机端口:容器端口，可改成 80 或其他  
    volumes:  
      - ./packages:/data/packages                # 存放包的目录（持久化）  
      - ./auth:/data/auth                        # 可选：存放密码文件  
    command:  
      - "-p"  
      - "8080"  
      - "--authenticate=update"                  # 认证方式：上传update、下载download、列表list  
      - "--passwords"  
      - "/data/auth/.htpasswd"                   # 如果启用认证  
      - "/data/packages"  
      - "--overwrite"                            # 允许覆盖同版本包  
    restart: always

mkdir -p packages auth  

添加认证

确认是否安装htpasswd, 未安装则安装

# CentOS  
yum install httpd-tools  
htpasswd -V  

cd auth  
# 创建用户 需输入两次密码  
htpasswd -B -c .htpasswd username  

启动服务

docker compose up -d

验证
访问
http://你的服务器IP:8080/
http://你的服务器IP:8080/simple
上传包
只需要将whl包放到packages目录下，然后访问 http://你的服务器IP:8080/simple ，即可看到上传的包。

客户端

客户端下载

pip install some_package --index-url http://你的服务器IP:8080/simple/ --trusted-host 你的服务器IP  

如果服务器使用了https域名, 一般不需要配置--trusted-host

配置pip
配置后, 下载时无需指定index-url

pip config set global.extra-index-url http://你的服务器IP:8080/simple/  
pip config set global.trusted-host 你的服务器IP  

Windows下配置文件路径如: C:\Users\Administrator\AppData\Roaming\pip\pip.ini

查询服务器包版本
```
pip index versions some_package  
```
升级包

pip install -U some_package  

上传包

pip install twine  

twine upload --repository-url http://你的服务器IP:8080 --username user123 --password pass123 some_package.whl  