Ubuntu 22.04 离线部署Docker全攻略：从apt源制作到镜像导入的避坑指南

Ubuntu 22.04 离线部署Docker全攻略：从apt源制作到镜像导入的避坑指南

在企业级IT基础设施中，内网隔离环境、生产安全区或特殊合规要求下的服务器，往往与互联网物理隔绝。在这种场景下，部署现代化的容器化应用平台，比如Docker，就成了一道技术门槛。很多运维工程师习惯了apt-get install一键安装的便捷，一旦面对离线环境，从依赖包缺失到镜像拉取失败，各种问题接踵而至，让人头疼不已。这篇文章，就是为你——那些需要在封闭网络环境中构建稳定、可复现Docker环境的工程师们准备的。我们不只告诉你步骤，更会深入剖析每个环节背后的原理、可能遇到的“坑”，并提供一套经过实战检验的、可脚本化的完整解决方案。你会发现，离线部署并非简单的文件拷贝，而是一项涉及系统包管理、镜像仓库管理和网络配置的系统工程。

1. 理解离线部署的核心挑战与设计思路

在开始动手之前，我们有必要先厘清在Ubuntu 22.04这类LTS系统上离线安装Docker究竟难在哪里。这不仅仅是“下载几个deb包”那么简单。

首要挑战是复杂的依赖关系。Docker Engine本身由docker-ce、docker-ce-cli、containerd.io和docker-compose-plugin等多个核心包组成。而每个包又依赖于系统底层的一系列库，例如libseccomp2、iptables、libapparmor1等。在联网环境下，APT包管理器会自动解析并下载这些依赖。但在离线时，你必须手动确保所有依赖包一个不落地被收集齐全，并且版本完全兼容。漏掉一个看似不起眼的库，就可能导致Docker守护进程启动失败。

其次是环境的一致性。你用于准备离线包的外网机器（我们称之为“构建机”）必须与目标内网服务器（“目标机”）在系统架构和版本上高度一致。最理想的情况是使用相同版本的Ubuntu 22.04 ISO安装的纯净系统。否则，因内核版本、Glibc版本等细微差异导致的兼容性问题会让你排查得焦头烂额。

再者是后续的镜像管理。Docker安装成功只是第一步。你的应用需要以容器镜像的形式运行。在内网中，你无法直接从Docker Hub拉取镜像。因此，如何在外网环境预先拉取、导出，并在内网批量导入所需的业务镜像，形成一套完整的离线镜像供应链，是另一个必须解决的难题。

基于这些挑战，一个稳健的离线部署方案应该遵循以下设计原则：

• 全量依赖收集：使用工具精确抓取所有递归依赖，而非手动列举。
• 环境模拟与验证：尽可能在类似环境的虚拟机中先测试离线安装包。
• 过程脚本化：将准备、传输、安装步骤封装成Shell脚本，减少人为错误，提高可重复性。
• 分层解耦：将“系统包安装”与“业务镜像导入”分离，便于独立更新和维护。

接下来，我们将按照“准备离线APT源 -> 传输与部署 -> 安装与排错 -> 镜像供应链管理”的流程，一步步拆解。

2. 构建完备的离线APT软件源

这是整个离线部署的基石。我们的目标是在一台能联网的、系统环境与目标机一致的Ubuntu 22.04机器上，创建一个包含Docker及其所有依赖的本地文件系统APT仓库。

2.1 构建机环境准备与关键工具

首先，确保你的构建机是干净的Ubuntu 22.04。建议使用虚拟机或容器来保证环境纯净。我们需要一个关键工具：dpkg-dev。它提供了dpkg-scanpackages命令，用于为我们下载的一堆.deb文件生成APT仓库所需的索引。

#!/bin/bash
# 构建机初始化脚本：prepare_build_env.sh
set -e

echo "[1/4] 更新系统并安装必要工具..."
sudo apt update
sudo apt install -y dpkg-dev curl gnupg software-properties-common

echo "[2/4] 添加Docker官方APT仓库（使用国内镜像加速）..."
# 导入Docker官方GPG密钥，用于验证软件包签名
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 添加阿里云镜像的Docker CE稳定版仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
echo "构建机