Docker离线部署无网络住宅主机

为什么要离线部署 Docker 到住宅主机

很多家庭网络没有固定公网 IP，或者为了安全把服务器设在内网，无法直接访问外网。
这种情况下，Docker 无法直接通过官方仓库在线安装。
本文提供一套完整可执行的离线部署方案，你只需要一台能联网的电脑下载文件，然后通过 U 盘拷贝到离线主机上操作。

前置准备：需要哪些物料

• 一台能上网的电脑（Windows 或 Linux 均可）
• 一个 U 盘或移动硬盘（至少 2GB 空间）
• 目标住宅主机的系统架构和版本（例如 amd64 架构的 Ubuntu 22.04）
• 知道目标主机的 IP 或能直接登录

分步操作：离线安装 Docker

第一步：在联网电脑上下载 Docker 静态二进制包

打开浏览器访问 Docker 官方静态包下载页：

https://download.docker.com/linux/static/stable/

找到与目标系统架构（x86_64、aarch64 等）对应的 .tgz 文件，例如 docker-24.0.7.tgz。

下载后解压：

tar -xzvf docker-24.0.7.tgz -C /tmp/

解压后 /tmp/docker/ 目录下会包含 docker、dockerd、containerd 等二进制文件。

如果后续需要运行常用镜像，也可以提前拉取并导出：

docker pull alpine:latest
docker save -o alpine.tar alpine:latest

将生成的 alpine.tar 也拷贝到 U 盘。

第二步：将文件传输到住宅主机

把 /tmp/docker/ 文件夹和 alpine.tar 复制到 U 盘，然后插到住宅主机上。
在住宅主机上执行：

sudo cp -r /media/usb/docker/* /usr/local/bin/

注意替换挂载路径。

第三步：配置 Docker 服务

创建 docker 用户组（可选，方便非 root 用户运行）：

sudo groupadd docker
sudo usermod -aG docker $USER

新建 systemd 服务文件 /etc/systemd/system/docker.service，内容如下：

[Unit]
Description=Docker Application Container Engine
After=network.target

[Service]
ExecStart=/usr/local/bin/dockerd
Restart=always

[Install]
WantedBy=multi-user.target

重新加载 systemd 并启动：

sudo systemctl daemon-reload
sudo systemctl enable --now docker

第四步：导入离线镜像（可选）

将之前导出的 alpine.tar 加载到本地 Docker 仓库：

docker load -i /path/to/alpine.tar

可以用 docker images 查看是否出现 alpine 镜像。

避坑指南：常见报错与解决

• 权限错误：执行 docker ps 提示 permission denied，说明当前用户没有加入 docker 组，重新登录或执行 sudo usermod -aG docker $USER 后退出重进。
• 服务无法启动：运行 sudo systemctl status docker 查看详细日志，最常见原因是 dockerd 二进制缺少依赖库（如 libseccomp.so.2），需要在联网电脑下载对应依赖包并拷贝到目标主机安装。
• 架构不匹配：静态包必须与 CPU 架构一致（x86_64 对应 amd64，ARM 选 arm64）。
• systemd 文件路径错误：确认 ExecStart 指向正确的 dockerd 位置。

效果验证：确认安装成功

运行以下命令：

docker version

能看到客户端和服务端版本信息，说明 Docker 引擎运行正常。
接着用刚刚导入的镜像启动一个容器：

docker run -it --rm alpine ash -c "echo 'Hello from offline Docker!'"

终端输出对应文字，就代表整个离线部署过程成功。

如果你正在处理 Docker 离线部署无网络住宅主机，建议先按本文步骤完整执行，再根据自己的环境做微调；
遇到异常时优先回看避坑和高频问题部分。