Ubuntu 24.04 安装 Docker 与 Docker Compose（官方推荐方式）#

本文档适用于 Ubuntu 24.04 LTS（Noble），采用 Docker 官方推荐 的安装方式，包含 Docker Engine 与 Docker Compose（v2 插件版），适合开发机与服务器环境。

一、卸载可能存在的旧版本（建议先执行）#

1
sudo apt remove -y docker docker-engine docker.io containerd runc docker-compose
2
sudo apt autoremove -y

二、安装基础依赖#

1
sudo apt update
2
sudo apt install -y \
3
  ca-certificates \
4
  curl \
5
  gnupg \
6
  lsb-release

三、添加 Docker 官方 GPG Key（Ubuntu 24.04 推荐方式）#

1
sudo mkdir -p /etc/apt/keyrings
2
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
3
  | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
4
sudo chmod a+r /etc/apt/keyrings/docker.gpg

四、添加 Docker 官方软件源（支持 24.04）#

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

更新索引：

1
sudo apt update

五、安装 Docker Engine + Docker Compose（v2 插件）#

1
sudo apt install -y \
2
  docker-ce \
3
  docker-ce-cli \
4
  containerd.io \
5
  docker-buildx-plugin \
6
  docker-compose-plugin

说明

Ubuntu 24.04 不再推荐 安装旧版 docker-compose（Python 版）

官方标准是：docker compose（Compose v2 插件）

六、验证 Docker 是否安装成功#

查看版本：

1
docker --version

测试运行容器：

1
sudo docker run hello-world

看到 Hello from Docker! 即表示成功。

七、配置非 root 用户运行 Docker（强烈推荐）#

1
sudo usermod -aG docker $USER

然后 必须重新登录或重启系统：

1
logout
2
# 或
3
reboot

验证：

1
docker ps

如果无权限错误，说明配置成功。

八、Docker Compose 正确使用方式（重要）#

1️⃣ 查看 Compose 版本#

1
docker compose version

示例输出：

1
Docker Compose version v2.x.x

2️⃣ 启动一个 Compose 项目#

1
docker compose up -d

❌ 不推荐的旧方式#

1
docker-compose up

九、设置 Docker 开机自启（可选）#

1
sudo systemctl enable docker
2
sudo systemctl start docker

十、常见问题排查#

1️⃣ `docker compose` 命令不存在#

1
sudo apt install docker-compose-plugin

2️⃣ 权限错误（permission denied）#

1
sudo usermod -aG docker $USER
2
# 然后重新登录

3️⃣ 镜像拉取速度慢#

可配置镜像加速器（阿里云 / DaoCloud / 私有 Harbor），示例：

1
{
2
  "registry-mirrors": [
3
    "https://registry.docker-cn.com",
4
    "https://docker.mirrors.ustc.edu.cn"
5
  ]
6
}

配置路径：

1
sudo nano /etc/docker/daemon.json
2
sudo systemctl restart docker

十一、进阶建议（开发者向）#

适合以下场景：

AI Agent / MCP 服务
Android / AOSP 编译隔离
Node / Python / Astro 多工具链共存

建议实践：

使用 docker compose 管理多服务
一个项目一个 compose
编译环境、运行环境彻底解耦

十二、参考命令速查表#

1
# Docker
2
 docker --version
3
 docker ps
4
 docker images
5
 docker run hello-world
6

7
# Docker Compose
8
 docker compose version
9
 docker compose up -d
10
 docker compose down

Lovely Jacky!

From Undreamt Night, I Thence Shine

安装 Docker 与 Docker Compose

Ubuntu 24.04 安装 Docker 与 Docker Compose（官方推荐方式）#

一、卸载可能存在的旧版本（建议先执行）#

二、安装基础依赖#

三、添加 Docker 官方 GPG Key（Ubuntu 24.04 推荐方式）#

四、添加 Docker 官方软件源（支持 24.04）#

五、安装 Docker Engine + Docker Compose（v2 插件）#

六、验证 Docker 是否安装成功#

七、配置非 root 用户运行 Docker（强烈推荐）#

八、Docker Compose 正确使用方式（重要）#

1️⃣ 查看 Compose 版本#

2️⃣ 启动一个 Compose 项目#

❌ 不推荐的旧方式#

九、设置 Docker 开机自启（可选）#

十、常见问题排查#

1️⃣ `docker compose` 命令不存在#

2️⃣ 权限错误（permission denied）#

3️⃣ 镜像拉取速度慢#

十一、进阶建议（开发者向）#

十二、参考命令速查表#

赞助支持

目录

Lovely Jacky!

From Undreamt Night, I Thence Shine

安装 Docker 与 Docker Compose

Ubuntu 24.04 安装 Docker 与 Docker Compose（官方推荐方式）#

一、卸载可能存在的旧版本（建议先执行）#

二、安装基础依赖#

三、添加 Docker 官方 GPG Key（Ubuntu 24.04 推荐方式）#

四、添加 Docker 官方软件源（支持 24.04）#

五、安装 Docker Engine + Docker Compose（v2 插件）#

六、验证 Docker 是否安装成功#

七、配置非 root 用户运行 Docker（强烈推荐）#

八、Docker Compose 正确使用方式（重要）#

1️⃣ 查看 Compose 版本#

2️⃣ 启动一个 Compose 项目#

❌ 不推荐的旧方式#

九、设置 Docker 开机自启（可选）#

十、常见问题排查#

1️⃣ docker compose 命令不存在#

2️⃣ 权限错误（permission denied）#

3️⃣ 镜像拉取速度慢#

十一、进阶建议（开发者向）#

十二、参考命令速查表#

赞助支持

目录

1️⃣ `docker compose` 命令不存在#