使用pip wheel与HTTP服务器构建离线Python包库的完整指南_Python

在无法访问互联网的环境中部署python项目时，离线包库是必不可少的解决方案。本文将详细介绍如何创建一个完整的离线python包库，让你可以在内网环境中轻松安装python依赖。

核心思路

使用pip wheel下载所有依赖的wheel文件
使用python内置http服务器共享这些文件
通过--find-links参数实现离线安装

完整步骤

第一步：准备环境

确保你已安装：

python 3.6+
pip最新版本

# 更新pip
python -m pip install --upgrade pip

第二步：生成requirements.txt文件

# 如果你已有项目
pip freeze > requirements.txt

# 或者从top-pypi-packages获取示例
curl -o https://hugovk.github.io/top-pypi-packages/top-pypi-packages-30-days.min.json

第三步：下载所有wheel文件

# 创建存储目录
mkdir wheelhouse

# 下载所有依赖的wheel文件
pip wheel --wheel-dir=wheelhouse -r requirements.txt

这个命令会：

解析requirements.txt中的所有依赖
下载每个包的wheel文件
保存到wheelhouse目录中

第四步：启动http服务器

cd wheelhouse
python -m http.server 8080  # 使用8080端口

服务器启动后，可以通过http://<your-ip>:8080访问所有wheel文件。

第五步：离线安装包

在目标机器上执行：

pip install --no-index --find-links=http://<server-ip>:8080/ package_name

或者安装整个requirements.txt：

pip install --no-index --find-links=http://<server-ip>:8080/ -r requirements.txt

实际案例演示

假设我们需要离线安装requests和numpy：

创建requirements.txt：

requests
numpy

下载wheel文件：

pip wheel --wheel-dir=wheelhouse -r requirements.txt

启动服务器：

cd wheelhouse
python -m http.server 8080

在另一台机器上安装：

pip install --no-index --find-links=http://192.168.1.100:8080 requests numpy

高级技巧

跨平台支持：

pip wheel --wheel-dir=wheelhouse --platform manylinux2014_x86_64 -r requirements.txt

批量下载：

# 下载整个pypi-top-100包
curl -s https://hugovk.github.io/top-pypi-packages/top-pypi-packages-30-days.json \
| jq -r '.rows[].project' | head -100 > requirements.txt

使用docker容器：

# 创建干净的构建环境
docker run -v $(pwd):/app python:3.9-slim \
  pip wheel --wheel-dir=/app/wheelhouse -r /app/requirements.txt

注意事项

平台兼容性：在相同架构和操作系统的机器上生成wheel文件

python版本：确保生成环境与目标环境的python版本一致

文件完整性：定期检查wheel文件的完整性

安全考虑：在内网环境中使用，避免将http服务器暴露到公网

替代方案比较

方法	优点	缺点
pip wheel + http	轻量级、无需额外工具	需要手动管理依赖
devpi	功能完整、支持缓存	配置复杂、资源占用大
bandersnatch	官方镜像工具	需要大量存储空间
docker镜像	完整环境隔离	镜像体积较大