在 Ubuntu 24.04 系统中安装和配置 Docker 及 Docker Compose 是容器化部署的基础操作，以下是官方推荐的标准步骤，包含安装、配置、验证及常用操作，全程适配 Ubuntu 24.04 特性。

一、前置准备：卸载旧版本（可选）

如果系统中曾安装过 Docker 旧版本（docker、docker-engine 等），先清理避免冲突：

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

清理残留数据（可选，若需保留数据则跳过）：

sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

二、安装 Docker Engine（官方源）

Ubuntu 24.04 推荐通过 Docker 官方 APT 源安装，而非系统默认源（版本较旧）。

1. 安装依赖工具

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

2. 添加 Docker 官方 GPG 密钥

# 创建密钥存储目录
sudo mkdir -p /etc/apt/trusted.gpg.d
# 下载并导入 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg

3. 添加 Docker APT 源

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

4. 安装 Docker Engine

# 更新源并安装最新版 Docker
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

三、配置 Docker 免 sudo 操作（可选，推荐）

默认情况下，Docker 命令需要 sudo 权限，配置普通用户免 sudo：

# 创建 docker 用户组（若已存在则忽略）
sudo groupadd docker
# 将当前用户加入 docker 组
sudo usermod -aG docker $USER
# 刷新用户组（无需重启，立即生效）
newgrp docker

四、验证 Docker 安装

# 检查 Docker 服务状态
sudo systemctl status docker

# 运行测试容器（验证功能正常）
docker run hello-world

若输出 Hello from Docker! 相关内容，说明 Docker 安装成功。

五、安装 Docker Compose（两种方式）

Docker Compose 用于编排多容器应用，Ubuntu 24.04 有两种主流安装方式：

方式 1：通过 Docker 官方插件（推荐，与 Docker 版本联动）

上文安装 docker-compose-plugin 后，Compose 已作为 Docker 插件集成，使用方式为：

docker compose version  # 注意：无短横线（-）

方式 2：独立安装 Compose V2（二进制文件）

若需单独安装最新版 Compose：

# 下载最新版 Compose（替换版本号可指定版本，如 v2.23.0）
sudo curl -SL https://github.com/docker/compose/releases/download/v2.29.2/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose

# 添加执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 创建软链接（兼容旧命令）
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

# 验证版本
docker-compose version  # 传统方式（带短横线）

六、Docker 常用操作

操作	命令
启动 Docker 服务	sudo systemctl start docker
设置开机自启	sudo systemctl enable docker
重启 Docker 服务	sudo systemctl restart docker
查看容器列表	docker ps（运行中）/ docker ps -a（所有）
构建镜像	docker build -t 镜像名:版本 .
启动 Compose 应用	docker compose up -d（后台运行）
停止 Compose 应用	docker compose down
查看 Compose 日志	docker compose logs -f

七、常见问题解决

1. 权限不足：执行 docker 命令提示权限错误，确认已将用户加入 docker 组并重新登录（或执行 newgrp docker）。

2. 镜像拉取慢：配置国内镜像源（如阿里云、网易）：

   sudo mkdir -p /etc/docker
   sudo tee /etc/docker/daemon.json <<-'EOF'
   {
     "registry-mirrors": ["https://mirror.aliyuncs.com"]
   }
   EOF
   sudo systemctl daemon-reload
   sudo systemctl restart docker
   

3. Containerd 冲突：Ubuntu 24.04 自带 containerd，若启动失败，执行：

   sudo rm /etc/containerd/config.toml
   sudo systemctl restart containerd
   

八、版本说明

• Docker Engine：Ubuntu 24.04 兼容最新稳定版（25.x 系列）。

• Docker Compose：V2 为官方主推版本，完全兼容 V1 的 docker-compose.yml 配置文件。

通过以上步骤，即可在 Ubuntu 24.04 中完成 Docker 与 Docker Compose 的完整部署，满足容器化应用开发、部署需求。