本教程详细介绍了如何在没有互联网连接的环境中，利用 `conda pack` 工具安装包含复杂依赖的 conda 环境。通过在联网机器上定义 `environment.yml` 文件并使用 `conda pack` 将其及其所有依赖项打包成一个独立的压缩文件，用户可以轻松地将整个环境迁移到离线机器上进行部署。该方法有效解决了离线安装时常见的依赖解析问题，确保环境的完整性和一致性。
在没有互联网连接的环境中部署复杂的 Conda 环境，尤其是当环境依赖于多个 Python 包和特定的版本时，常常会遇到挑战。传统的离线安装方法，如单独下载 .conda 或 .bz2 文件，然后尝试逐个安装，往往因为未能正确解析所有依赖关系（包括直接和间接依赖）而失败。即使使用 environment.yml 文件，在离线模式下，Conda 也无法从配置的通道中获取包，导致安装中断。
为了解决这一难题，我们可以借助 conda pack 工具。conda pack 能够将一个完整的 Conda 环境（包括所有包及其依赖项）打包成一个独立的压缩文件，从而实现环境的便捷迁移和离线部署。
核心工具：Conda Pack 简介
conda pack 是一个用于打包 Conda 环境的实用工具。它能够将指定 Conda 环境中的所有文件，包括 Python 解释器、库、包以及它们的依赖项，打包成一个可移植的 .tar.gz 文件。这个打包文件可以在其他机器上解压并激活，无需重新下载或解析依赖。
安装 conda pack 在使用 conda pack 之前，请确保在联网机器上安装了该工具：
conda install conda-pack
分步教程：离线部署 Conda 环境
本教程将引导您完成在联网机器上准备环境，然后将其迁移到离线机器上部署的整个过程。
1. 定义 Conda 环境（在联网机器上）
首先，在联网的机器上创建一个 environment.yml 文件，明确列出您项目所需的所有 Conda 包和 Pip 包及其版本。这是定义环境的“单一事实来源”。
environment.yml 示例：
name: my_env
channels:
- conda-forge
- defaults
dependencies:
- bzip2=1.0.8=hcfcfb64_5
- python=3.9
- numpy
- pandas
- pip:
- attrs==23.1.0
- requests说明：
- name: 定义了您环境的名称。
- channels: 指定了 Conda 搜索包的通道。conda-forge 和 defaults 是常用的公共通道。
- dependencies: 列出了主要的 Conda 包。
- pip: 在 dependencies 下，您可以指定通过 Pip 安装的 Python 包。
2. 在联网机器上打包环境
在联网机器上，使用 conda pack 命令将上述 environment.yml 定义的环境及其所有依赖项打包成一个 .tar.gz 文件。
步骤：
-
创建 Conda 环境： 首先，根据 environment.yml 文件创建一个新的 Conda 环境。
conda env create -f environment.yml
-
激活环境： 激活刚刚创建的环境。
conda activate my_env
-
打包环境： 使用 conda pack 命令将 my_env 环境打包。
conda pack -n my_env -o my_environment.tar.gz
- -n my_env: 指定要打包的 Conda 环境名称。
- -o my_environment.tar.gz: 指定输出的压缩文件名称。
执行此命令后，conda pack 会自动解析 my_env 环境中的所有包及其递归依赖项，并将它们全部包含在 my_environment.tar.gz 文件中。
3. 传输打包文件到离线机器
将生成的 my_environment.tar.gz 文件通过 USB 驱动器、内部网络共享或其他离线传输方式，复制到目标离线机器上。
4. 在离线机器上创建环境
在离线机器上，您可以使用 conda create 命令结合 --file 和 --use-local 选项，从打包文件中创建 Conda 环境。
步骤：
-
解压打包文件： 首先，将 my_environment.tar.gz 文件解压到您希望安装环境的目录。例如，解压到 /path/to/my_env_location。
mkdir /path/to/my_env_location tar -xzf my_environment.tar.gz -C /path/to/my_env_location
注意：conda pack 打包的环境可以直接解压到目标路径，无需 conda create 命令。解压后，该目录本身就是一个可用的 Conda 环境。
-
（可选）注册环境： 如果您希望 conda env list 能够识别这个环境，可以手动注册它。 通常，conda pack 打包的环境在解压后，可以直接通过其内部的 bin/activate 脚本激活，无需 conda create。
直接激活方式：
# 假设您解压到了 /path/to/my_env_location source /path/to/my_env_location/bin/activate # 在Windows上可能是：call \path\to\my_env_location\Scripts\activate.bat
如果坚持使用 conda create 方式（不推荐，因为 conda pack 已经创建了完整的环境）： 原始答案中提到的 conda create --name my_environment --use-local --file my_environment.tar.gz 命令实际上是用于从一个 环境规范文件（例如，一个包含包列表的文本文件）在本地已有的包缓存中创建环境，而不是从一个完整的环境打包文件。对于 conda pack 生成的 .tar.gz 文件，最佳实践是直接解压并激活。
5. 激活并验证环境
环境解压并（如果需要）注册后，您可以激活它并验证所有包是否已正确安装。
# 假设您已通过 source /path/to/my_env_location/bin/activate 激活了环境 conda activate my_env # 如果已注册并命名为 my_env conda list # 列出所有已安装的包 conda info # 显示环境信息
通过检查 conda list 的输出，您可以确认所有在 environment.yml 中指定的包及其依赖项都已成功安装。
注意事项
- 系统兼容性： conda pack 打包的环境通常与打包时的操作系统和架构紧密相关。建议在与目标离线机器具有相同操作系统和 CPU 架构的联网机器上进行打包。例如，在 Linux x64 上打包的环境，最好部署到 Linux x64 机器上。
- conda-pack 自身安装： 确保在联网机器上正确安装了 conda-pack 工具。
- 路径问题： 打包的环境在解压后，其内部路径是相对的，因此通常可以在不同的文件系统路径下工作。
-
避免 conda install
循环： 之前尝试的逐个安装 .bz2 或 .conda 文件的方法之所以失败，正是因为无法自动处理复杂的依赖树。conda pack 的核心价值在于它在打包时就完成了所有依赖的解析和捆绑。
总结
conda pack 提供了一种高效、可靠的方式来解决 Conda 环境在离线部署时的依赖问题。通过在联网机器上预先打包好包含所有依赖的完整环境，可以极大地简化离线机器上的安装过程，确保环境的一致性和可重复性。这对于在没有互联网访问权限的生产服务器、科研设备或安全受限环境中部署 Python 应用尤为重要。
参考资料
- conda-pack 官方文档：https://www.php.cn/link/fd8bd77225ce96b0a96239fe8481f208
