1. 项目概述：为什么我们需要离线安装？

在Linux运维和开发工作中，尤其是在生产环境或内网隔离环境中，服务器通常无法直接访问互联网。这时，一个最常见的需求就是安装或更新软件包。你可能会遇到这样的场景：一台全新的Ubuntu服务器部署在内网，需要安装Nginx、Docker或者某个特定版本的Python库，但机器连不上外网。直接使用apt install会报错，提示无法连接仓库。这时候，“离线安装deb包”就成了必备技能。

简单来说，离线安装deb包，就是从一台可以联网的机器（我们称之为“下载机”或“源机器”）上，提前下载好目标软件包及其所有依赖包，然后通过U盘、内网共享或任何离线方式，将这些包传输到目标离线机器上，最后在离线环境中完成安装。这个过程听起来简单，但实际操作中，依赖关系的处理、版本冲突的解决、以及如何高效地批量操作，每一步都有不少门道。我处理过太多因为依赖没抓全导致安装失败，或者因为传输了不兼容的包导致系统出问题的案例。这篇文章，我就结合自己踩过的坑，把从原理到实操的完整流程，以及那些官方文档里不会写的细节，给你彻底讲透。

2. 核心原理与准备工作：理解APT的依赖世界

在动手之前，我们必须搞清楚APT（Advanced Package Tool）是如何工作的，否则离线安装就是盲人摸象。APT不是一个简单的安装命令，它是一个完整的包管理系统，核心是解决依赖关系。

2.1 APT依赖解析机制

当你执行apt install nginx时，APT会做以下几件事：

1. 更新本地索引：从配置的软件源（如http://archive.ubuntu.com）下载Packages.gz等索引文件，了解所有可用软件包及其版本、依赖关系。
2. 依赖计算：根据你要安装的软件包（nginx），分析其Depends（依赖）、Recommends（推荐）、Suggests（建议）字段。它会递归地找出所有必须安装的包，形成一个完整的依赖树。
3. 下载与安装：从软件源下载所有必需的.deb包文件，然后按顺序解压、配置、安装。

离线安装的核心，就是我们在联网机器上模拟完成第1步和第2步，把第3步需要的所有.deb文件“打包”带走。

2.2 准备工作与环境确认

工欲善其事，必先利其器。开始前，请务必确认以下几点：

1. 系统版本一致性（至关重要！）：下载机和目标离线机的系统版本、架构必须尽可能一致。例如，都是 Ubuntu 22.04 LTS (Jammy Jellyfish)，都是amd64架构。使用lsb_release -a和uname -m命令查看。不同版本（如20.04和22.04）的仓库内容不同，直接混用大概率会导致依赖地狱。
2. 已安装软件状态：目标机器上已经安装的软件会影响依赖计算。理想情况下，目标机器应该是一台“干净”的、与下载机系统版本一致的新机器。如果目标机器已有一些软件，那么下载依赖时需要考虑到这些已存在的包。
3. 工具准备：在下载机上，确保apt和dpkg工具是最新的。我们主要会用到apt-get download（下载包不安装）和apt-cache depends（查看依赖）等命令。

注意：很多人会想到用apt download命令，但在一些较老系统上可能不可用。apt-get download是更通用、更可靠的选择。

3. 单软件包离线安装：精准抓取依赖链

我们先从最简单的场景开始：只为离线机器安装一个特定的软件包，比如nginx。

3.1 方法一：使用apt-get download递归下载

这是最常用、最直观的方法。我们需要一个脚本来递归下载所有依赖。

首先，在联网的下载机上，创建一个工作目录并进入：

mkdir ~/offline-packages && cd ~/offline-packages

然后，使用以下命令下载主包及其依赖：

# 下载nginx及其所有依赖包，但不安装 apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances nginx | grep "^\w" | sort -u)

这个命令分解开来是这样工作的：

• apt-cache depends --recurse nginx：递归地列出nginx的所有依赖包。
• --no-recommends --no-suggests：忽略“推荐”和“建议”安装的包，它们不是运行所必需的，可以大幅减少下载量。对于严格的离线环境，建议先不加这些参数，确保基础功能；如果空间紧张，再考虑加上。
• --no-conflicts --no-breaks --no-replaces --no-enhances：忽略冲突、破坏、替换和增强类型的依赖关系，这些通常不是必须下载的。
• grep “^\w”：过滤输出，只取以字母数字开头的行（即包名）。
• sort -u：排序并去重，避免同一个包被下载多次。
• apt-get download：下载前面列表中的所有包。

执行后，当前目录就会堆满所需的.deb文件。

实操心得：直接运行这个长命令有时会因为某个依赖包的名称解析问题而中断。一个更稳健的做法是分两步：先生成依赖列表文件，再根据列表下载。

# 生成依赖列表 apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances nginx | grep “^\w” | sort -u > nginx-deps.list # 检查列表 cat nginx-deps.list # 根据列表下载 apt-get download $(cat nginx-deps.list)

3.2 方法二：使用apt-offline工具（更自动化）

如果你觉得命令太复杂，可以安装apt-offline工具，它能更优雅地处理这个过程。

首先在下载机安装它：

sudo apt install apt-offline

然后，为需要离线安装的包生成一个“签名文件”：

# 这会分析系统状态和需求，生成一个.sig文件 apt-offline set nginx-offline.sig --install-packages nginx

接着，将这个.sig文件拷贝到有网络的环境（可能就是这台下载机本身），用它来下载包：

apt-offline get nginx-offline.sig --bundle nginx-offline.zip

这个命令会下载所有需要的包，并打包成一个.zip文件。最后，将这个zip文件拷贝到离线机，使用apt-offline install nginx-offline.zip来安装。这个方法的好处是.sig文件很小，便于传输，且apt-offline会自动处理安装过程。

3.3 传输与离线安装

无论用哪种方法，下载好一堆.deb文件后，用U盘、SCP、内网FTP等方式，将它们全部传输到目标离线机器的某个目录，例如/tmp/packages。

在离线机器上，进入该目录，使用dpkg进行安装：

sudo dpkg -i *.deb

但这里有一个大坑：dpkg -i *.deb不会自动处理依赖安装顺序。如果A包依赖B包，而B包还没安装，那么A包的安装就会失败。虽然你可以多次运行sudo dpkg -i *.deb，因为已成功安装的包再次安装会被跳过，未解决的依赖可能会在后续轮次中解决，但这并不保险。

最佳实践是使用apt来安装本地目录的包，它能自动解决顺序问题：

# 将包含deb包的目录添加到APT源中（仅本次会话有效） sudo apt install ./path/to/packages/*.deb # 或者更精确地，使用本地目录作为源 sudo apt install /tmp/packages/*

apt命令会读取目录下所有deb文件，分析其元数据，并自动计算出正确的安装顺序。如果仍有依赖缺失（即我们漏下载了某些包），apt会明确报错，提示缺少哪个包，这比dpkg的模糊报错友好得多。

4. 批量/系统级离线安装：构建本地仓库

当需要为离线环境安装大量软件，或者需要长期维护一个离线软件源时，上面单次打包的方法就显得效率低下了。更专业的做法是在离线环境内部搭建一个本地APT仓库。

4.1 在下载机上同步整个软件源目录

我们可以使用apt-mirror或rsync工具，将Ubuntu官方源的一部分（比如 main 和 restricted 仓库）完整地镜像到本地。

首先安装apt-mirror：

sudo apt install apt-mirror

编辑其配置文件/etc/apt/mirror.list。以下是一个精简示例，仅镜像Ubuntu 22.04 Jammy的 main 和 universe 仓库的 amd64 架构包：

############# config ################## # 设置镜像文件存储的根目录 set base_path /var/spool/apt-mirror # 设置镜像日志目录 set run_postmirror 0 set nthreads 20 set _tilde 0 ############# end config ############## # 下面是镜像源地址 deb-amd64 http://archive.ubuntu.com/ubuntu jammy main restricted universe multiverse deb-amd64 http://archive.ubuntu.com/ubuntu jammy-updates main restricted universe multiverse deb-amd64 http://archive.ubuntu.com/ubuntu jammy-security main restricted universe multiverse # 可选的源码包，通常不需要 # deb-src http://archive.ubuntu.com/ubuntu jammy main restricted universe multiverse

保存后，运行sudo apt-mirror。这个过程会持续很久，并消耗大量磁盘空间（可能上百GB），因为它下载了整个仓库的索引和所有软件包。

同步完成后，在/var/spool/apt-mirror/mirror/archive.ubuntu.com/ubuntu目录下，你就拥有了一个完整的本地Ubuntu仓库。

4.2 将镜像打包并迁移至离线环境

由于镜像目录很大，我们需要将其打包并传输到离线环境。可以使用tar进行压缩，注意排除一些不必要的索引文件以减小体积。

cd /var/spool/apt-mirror sudo tar -czvf ubuntu-jammy-mirror.tar.gz mirror/archive.ubuntu.com/ubuntu --exclude=‘*Packages*’ --exclude=‘*Sources*’ --exclude=‘*Release*’

传输这个tar包到离线服务器。

4.3 在离线环境配置本地APT源

在离线服务器上，解压镜像文件到一个目录，例如/opt/local-apt-repo。

sudo mkdir -p /opt/local-apt-repo sudo tar -xzvf ubuntu-jammy-mirror.tar.gz -C /opt/local-apt-repo

接下来，需要让离线服务器的APT知道这个本地源。创建一个新的源列表文件：

sudo tee /etc/apt/sources.list.d/local.list << EOF deb [trusted=yes] file:/opt/local-apt-repo/mirror/archive.ubuntu.com/ubuntu jammy main restricted universe multiverse deb [trusted=yes] file:/opt/local-apt-repo/mirror/archive.ubuntu.com/ubuntu jammy-updates main restricted universe multiverse deb [trusted=yes] file:/opt/local-apt-repo/mirror/archive.ubuntu.com/ubuntu jammy-security main restricted universe multiverse EOF

[trusted=yes]是必须的，因为文件源没有数字签名。

然后，更新APT缓存：

sudo apt update

现在，这台离线服务器就可以像有网一样，使用sudo apt install安装镜像中包含的任何软件了，所有依赖都会自动从本地仓库解决。这是管理大批量离线机器最一劳永逸的方式。

5. 高阶技巧与疑难问题排查

掌握了基本方法，我们来看看那些容易踩坑的地方和进阶技巧。

5.1 处理“已安装但版本不同”的依赖

有时，下载机上的某个依赖包版本（如libc6:amd64 2.35）可能比离线机上已安装的版本（如2.31）要新。如果你直接把新版本的deb包拿到离线机上用dpkg -i强制安装，可能会破坏系统其他依赖此库的软件。

正确做法：在下载机上，使用apt-cache policy <包名>查看可用版本。然后，在下载命令中指定与离线机匹配的版本号进行下载。如果离线机版本太旧，安全起见，应考虑先在离线机上更新基础系统（如果有离线更新包）或寻找兼容的软件版本。

5.2 下载包含“推荐”和“建议”的包

对于生产环境，为了确保软件功能完整，我们可能需要连“推荐”包也一并下载。只需在之前apt-cache depends的命令中去掉--no-recommends参数即可。但要注意，这会使下载的包数量急剧增加。一个折中的方案是，先只下载必需依赖进行安装，如果软件运行不正常，再根据日志提示，单独下载缺失的推荐包。

5.3 使用dpkg-scanpackages创建轻量级本地源

如果你只是有一小批特定的deb包想做成源，而不是同步整个官方仓库，可以使用dpkg-scanpackages工具。

# 在存放deb包的目录下执行 cd /tmp/packages sudo dpkg-scanpackages . /dev/null | gzip > Packages.gz

这条命令会在当前目录生成一个Packages.gz索引文件。然后在/etc/apt/sources.list.d/中添加一行：

deb [trusted=yes] file:/tmp/packages ./

运行sudo apt update后，就可以用apt install来安装这个目录下的任意包了。这种方式非常适合分发自己定制的内部软件包。

5.4 常见错误与排查

1. dpkg: dependency problems prevent configuration of ...

   • 原因：依赖未满足。这是离线安装中最常见的错误。
   • 排查：使用apt-cache depends <失败包名>在下载机上重新仔细检查其依赖。很可能漏掉了某个间接依赖。将所有漏掉的包下载并传输过来，再次安装。

2. E: Unmet dependencies. Try ‘apt --fix-broken install’

   • 原因：安装过程中部分包未能正确配置，导致APT状态混乱。
   • 解决：在离线机上尝试sudo apt --fix-broken install。这个命令会尝试修复损坏的依赖关系。如果不行，可能需要用dpkg --purge清除出问题的包，然后从头开始安装流程。

3. The following packages have unmet dependencies: ...

   • 原因：尝试用apt install安装本地包时，本地包依赖了系统中不存在的库或工具。
   • 排查：仔细阅读错误信息，看具体缺少哪个包。回到下载机，用apt-cache show <主包名> | grep Depends查看其精确依赖，并确保所有依赖包都已包含在你的下载列表中。

4. 软件安装成功但无法运行

   • 原因：可能缺少动态链接库（.so文件）或某些运行时依赖（如Python模块、JRE等）。
   • 排查：在离线机上使用ldd /usr/bin/<软件名>检查二进制文件的动态链接库依赖。如果报告“not found”，说明对应的libxxx包没有安装。你需要找到并提供这个库包。

6. 实战案例：离线部署 Docker Engine

我们以一个实际案例来串联整个流程：在一台无法访问互联网的 Ubuntu 22.04 服务器上安装 Docker Engine。

步骤1：环境确认与准备

• 下载机：Ubuntu 22.04 amd64，可联网。
• 目标机：Ubuntu 22.04 amd64，离线。
• 在下载机，添加Docker官方APT仓库并更新（这是为了从Docker源下载，而不是Ubuntu默认源）：

  sudo apt update sudo apt install ca-certificates curl sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc echo “deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo “$VERSION_CODENAME”) stable” | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt update

步骤2：递归下载Docker包及其依赖

mkdir ~/docker-offline && cd ~/docker-offline # 下载 docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin, docker-compose-plugin 及其依赖 apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin | grep “^\w” | sort -u)

检查目录，你会看到几十个.deb文件。

步骤3：传输与安装将~/docker-offline目录整个打包，传输到目标离线机的/tmp目录并解压。 在目标离线机上：

cd /tmp/docker-offline # 使用apt安装本地目录的所有包，让它处理安装顺序 sudo apt install ./*.deb

步骤4：验证与配置安装完成后，启动Docker服务并验证：

sudo systemctl start docker sudo systemctl enable docker sudo docker run hello-world

如果hello-world镜像能成功运行，说明Docker引擎安装成功。由于是离线环境，你需要提前将业务所需的Docker镜像（如nginx:alpine）通过docker save和docker load的方式导入到这台机器。

在整个过程中，最关键的是第一步：在下载机上配置了正确的Docker源，确保下载的包版本与Docker官方推荐的一致。如果直接从Ubuntu默认源下载docker.io包，版本会旧很多，体验也不同。

离线安装deb包是一项看似基础但极其重要的系统管理技能。它的核心不在于命令本身，而在于对APT依赖体系的理解和对不同场景的灵活应对。对于偶尔的单包安装，递归下载足矣；对于需要长期维护的封闭集群，搭建本地镜像仓库是更可持续的方案。每次操作前，花两分钟确认系统版本和架构，能避免90%的兼容性问题。最后，善用apt而非仅仅dpkg来安装本地包，能让依赖问题变得更容易排查。