# 在 Ubuntu Server 上安装 Docker 与 Docker Compose

本文档提供在 **Ubuntu Server (18.04/20.04/22.04/24.04 及更新版本)** 上安装 **Docker Engine** 与 **Docker Compose 插件**的最新官方方法，并附带卸载步骤。

---

## 📋 前置条件
- Ubuntu Server 64 位版本  
- 拥有 `sudo` 权限的用户  
- 网络正常可访问 Docker 官方仓库  

---

## 🚀 安装步骤

### 1. 更新系统
```bash
sudo apt update
sudo apt upgrade -y

2. 安装依赖

bash

sudo apt install -y ca-certificates curl gnupg lsb-release

3. 添加 Docker 官方 GPG 密钥

bash

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

4. 设置 Docker 官方仓库

bash

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

5. 安装 Docker Engine 与 CLI

bash

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

6. 验证安装

bash

docker --version
docker compose version

输出类似：

代码

Docker version 25.x.x, build xxxx
Docker Compose version v2.x.x

⚙️ 使用示例

运行一个测试容器：

bash

sudo docker run hello-world

运行一个 Compose 示例：

bash

mkdir ~/test-compose && cd ~/test-compose
cat <<EOF > compose.yaml
services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"
EOF

docker compose up -d

访问 http://服务器IP:8080 即可看到 Nginx 欢迎页。

🗑️ 卸载方法

1. 卸载 Docker Engine 与相关组件

bash

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

2. 删除残留文件

bash

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

3. 删除仓库配置与密钥

bash

sudo rm /etc/apt/sources.list.d/docker.list
sudo rm /etc/apt/keyrings/docker.gpg

📖 参考

• Docker 官方 Ubuntu 安装文档
• Docker Compose 插件官方指南
• 社区安装教程 (2025)
• Ubuntu 24.04 安装示例

🎯 总结

• 推荐方式：使用 Docker 官方仓库安装最新的 Docker Engine 与 Compose 插件。
• Compose v2 已集成到 Docker CLI，无需单独安装旧版 docker-compose。
• 卸载时记得清理 /var/lib/docker 和 /var/lib/containerd，避免残留。