Ubuntu 安装 Docker CE 和 Docker Compose 最新教程(2026)

Ubuntu 安装 Docker CE 和 Docker Compose 最新教程（2026）

适用于：
Ubuntu 20.04 LTS
Ubuntu 22.04 LTS
Ubuntu 24.04 LTS
Ubuntu 26.04 LTS
支持：
Docker Engine
Docker Compose V2
Docker Buildx
ARM64 / AMD64

一、检查系统版本

查看 Ubuntu 信息：

cat /etc/os-release

示例：

PRETTY_NAME="Ubuntu 22.04.5 LTS"VERSION_CODENAME=jammy

查看 CPU 架构：

dpkg --print-architecture

常见：

amd64

或者：

arm64

二、卸载旧版本 Docker（可选）

如果之前安装过：

docker.io
docker-compose
containerd
runc

建议先卸载。

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

注意：

这个不会删除：

/var/lib/docker

里面已有镜像和容器数据。

如果需要彻底清理：

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

三、安装 Docker 依赖

更新软件源：

sudo apt update

安装依赖：

sudo apt install -y \ca-certificates \curl \gnupg

四、添加 Docker 官方 GPG Key

创建 key 存储目录：

sudo install -m 0755 -d /etc/apt/keyrings

下载 Docker 官方签名：

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

五、添加 Docker 官方软件源

自动识别 Ubuntu 版本：

echo \"Types: debURIs: https://download.docker.com/linux/ubuntuSuites: {UBUNTU_CODENAME:-(dpkg --print-architecture)Signed-By: /etc/apt/keyrings/docker.asc" \| sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null

更新：

sudo apt update

六、安装 Docker Engine + Compose

执行：

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

安装内容：

组件	作用
docker-ce	Docker 服务
docker-ce-cli	Docker 命令行
containerd.io	容器运行时
docker-buildx-plugin	高级构建
docker-compose-plugin	Compose V2

七、启动 Docker 服务

设置开机启动：

sudo systemctl enable docker

启动：

sudo systemctl start docker

查看状态：

systemctl status docker

看到：

Active: active (running)

表示成功。

八、配置普通用户运行 Docker（推荐）

默认 Docker 需要：

sudo docker ps

为了方便开发，把当前用户加入 docker 组：

sudo usermod -aG docker $USER

退出当前 SSH：

exit

重新登录。

测试：

docker ps

如果没有权限错误：

配置成功。

九、验证 Docker

查看版本：

docker version

示例：

Docker version 28.x.x

测试运行：

docker run hello-world

成功：

Hello from Docker!This message shows that your installation appears to be working correctly.

十、验证 Docker Compose

新版 Compose 已经集成到 Docker：

查看：

docker compose version

输出：

Docker Compose version v2.x.x

注意：

现在推荐：

docker compose up -d

不要再使用：

docker-compose up -d

旧版 docker-compose 属于 Compose V1。

十一、Docker Compose 示例

创建目录：

mkdir nginx-testcd nginx-test

创建：

vim compose.yaml

写入：

services:  nginx:    image: nginx:latest    container_name: nginx-test    ports:      - "8080:80"    restart: always

启动：

docker compose up -d

查看：

docker ps

停止：

docker compose down

十二、常用 Docker 命令

查看运行容器：

docker ps

查看全部：

docker ps -a

查看日志：

docker logs -f 容器名

进入容器：

docker exec -it 容器名 bash

查看镜像：

docker images

删除镜像：

docker rmi 镜像ID

清理无用资源：

docker system prune

十三、国内服务器优化（可选）

如果服务器访问 Docker Hub 较慢，可以配置镜像加速。

创建：

sudo mkdir -p /etc/docker

编辑：

sudo vim /etc/docker/daemon.json

例如：

{  "registry-mirrors": [    "https://docker.m.daocloud.io"  ]}

重启：

sudo systemctl restart docker

十四、检查 Docker 配置

查看：

docker info

关注：

Docker Root Dir

默认：

/var/lib/docker

如果磁盘空间不足，可以迁移 Docker 数据目录。

总结

推荐生产环境安装方式：

Ubuntu |Docker 官方 APT仓库 |docker-ce |containerd |docker compose v2

不要使用：

❌ Ubuntu 自带 docker.io

❌ pip 安装 docker-compose

❌ curl | bash 一键脚本用于生产环境