Ubuntu：无网络环境下Docker离线部署全攻略

1. 离线部署Docker的核心挑战与解决方案在完全隔离网络的环境中部署Docker就像要在荒岛上搭建一个现代化厨房——所有食材和工具都得提前准备好。我经历过三次企业级离线部署最深刻的一次是在某金融机构数据中心他们的服务器甚至不允许插入任何USB设备。这种情况下我们需要更系统化的方法。离线安装的核心难点在于依赖关系管理。Docker并非独立运行它需要containerd、runc等多个组件协同工作。就像拼装乐高积木少一块关键零件整个系统就无法运转。根据实测Ubuntu 20.04上的Docker CE至少需要以下组件docker-ce主程序包docker-ce-cli命令行工具containerd.io容器运行时libseccomp2安全组件iptables网络配置这些组件之间存在严格的版本匹配要求。我曾遇到过因为containerd版本过高导致docker-ce无法启动的情况最终不得不重新下载匹配版本。建议在准备阶段就建立一个版本对照表组件名称推荐版本范围必须匹配项docker-ce20.10.x需与cli版本一致docker-ce-cli20.10.x需与主程序版本一致containerd.io1.4.x-1.6.x需兼容docker-ce版本2. 完整资源包制备实操指南2.1 资源下载的两种可靠方式第一种方法是使用官方仓库下载。在有网络的机器上执行以下命令建立下载环境# 添加Docker官方GPG密钥 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg # 设置稳定版仓库 echo deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 更新源并下载所有依赖 sudo apt-get update sudo apt-get download docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin第二种方法更保险——使用apt-offline工具。这个神器可以生成完整的依赖清单# 生成签名文件约5MB sudo apt-offline set offline.sig --install-packages docker-ce # 在有网环境下载全部依赖 apt-offline get offline.sig --bundle offline.zip我强烈推荐准备一个校验脚本verify.sh#!/bin/bash for pkg in *.deb; do dpkg -I $pkg | grep -q Package: || { echo $pkg损坏; exit 1; } done echo 所有包校验通过 chmod x verify.sh2.2 依赖包深度解析除了Docker主程序包这些隐藏依赖最容易出问题libseccomp2容器安全的基础组件版本必须≥2.4apparmorUbuntu的默认安全模块cgroupfs-mount管理cgroup层级bridge-utils配置docker0网桥可以通过这个命令一次性下载所有隐藏依赖sudo apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances docker-ce | grep ^\w | sort -u)3. 安全传输与验证方案3.1 企业级传输方案对比在金融行业项目中我们对比过三种传输方式加密USB介质# 创建加密容器 sudo apt-get install cryptsetup dd if/dev/zero ofdocker_offline.img bs1G count4 cryptsetup luksFormat docker_offline.img cryptsetup open docker_offline.img docker_offline mkfs.ext4 /dev/mapper/docker_offline局域网HTTP服务# 在跳板机搭建临时web服务 python3 -m http.server 8000 --bind 192.168.1.100 --directory /path/to/packages # 目标机下载 wget -r -np -nH --cut-dirs1 http://192.168.1.100:8000/NFS共享挂载# 服务端 sudo apt-get install nfs-kernel-server echo /data/docker_packages *(ro,sync,no_subtree_check) /etc/exports sudo exportfs -a # 客户端 sudo mount -t nfs 192.168.1.100:/data/docker_packages /mnt3.2 完整性验证进阶技巧传输完成后建议进行三重验证文件哈希校验sha256sum *.deb checksums.txt sha256sum -c checksums.txtGPG签名验证wget https://download.docker.com/linux/ubuntu/gpg gpg --import gpg for pkg in *.deb; do dpkg-sig --verify $pkg done模拟安装测试sudo dpkg --dry-run -i *.deb4. 安装与故障排除实战4.1 分步安装详解在目标机器上创建专用目录sudo mkdir /opt/docker_offline sudo cp *.deb /opt/docker_offline cd /opt/docker_offline按特定顺序安装关键包# 必须先安装低级依赖 sudo dpkg -i libseccomp2*.deb sudo dpkg -i containerd.io*.deb # 再安装主程序 sudo dpkg -i docker-ce*.deb docker-ce-cli*.deb # 最后处理可选组件 [ -f docker-compose-plugin*.deb ] sudo dpkg -i docker-compose-plugin*.deb4.2 高频故障解决方案问题1containerd服务启动失败# 查看详细日志 journalctl -xu containerd # 常见解决方法 sudo rm -rf /var/lib/containerd/* sudo systemctl restart containerd问题2docker.socket激活失败# 检查cgroup配置 ls -l /sys/fs/cgroup/systemd | grep docker # 临时解决方案 sudo mkdir /sys/fs/cgroup/systemd/docker sudo chmod 755 /sys/fs/cgroup/systemd/docker问题3iptables规则冲突# 清空现有规则 sudo iptables -F sudo iptables -t nat -F # 重启docker服务 sudo systemctl restart docker5. 生产环境优化配置5.1 离线环境专用配置修改daemon.json避免网络检测sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [], insecure-registries: [10.0.0.0/8], disable-legacy-registry: true, no-new-privileges: true, live-restore: true, max-concurrent-downloads: 0 } EOF5.2 离线镜像加载方案预先导出基础镜像docker pull ubuntu:20.04 docker save -o ubuntu_20.04.tar ubuntu:20.04在目标机加载sudo docker load -i ubuntu_20.04.tar # 验证镜像 sudo docker images | grep ubuntu建议准备一个自动加载脚本load_images.sh#!/bin/bash for img in *.tar; do echo 正在加载 $img ... docker load -i $img || { echo $img 加载失败; exit 1; } done