【一起学Python】第4天:无网络离线环境开发python 安装依赖解决方案

在无网络的服务器或内网环境中，执行 pip install -r requirements.txt 时遇到网络错误或SSL证书问题，无法正常安装Python依赖包。

核心思路

在有网络的机器上下载所有依赖包 → 传输到离线机器 → 本地安装

⚠️关键注意：下载机器和离线机器必须满足：

• Python版本一致
• 操作系统和架构一致（Windows/Linux、32/64位）

方案一：标准pip离线安装（推荐）

1. 有网机器操作

# 下载所有依赖到packages目录pip download -r requirements.txt -d packages# 使用国内镜像加速（推荐）pip download -r requirements.txt -d packages -i https://mirrors.aliyun.com/pypi/simple/

2. 传输文件

将整个 packages 文件夹复制到离线机器（U盘、共享文件夹等）

3. 离线机器安装

pip install --no-index --find-links=./packages -r requirements.txt

方案二：跨平台下载

当有网机器和离线机器系统不同时（如Mac下载Windows包）：

# 指定目标平台和Python版本pip download -r requirements.txt -d packages \  --platform win_amd64 \  --python-version 311 \  --only-binary=:all: \  -i https://mirrors.aliyun.com/pypi/simple/

平台参数说明：

• win_amd64: Windows 64位
• manylinux2014_x86_64: Linux 64位
• macosx_11_0_arm64: macOS ARM架构

方案三：Conda环境打包（最简单）

1. 有网机器操作

# 安装conda-packconda install -c conda-forge conda-pack# 激活环境并安装依赖conda activate your_envpip install -r requirements.txt# 打包整个环境conda pack -n your_env -o env.tar.gz

2. 离线机器操作

# 创建环境目录mkdir -p ~/anaconda3/envs/your_envcd ~/anaconda3/envs/your_env# 解压环境包tar -xzf env.tar.gz# 激活环境conda activate your_env

方案四：pip-download工具

1. 安装工具

pip install pip-download

2. 下载依赖

# 自动处理依赖关系pip-download -r requirements.txt -d packages

3. 离线安装

pip install --no-index --find-links=packages -r requirements.txt

常见问题排查

问题1：找不到匹配的版本

原因：下载的包平台不匹配

解决：

# 检查下载的包ls packages/*.whl# 查看文件名中的平台标识# 示例：numpy-1.24.0-cp311-cp311-win_amd64.whl#       包名-版本-Python版本-平台.whl

确保包名中包含：

• Windows: win_amd64 或 win32
• Linux: manylinux 或 linux
• macOS: macosx

问题2：依赖包不完整

解决：

# 下载时包含所有依赖pip download -r requirements.txt -d packages --no-cache-dir

问题3：版本冲突

解决：修改 requirements.txt，放宽版本限制

# 从严格版本opencv-python==4.8.1.78# 改为范围版本opencv-python>=4.8.0,<5.0.0

验证安装

# 查看已安装的包pip list# 验证特定包python -c "import opencv; print(opencv.__version__)"

最佳实践

1. 创建离线包仓库

# 定期更新离线包库pip download -r requirements.txt -d /path/to/repo# 使用时指定仓库pip install --no-index --find-links=/path/to/repo package_name

2. 使用requirements.txt锁定版本

# 导出精确版本pip freeze > requirements.txt# 确保环境一致性

3. 建立内网PyPI镜像

使用 devpi 或 pypiserver 搭建内网PyPI服务器：

# 安装pypiserverpip install pypiserver# 启动服务pypi-server -p 8080 ./packages# 客户端使用pip install -i http://internal-server:8080/simple/ package_name

总结

选择合适的方案，可以高效解决Python离线安装难题。