pip 离线安装包的方法

jjj_web

2084人浏览 · 2025-08-12 07:15:00

jjj_web · 2025-08-12 07:15:00 发布

pip 离线安装包的完整指南

在无网络环境下安装Python包需要精心准备依赖包，以下是专业级的离线安装方案：

一、基础离线安装流程

1. 创建离线包仓库

# 在联网机器上创建仓库目录
mkdir -p offline_packages/{wheels,requirements}

# 下载指定包及其依赖
pip download \
  --dest offline_packages/wheels \
  --only-binary=:all: \
  --platform manylinux2014_x86_64 \  # 指定目标平台
  --python-version 38 \               # Python 3.8
  --implementation cp \
  pandas==1.5.3 numpy==1.24.2

2. 打包传输

# 创建完整环境快照
pip freeze > offline_packages/requirements/full_requirements.txt

# 打包压缩
tar -czvf py_packages.tar.gz offline_packages
# 传输到目标机器：USB/内网/scp

3. 离线安装

# 在目标机器解压
tar -xzvf py_packages.tar.gz

# 从本地目录安装
pip install --no-index \
  --find-links=offline_packages/wheels \
  -r offline_packages/requirements/full_requirements.txt

二、跨平台兼容方案

多平台依赖下载

# 下载Windows/Linux/macOS全平台包
pip download \
  --platform win_amd64 \
  --platform manylinux2014_x86_64 \
  --platform macosx_10_15_x86_64 \
  -d multi_platform_pkgs \
  requests

安装时平台检测

# 自动选择合适平台的包
pip install --no-index \
  --find-links=multi_platform_pkgs \
  --only-binary=:all: \
  requests

三、高级离线管理

1. 私有索引服务器（企业级）

# 使用devpi创建本地索引
devpi-init --serverdir ~/devpi
devpi-server --start --serverdir ~/devpi
devpi use http://localhost:3141
devpi login root --password=""  # 默认空密码

# 上传离线包到私有索引
devpi upload --from-dir offline_packages/wheels

2. 容器化离线安装

FROM python:3.8-slim

# 复制离线包
COPY offline_packages /opt/packages

# 设置私有源
RUN pip config set global.index-url "file:///opt/packages/wheels" && \
    pip config set global.extra-index-url "" && \
    pip install --no-cache-dir pandas numpy

四、依赖树管理技巧

可视化依赖关系

# 生成依赖树
pipdeptree --packages pandas > deptree.txt

# 图形化显示
pip install pip_tree
pip_tree -r requirements.txt | dot -Tpng > dependencies.png

最小化依赖下载

# 仅下载直接依赖
pip download --no-deps pandas -d minimal_pkgs

# 安装时自动解析依赖
pip install --no-index \
  --find-links=minimal_pkgs \
  --prefer-binary \
  pandas

五、离线安装场景解决方案

场景1：纯净环境部署

# 下载所有依赖到wheelhouse
pip wheel --wheel-dir wheelhouse -r requirements.txt

# 离线安装所有wheel
pip install --no-index --find-links=wheelhouse $(ls wheelhouse/*.whl)

场景2：限制架构的服务器

# 精确匹配目标环境
pip download \
  --platform linux_aarch64 \  # ARM架构
  --python-version 39 \
  --abi cp39 \
  --implementation cp \
  -d arm_pkgs \
  tensorflow

场景3：打包独立应用

# 使用shiv创建独立可执行文件
pip install shiv
shiv -c pandas_script \
  -o pandas_app.pyz \
  -r requirements.txt \
  --platform linux_x86_64

六、常见问题解决

1. 解决C扩展编译问题

# 预编译二进制包
pip download \
  --only-binary=:all: \
  --platform manylinux2014_x86_64 \
  -d compiled_pkgs \
  cryptography

2. 处理依赖冲突

# 生成兼容性约束
echo "numpy==1.24.2" > constraints.txt

# 带约束安装
pip install --no-index \
  --find-links=offline_packages \
  -c constraints.txt \
  pandas

七、企业级离线部署架构

最佳实践

版本锁定：始终使用 == 指定精确版本

哈希校验：启用包完整性检查

pip download --require-hashes -r requirements.txt

定期更新：每季度更新离线仓库

安全审计：离线环境运行安全扫描

pip install safety
safety check --bare --full-report

完整工作流示例

#!/bin/bash
# offline_installer.sh

# 阶段1：准备环境（联网机器）
PKG_DIR="offline_repo_$(date +%Y%m%d)"
mkdir -p "${PKG_DIR}"/{wheels,src,metadata}

# 下载二进制包
pip download -d "${PKG_DIR}/wheels" \
  --only-binary=:all: \
  --platform manylinux2014_x86_64 \
  -r requirements.txt

# 下载源码包备用
pip download -d "${PKG_DIR}/src" \
  --no-binary=:all: \
  -r requirements.txt

# 生成元数据
pip freeze > "${PKG_DIR}/metadata/freeze.txt"
pip check > "${PKG_DIR}/metadata/dep_check.txt"

# 阶段2：离线安装（目标机器）
pip install --no-index \
  --find-links="${PKG_DIR}/wheels" \
  -r "${PKG_DIR}/metadata/freeze.txt" \
  --require-hashes \
  --disable-pip-version-check