Ubuntu 24.04.2 LTS 安装 Docker 步骤

推荐安装方式：通过 Docker 官方仓库安装

更新系统并安装依赖

sudo apt update && sudo apt upgrade -y
sudo apt install -y apt-transport-https ca-certificates curl gnupg software-properties-common

说明：

• apt-transport-https: 支持 HTTPS 源

• ca-certificates: 系统证书集合

• curl: 下载工具

• gnupg: GPG 工具

• software-properties-common: 仓库管理工具

导入 Docker 官方 GPG 密钥

两种方式，选择其一：

使用 Docker 官方源

curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

使用阿里云镜像源（推荐国内用户）

curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

说明：GPG 密钥用于验证软件包来源的合法性。

添加 Docker 仓库源

两种方式，选择其一：

使用 Docker 官方源

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

使用阿里云镜像源

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

说明：系统架构 ($(dpkg --print-architecture)) 和 Ubuntu 版本代号 (${UBUNTU_CODENAME}) 会自动适配。

安装 Docker 引擎

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

说明：

• docker-ce: Docker 社区版核心

• docker-ce-cli: 命令行工具

• containerd.io: 容器运行时

• docker-buildx-plugin: 多平台构建插件

• docker-compose-plugin: Compose 集成插件

验证安装

检查服务状态

sudo systemctl is-active docker  # 应返回 "active"

运行测试容器

sudo docker run hello-world      # 输出 "Hello from Docker!" 表示成功

查看 Docker 信息

docker info                      # 显示详细配置信息
docker --version                 # 显示 Docker 版本
docker compose version           # 显示 Compose 插件版本

优化配置

配置国内镜像加速器

编辑 /etc/docker/daemon.json 文件，添加以下内容：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "http://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://ccr.ccs.tencentyun.com",
    "https://docker.rainbond.cc",
    "https://docker.nju.edu.cn"
  ]
}

重载配置并重启服务

sudo systemctl daemon-reload
sudo systemctl restart docker
sudo systemctl enable docker --now  # 设置开机自启

允许非 root 用户操作

sudo usermod -aG docker $USER       # 将当前用户加入 docker 组
newgrp docker                        # 立即生效（或重启系统）

说明：添加 docker 组后需重新登录使权限生效。

可选操作

安装独立版 Docker Compose

sudo apt install -y docker-compose

提示：若已安装 docker-compose-plugin，此步骤可跳过。

锁定 Docker 版本（防止自动更新）

sudo apt-mark hold docker-ce

卸载 Docker

sudo apt purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo rm -rf /var/lib/docker /var/lib/containerd  # 清理数据

参考链接

• Docker 官方文档

• 阿里云镜像站

• DaoCloud 镜像加速

注意事项

1. 确保 $UBUNTU_CODENAME 解析正确（Ubuntu 24.04 的版本代号为 noble）。

2. 国内用户建议优先使用阿里云镜像源，避免网络问题导致下载失败。

3. 添加 docker 组后需重新登录使权限生效。

4. 定期检查镜像加速器的有效性，避免因源失效导致拉取失败。