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/docker
sudo 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: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo ${UBUNTU_CODENAME:-$VERSION_CODENAME})
Components: stable
Architectures: $(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 服务

设置开机启动：

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-test

cd 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 一键脚本用于生产环境