Ubuntu 24.04/26.04 环境下 Docker 引擎与 Compose 插件安装配置全攻略 (2026版)
前序（Preface）
1. 文档概述
随着容器化技术的持续演进，Docker 已成为现代软件开发、测试与部署的基石。本指南针对 2026 年主流的 Ubuntu 长期支持版 (LTS) 系统，提供了从内核依赖、官方源配置到跨平台（WSL2）兼容性处理的标准化安装流程。
2. 修订背景
本指南在原始安装流程的基础上，结合了 2026 年最新的容器标准进行了以下优化：
架构升级：默认集成 Docker Compose V2 插件，弃用旧版独立二进制安装方式。
WSL2 深度适配：针对 Windows 子系统用户，优先推荐 Systemd 引导方案，解决传统网络链（iptables）的冲突问题。
安全性增强：采用最新的
keyrings密钥管理规范，取代已过时的apt-key方法。
Ubuntu 安装 Docker 完整指南 (2026)
本指南适用于原生 Ubuntu 系统及 Windows Subsystem for Linux (WSL2)。
一、 系统环境准备
首先确保系统包索引是最新的：
bash
sudo apt update
sudo apt upgrade -y
请谨慎使用此类代码。
二、 安装核心依赖
安装 Docker 运行及仓库管理所需的必要工具：
bash
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common gnupg
请谨慎使用此类代码。
三、 配置 Docker 官方软件源
添加 GPG 密钥（用于验证软件包安全性）：
bash
sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg请谨慎使用此类代码。
添加 APT 仓库：
bash
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null请谨慎使用此类代码。
四、 安装 Docker 引擎
更新索引并安装 Docker 社区版及最新插件（包含 Docker Compose 插件）：
bash
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
请谨慎使用此类代码。
五、 服务启动与环境适配
1. 原生 Ubuntu 系统
直接使用 systemctl 启动：
bash
sudo systemctl start docker
sudo systemctl enable docker
请谨慎使用此类代码。
2. WSL2 用户特别注意
在 2026 年，推荐通过开启 WSL 的 systemd 支持来获得与原生系统一致的体验。
方法 A (推荐)：编辑
/etc/wsl.conf，添加以下内容：ini
[boot] systemd=true请谨慎使用此类代码。
保存后在 PowerShell 中执行
wsl --shutdown重启。方法 B (兼容旧版)：若不开启 systemd，请执行以下命令切换网络驱动：
bash
sudo update-alternatives --set iptables /usr/sbin/iptables-legacy sudo service docker start请谨慎使用此类代码。
六、 验证安装
运行测试镜像：
bash
sudo docker run hello-world
请谨慎使用此类代码。
若看到 Hello from Docker!，则表示安装成功。
七、 高级配置（可选）
1. 非 Root 用户运行 Docker
避免每次输入 sudo：
bash
sudo usermod -aG docker $USER
newgrp docker # 立即在当前终端生效，无需注销
请谨慎使用此类代码。
2. 验证 Docker Compose
现代版本已集成，使用以下命令检查：
bash
docker compose version
请谨慎使用此类代码。
3. 配置镜像加速器（中国大陆地区）
若下载镜像缓慢，编辑 /etc/docker/daemon.json：
json
{
"registry-mirrors": [
"https://mirror.baidubce.com",
"https://docker.pullmirror.com"
]
}
请谨慎使用此类代码。
重启服务：sudo systemctl restart docker
相关链接：