Docker 离线安装通用指南（基于官方 Static Binary）

本文介绍如何在 Linux 系统中使用 Docker 官方提供的 static 二进制包进行离线安装，适用于无公网环境或受限网络环境。

支持发行版：

- Debian / Ubuntu
- CentOS / Rocky / Alma
- Arch / Alpine（systemd 环境）
- 各类 VPS / 云服务器

该方法不依赖 apt/yum，仅需 Docker 官方 tgz 文件。

---

## 一、准备工作

### 1. 下载 Docker 离线包（在有网络的机器）

访问：

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

下载最新版本：

```

docker-<version>.tgz

```

例如：

```

docker-29.2.1.tgz

````

若服务器为 ARM 架构，请选择 `aarch64` 目录。

---

### 2. 传输到离线服务器

使用 scp 或 U 盘：

```bash
scp docker-*.tgz root@server:/root/
````

---

## 二、安装 Docker

### 1. 解压

```bash
tar xf docker-*.tgz
```

生成目录：

```
docker/
```

---

### 2. 安装二进制文件

```bash
cp docker/* /usr/bin/
chmod +x /usr/bin/*
```

验证客户端：

```bash
docker version
```

如果只显示 Client 信息，属正常现象。

---

## 三、启动 Docker Daemon（临时测试）

首次建议前台启动排错：

```bash
dockerd
```

正常情况下会看到：

```
API listen on /var/run/docker.sock
```

另开终端验证：

```bash
docker info
```

如果出现 Server 字段说明 daemon 正常。

---

## 四、创建 systemd 服务（永久运行）

### 1. 创建服务文件

```bash
nano /etc/systemd/system/docker.service
```

内容：

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

[Service]
ExecStart=/usr/bin/dockerd --exec-opt native.cgroupdriver=systemd
Restart=always
LimitNOFILE=1048576

[Install]
WantedBy=multi-user.target
```

---

### 2. 启用服务

```bash
systemctl daemon-reexec
systemctl daemon-reload
systemctl enable docker
systemctl start docker
```

验证：

```bash
docker info
```

---

## 五、推荐基础配置

### 1. 创建 daemon.json

```bash
mkdir -p /etc/docker
nano /etc/docker/daemon.json
```

示例：

```json
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "50m",
    "max-file": "3"
  }
}
```

重启：

```bash
systemctl restart docker
```

---

## 六、离线安装 docker compose 插件（可选）

### 1. 创建插件目录

```bash
mkdir -p /usr/libexec/docker/cli-plugins
```

### 2. 放入 compose 二进制

文件名必须为：

```
docker-compose
```

```bash
mv docker-compose /usr/libexec/docker/cli-plugins/
chmod +x /usr/libexec/docker/cli-plugins/docker-compose
```

验证：

```bash
docker compose version
```

---

## 七、离线导入镜像

在有网机器：

```bash
docker pull nginx
docker save nginx > nginx.tar
```

拷贝 nginx.tar 到离线服务器：

```bash
docker load < nginx.tar
```

---

## 八、常见问题

### 1. overlay 错误

```bash
modprobe overlay
modprobe br_netfilter
```

---

### 2. cgroup 报错

确保 dockerd 使用 systemd：

```bash
dockerd --exec-opt native.cgroupdriver=systemd
```

---

### 3. docker.sock 不存在

说明 daemon 未启动：

```bash
systemctl status docker
```

或手动：

```bash
dockerd
```

---

### 4. 查看日志

```bash
journalctl -u docker -f
```

---

## 九、卸载 Docker

```bash
systemctl stop docker
rm -f /usr/bin/docker*
rm -f /etc/systemd/system/docker.service
rm -rf /var/lib/docker
```

---

## 十、适用场景总结

本方案适合：

* 完全离线服务器
* VPS 初始化
* 教学环境
* 内网部署
* 自建云

特点：

* 不依赖包管理器
* 版本完全可控
* 迁移简单
* 可脚本化部署

---