在 Debian 12 (Bookworm) 系统上，Docker 和 Docker Compose 的安装已高度集成。现代 Docker 版本（20.10+）将 Compose 作为 CLI 插件提供，无需单独安装两个独立软件。以下是官方推荐的最新安装流程，适用于 Debian 12 x86_64 系统：

一、标准安装步骤
1. 卸载旧版本（避免冲突）

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

2. 安装依赖并配置官方仓库

# 更新系统并安装基础依赖
sudo apt update
sudo apt install -y ca-certificates curl gnupg
# 添加 Docker 官方 GPG 密钥
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# 添加 Docker 仓库（**关键：指定 Debian 12 代号 bookworm**）
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 更新软件包索引
sudo apt update

3. 安装 Docker 引擎及 Compose 插件

# 安装核心组件（**包含 docker-compose-plugin**）
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

关键说明：docker-compose-plugin 是现代 Docker 的官方集成方案，安装后可通过 docker compose（带空格）命令直接使用 Compose 功能。
二、安装后配置
1. 启动服务并设置开机自启

sudo systemctl enable docker
sudo systemctl start docker

2. 将当前用户加入 docker 组（避免每次用 sudo）

sudo usermod -aG docker $USER
newgrp docker  # 立即生效（无需重启）

3. 安装验证 Docker 引擎

docker --version
# 正常输出示例：Docker version 26.1.4, build 73eaf02

验证 Docker Compose 插件

docker compose version
# 正常输出示例：Docker Compose version v2.27.1

注意：命令是 docker compose（带空格），不是旧版的 docker-compose（带连字符）。
测试运行

docker run --rm hello-world
# 应输出：Hello from Docker! ... working correctly

三、关键问题解答
1. 为何无需单独安装两个工具？
Docker Compose 已作为插件集成：从 Docker 20.10 版本起，Compose 功能通过 docker-compose-plugin 包提供，安装后直接使用 docker compose 命令，无需额外安装独立组件。
旧版 docker-compose 已弃用：通过 GitHub 下载的独立 docker-compose 二进制文件（命令为 docker-compose）官方已不再维护，仅用于兼容旧脚本。
2. 如果只需基础功能，能否简化安装？
可以：若仅需 Compose 的基础功能（非最新特性），Debian 12 官方仓库提供的 docker.io 包已包含 Compose：

sudo apt install -y docker.io docker-compose  # 旧版集成方案（不推荐）

缺点：版本较旧（Debian 12 的 docker.io 当前为 24.0.7，低于官方最新版 26.x），缺少安全更新和新特性。
3. 常见问题处理
镜像拉取缓慢（国内用户必看）
创建配置文件加速国内拉取：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://hub-mirror.c.163.com",
    "https://docker.1panel.live"
  ]
}
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker

生效验证：docker info | grep "Registry Mirrors" -A 2。
误装旧版 docker-compose 的处理
若已安装旧版独立 Compose，无需卸载，但应优先使用新命令：

# 旧版命令（不推荐）
docker-compose --version

# 新版命令（官方推荐）
docker compose version  # **始终使用此命令**

总结

1安装命令本质是安装一个套件：通过 sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin 一步完成 Docker 引擎和 Compose 插件的安装。
2Compose 是 Docker 的扩展功能：安装后直接使用 docker compose（带空格）命令，无需单独安装或配置两个工具。
3务必验证命令格式：运行 docker compose version（非 docker-compose），空格是关键语法差异。
4国内用户必须配置镜像加速：否则 docker pull 会极慢或失败。

声明：未经同意禁止任何个人或组织复制、盗用、采集、发布本站点内容到其他媒体平台。