在 Ubuntu 24.04 上安装 Docker 最推荐的方式是通过 Docker 官方的 APT 存储库。这样可以确保你获得的是最新版本，且后续可以通过 apt upgrade 轻松更新。

以下是完整的安装步骤：

第一步：卸载旧版本（可选）

如果你的系统中已经安装了旧版本的 Docker（如 docker, docker.io 或 docker-engine），建议先清理它们：

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

第二步：更新系统并安装依赖

首先确保系统软件包是最新的，并安装必要的证书工具：

sudo apt update
sudo apt install ca-certificates curl gnupg

第三步：添加 Docker 官方密钥和存储库

1. 添加 GPG 密钥：

   sudo install -m 0755 -d /etc/apt/keyrings
   sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
   sudo chmod a+r /etc/apt/keyrings/docker.asc

2. 设置存储库：

   echo \
     "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
     $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
     sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

第四步：安装 Docker 及其配套组件

更新索引并安装 Docker Engine、CLI 以及 Compose 插件：

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

常见问题

如果执行后续安装命令报错则可配置国内镜像站下载GPG密钥

1. 使用国内镜像下载 GPG 密钥

我们将下载源从官方更换为阿里云，这样连接会非常稳定：

# 如果文件已存在，先删除旧的损坏文件
sudo rm -f /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

# 赋予读取权限
sudo chmod a+r /etc/apt/keyrings/docker.gpg

2. 重新添加 Docker 存储库（指向国内镜像）

同样地，将存储库地址也改为阿里云：

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

3. 更新并安装

现在再次运行更新，应该就不会报错了：

sudo apt update

如果 apt update 成功完成，接着安装组件：

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

第五步：验证安装

1. 检查服务状态：

   sudo systemctl status docker

2. 运行 Hello World（验证容器是否能正常拉取和运行）：

   sudo docker run hello-world

3. 验证 Docker Compose：

   docker compose version

第六步：后续配置（推荐）

1. 免 sudo 运行 Docker

默认情况下，只有 root 用户或 sudo 用户能运行 docker 命令。如果你想以普通用户身份运行：

sudo usermod -aG docker $USER

注意：执行完此命令后，需要注销并重新登录（或重启终端）才能生效。

2. 配置镜像加速器

在中国大陆使用 Docker，拉取镜像可能较慢。可以编辑 /etc/docker/daemon.json：

sudo nano /etc/docker/daemon.json

添加以下内容（请替换为可用的镜像地址）：

{
  "registry-mirrors": ["https://your-mirror-address.com"]
}

保存后重启服务：

sudo systemctl daemon-reload
sudo systemctl restart docker

总结：主要组件说明