Ubuntu 22.04 安装 Docker 及 Docker Compose v2 教程

启动 Docker 服务并运行 hello-world 容器，验证 Docker 引擎是否正常工作。

# 启动 Docker 服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
# 验证 Docker 服务状态（显示 active (running) 即为正常）
sudo systemctl status docker
# 运行 hello-world 容器（拉取测试镜像并启动）
sudo docker run hello-world

若输出 Hello from Docker! 相关信息，说明 Docker 安装成功。

2.5 配置 Docker 镜像加速（解决拉取慢问题）

为 Docker 配置国内镜像加速器（阿里云、网易云均可），大幅提升镜像拉取速度。以阿里云为例：

1. 登录阿里云容器镜像服务（需注册阿里云账号），在「镜像工具」-「镜像加速器」中获取专属加速地址（每个人的地址不同）。
2. 创建 Docker 配置目录并编写加速配置文件：

# 创建 Docker 配置目录
sudo mkdir -p /etc/docker
# 编写镜像加速配置（替换为你的阿里云加速地址）
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://xxxxxx.mirror.aliyuncs.com"]
}
EOF
# 重启 Docker 服务使配置生效
sudo systemctl daemon-reload
sudo systemctl restart docker

验证加速配置是否生效：

sudo docker info | grep "Registry Mirrors"

若输出配置的加速地址，说明配置成功。

2.6 配置非 root 用户运行 Docker（可选）

默认情况下，只有 root 用户和 docker 组用户可运行 Docker 命令，为避免每次输入 sudo，可将当前用户加入 docker 组：

# 将当前用户加入 docker 组
sudo usermod -aG docker $USER
# 注销当前用户并重新登录（使权限生效）
# 重新登录后验证（无需 sudo 运行 docker 命令）
docker info

三、安装 Docker Compose v2

3.1 配置 Docker 阿里软件源

由于你已安装 Docker，先更新 Docker 软件源为阿里源，保证 docker-compose-plugin 包可正常获取：

1. 安装必要依赖包

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

2. 添加阿里 Docker 官方 GPG 密钥

curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

3. 配置阿里 Docker 软件源（替换原有源）

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

4. 更新软件包索引

sudo apt update

3.2 核心步骤：安装 Docker Compose v2 插件（docker-compose-plugin）

Docker Compose v2 在 Ubuntu 软件源中以 docker-compose-plugin 包的形式提供，直接通过 apt 安装即可（阿里源已配置，无需额外下载）：

sudo apt install -y docker-compose-plugin

3.3 （可选）优化：配置命令别名（兼容 v1 习惯）

如果你习惯使用 v1 的 docker-compose（带短横线）命令，可以添加别名实现兼容，无需修改原有操作习惯：

1. 临时别名（仅当前终端有效）

alias docker-compose='docker compose'

2. 永久别名（所有终端、重启后仍有效）

# 写入用户环境变量配置文件
echo "alias docker-compose='docker compose'" >> ~/.bashrc
# 生效配置（如果使用 zsh，替换为 source ~/.zshrc）
source ~/.bashrc

配置完成后，即可使用 docker-compose version 验证别名是否生效。

四、Docker Compose v2 基础使用示例

以运行一个简单的 Nginx 容器为例，演示 Docker Compose v2 的使用流程。

# 创建示例目录并进入
mkdir -p ~/docker-compose-demo && cd ~/docker-compose-demo
# 创建 docker-compose.yml 文件
tee docker-compose.yml <<-'EOF'
version: '3.8'
services:
  nginx:
    image: nginx:latest
    ports:
      - "8080:80"
    volumes:
      - ./nginx/html:/usr/share/nginx/html
    restart: always
EOF
# 创建 Nginx 静态文件目录并添加测试页面
mkdir -p ./nginx/html
echo "<h1>Docker Compose v2 Test (Ubuntu22.04)</h1>" > ./nginx/html/index.html
# 启动容器（后台运行）
docker-compose up -d
# 验证容器状态
docker-compose ps
# 访问测试（本地访问或远程访问服务器 IP:8080）
curl http://localhost:8080

若输出 <h1>Docker Compose v2 Test (Ubuntu22.04)</h1>，说明 Docker Compose 运行正常。后续可通过 docker-compose down 停止并删除容器。

五、补充说明

1. Docker Compose v2 的配置文件仍支持 docker-compose.yml（或 docker-compose.yaml），功能与 v1 完全兼容且性能更优；
2. 若安装过程中提示包不存在，可重新执行 sudo apt update 刷新软件源索引后重试；
3. 阿里源的 docker-ce 仓库已包含最新版 docker-compose-plugin，无需额外手动下载二进制文件。

六、总结

本文完成了 Ubuntu 22.04 系统下 Docker 引擎与 Docker Compose v2 的完整安装，核心优化了中国网络环境下的镜像源和加速配置，同时覆盖了权限配置、基础使用及常见问题排查。后续可结合实际业务场景，使用 Docker Compose 编排微服务容器，提升部署效率。若需进一步配置 Docker 集群（如 Swarm）或集成 CI/CD 流程，可参考官方文档或相关技术教程。