无网络环境下Docker容器本地安装Python库失败求助

问题原因 #

你之前的方法失败，是因为pip install --find-links需要的是原始的Python包分发文件（.whl或.tar.gz格式），而不是conda环境site-packages目录里已经解压安装后的文件结构，所以pip找不到匹配的包版本。

正确解决步骤 #

1. 在有网络的环境下载所需包的分发文件 #

在你本地已配置好的conda环境中，执行以下命令，将所有依赖包下载到指定目录（比如python_libraries）：

# 先确保requirements.txt是干净的，去掉conda特有的、无法通过pip安装的包
pip download -r requirements.txt -d ./python_libraries

• 如果你的容器是Linux环境，而本地是macOS/Windows，需要指定兼容的平台，避免下载的wheel无法在容器中使用：

  pip download -r requirements.txt -d ./python_libraries --platform manylinux_x86_64 --only-binary=:all:
  

2. 准备Docker构建上下文 #

将下载好的python_libraries目录、requirements.txt一起放到Dockerfile所在的目录（即构建上下文）。

3. 修改Dockerfile实现离线安装 #

在Dockerfile中添加以下指令：

# 复制本地包目录和依赖清单
COPY python_libraries/ ./python_libraries/
COPY requirements.txt ./

# 离线安装依赖
RUN pip install -r requirements.txt --no-index --find-links=./python_libraries

额外注意事项 #

• 如果下载的包包含源码包（.tar.gz），容器中需要安装编译依赖（比如gcc、python3-dev等），可以在安装pip包前先执行：

  RUN apt-get update && apt-get install -y gcc python3-dev && rm -rf /var/lib/apt/lists/*
  

• 确保本地下载的包版本与容器中Python版本完全匹配（比如都是3.6），避免版本不兼容问题。

内容的提问来源于stack exchange，提问作者Manolo Dominguez Becerra