Ubuntu 24.04 Docker 安装手册

整理自博客园教程：https://www.cnblogs.com/lanyusky/p/19187095

一、前置准备

📸 VMware 快照（可选但推荐）

操作路径：
VMware 选中当前虚拟机 → 右键「快照」→「拍摄快照」
避免安装异常导致系统不可用。

二、卸载旧版本（如有）

系统预装的 docker.io 版本较旧，不建议使用。若已安装可先卸载：

sudo apt remove docker docker-engine docker.io containerd runc

三、安装 Docker 官方版

1. 更新软件包索引

sudo apt update

2. 安装依赖工具

sudo apt install -y ca-certificates curl gnupg lsb-release

3. 添加 Docker 官方 GPG 密钥（阿里云镜像加速）

# 创建密钥存放目录
sudo mkdir -p /etc/apt/keyrings

# 下载 GPG 密钥（使用阿里云镜像，内容为 Docker 官方密钥）
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 赋予所有用户可读权限
sudo chmod a+r /etc/apt/keyrings/docker.gpg

4. 添加 Docker 软件源

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5. 再次更新索引并安装 Docker

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

6. 验证安装结果

# 查看 Docker 开机自启状态（应输出 enabled）
systemctl is-enabled docker

# 查看 Docker 运行状态
systemctl status docker

四、配置国内镜像加速器（解决拉取慢/无法访问问题）

国内镜像是 Docker Hub 的缓存代理，镜像源头仍为官方，仅加速访问。

1. 创建配置文件

Docker 28.4.0+ 默认无配置文件，需手动创建：

sudo mkdir -p /etc/docker
sudo nano /etc/docker/daemon.json

2. 填入镜像源（按推荐顺序排列）

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}

✅ 说明：

• Docker 按列表顺序尝试，最稳定/最快的放第一位
• docker search 仍从 Docker Hub 查询，不受影响

3. 重启 Docker 生效

sudo systemctl restart docker

4. 验证镜像源配置

docker info | grep "Registry Mirrors" -A 5

输出中应能看到配置的镜像地址。

五、免 sudo 执行 Docker 命令（可选）

默认仅 root 和 docker 用户组可运行 Docker 命令。

1. 将当前用户加入 docker 组

# 查看是否存在 docker 用户组（一般安装后自动创建）
getent group docker

# 若不存在则创建
sudo groupadd docker

# 将当前用户加入 docker 组
sudo usermod -aG docker $USER

2. 使组权限生效（三选一）

3. 验证免 sudo

docker images

无报错即配置成功。

六、验证 Docker 正常工作

docker run hello-world

出现 “Hello from Docker!” 即表示安装与配置全部成功 ✅

七、常见问题说明

• ❌ 修改 daemon.json 不需要 执行 systemctl daemon-reload
• ❌ 不建议修改 Docker 默认 Unix 套接字权限（/var/run/docker.sock）
• ✅ 镜像加速器仅影响拉取速度，不改变镜像来源安全性

如需进一步配置 Docker Compose、私有仓库或生产环境参数，可在此基础上继续扩展。