跳转至

PyPI Server 客户端使用文档

本文档介绍如何在客户端配置和使用私有 PyPI Server

一、Windows 客户端配置（推荐）

1.1 配置文件位置

C:\Users\你的用户名\pip\pip.ini

1.2 创建步骤

在 CMD 或 PowerShell 中执行：

# 创建 pip 目录（如果不存在）
mkdir %USERPROFILE%\pip

# 创建配置文件
notepad %USERPROFILE%\pip\pip.ini

1.3 配置内容

请替换以下信息： - 账号 - 你的 PyPI Server 用户名 - 密码 - 你的 PyPI Server 密码 - IP - PyPI Server 服务器 IP 地址 - 端口 - PyPI Server 访问端口（如 8080）

[global]
index-url = http://账号:密码@IP:端口/simple
trusted-host = IP

示例：

[global]
index-url = http://admin:Admin@2025@192.168.222.5:8080/simple
trusted-host = 192.168.222.5

1.4 配置说明

参数 说明
index-url 包含账号密码的完整地址，格式：http://用户名:密码@IP:端口/simple
trusted-host 信任的服务器 IP（防止 HTTPS 警告）

1.5 使用示例

配置完成后，直接使用 pip 命令即可：

# 安装包
pip install numpy

# 安装指定版本
pip install django==4.2.0

# 批量安装
pip install -r requirements.txt

# 查看当前配置
pip config list

二、Windows 命令行配置方式

在 PowerShell 中直接执行以下命令：

# 配置 index-url
pip config set global.index-url http://账号:密码@IP:端口/simple

# 配置 trusted-host
pip config set global.trusted-host IP

# 查看所有配置
pip config debug

示例：

pip config set global.index-url http://admin:Admin@2025@192.168.222.5:8080/simple
pip config set global.trusted-host 192.168.222.5

三、Linux/Mac 客户端配置

3.1 配置文件方式

创建或编辑 ~/.pip/pip.conf：

mkdir -p ~/.pip
vim ~/.pip/pip.conf

配置内容：

[global]
index-url = http://账号:密码@IP:端口/simple
trusted-host = IP

3.2 环境变量方式

# 设置环境变量
export PIP_INDEX_URL="http://账号:密码@IP:端口/simple"

# 添加到 ~/.bashrc 永久生效
echo 'export PIP_INDEX_URL="http://账号:密码@IP:端口/simple"' >> ~/.bashrc
source ~/.bashrc

四、临时指定方式（不推荐）

当不需要配置文件时，可以临时指定：

# 安装包时临时指定
pip install package-name --index-url http://账号:密码@IP:端口/simple --trusted-host IP

# 示例
pip install yxpz_tools --index-url http://admin:Admin@2025@192.168.222.5:8080/simple --trusted-host 192.168.222.5

五、包下载和更新

5.1 下载包

# 直接下载
pip install package-name

# 下载指定版本
pip install package-name==1.0.0

# 批量下载
pip install -r requirements.txt

5.2 更新包

方式一：卸载后重新安装（推荐）

# 先卸载
pip uninstall package-name -y

# 再安装
pip install package-name

方式二：强制重装

pip install --force-reinstall --no-cache-dir package-name

方式三：升级版本号

# 升级到最新版本
pip install --upgrade package-name

六、私有包更新说明

6.1 问题说明

当私有包（如 yxpz_tools）版本号不变（仍为 0.0.1）重新上传到 pypi-server 时，会覆盖原来的 .whl 文件。其他用户需要特定操作才能获取到更新。

6.2 更新操作

如果版本号相同（覆盖上传）：

# 方式一：先卸载再安装
pip uninstall package-name -y
pip install package-name

# 方式二：强制重装
pip install --force-reinstall --no-cache-dir package-name

如果是新版本号：

# 直接升级
pip install --upgrade package-name

6.3 查看当前版本

pip show package-name

七、多版本 Python 包下载

在有网络的环境中下载跨平台的包：

7.1 Windows 下载命令

REM 下载通用包
pip download -d ./packages --only-binary=:all: --python-version 3.10 flask

REM 下载指定平台的包
pip download flask -d ./packages --platform=linux_x86_64 --python-version=3.8 --only-binary=:all:
pip download flask -d ./packages --platform=win_amd64 --python-version=3.10 --only-binary=:all:

7.2 参数说明

参数 说明
-d ./packages 下载目录
--only-binary=:all: 确保下载二进制 wheel 包
--python-version 指定 Python 版本
--platform 指定目标平台

八、常见问题

Q1: 配置后仍然无法访问？

  1. 检查服务器 IP 和端口是否正确
  2. 检查账号密码是否正确
  3. 检查网络连接
  4. 检查防火墙设置

Q2: 提示不信任的主机？

确保配置了 trusted-host 参数：

[global]
trusted-host = IP地址

Q3: 如何查看当前配置？

pip config list

Q4: 如何恢复到官方源？

Windows：

[global]
index-url = https://pypi.org/simple
trusted-host = pypi.org

Linux/Mac：

[global]
index-url = https://pypi.org/simple
trusted-host = pypi.org