在 Ubuntu 22.04 上安装 Docker 的步骤如下，分为安装 Docker 引擎和验证安装两部分，同时包含常用配置（如用户组权限）。

一、准备工作

确保系统已更新到最新状态：

sudo apt update && sudo apt upgrade -y

二、安装 Docker 引擎

1. 安装依赖工具

安装 curl、gnupg 等工具（用于后续添加 Docker 仓库）：

sudo apt install -y curl gnupg2 software-properties-common

2. 添加 Docker 官方 GPG 密钥

下载并导入 Docker 的 GPG 密钥（用于验证软件包完整性）：

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

3. 添加 Docker APT 仓库

将 Docker 的官方软件源添加到系统的 APT 源列表中（Ubuntu 22.04 代号为 jammy）：

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

4. 安装 Docker 包

更新 APT 索引并安装最新版 Docker 引擎（包含 docker-ce、docker-cli、containerd 等核心组件）：

sudo apt update  # 推荐要执行
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

三、启动并启用 Docker 服务

安装完成后，启动 Docker 服务并设置开机自启：

sudo systemctl start docker   # 启动服务
sudo systemctl enable docker  # 开机自动启动

四、验证 Docker 安装

运行一个测试容器（官方的 hello-world 镜像），验证 Docker 是否正常工作：

docker -v

sudo docker run hello-world

输出类似以下内容表示安装成功：

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

五、（可选）将当前用户加入 Docker 组

默认情况下，使用 Docker 命令需要 sudo 权限。为了方便，可将当前用户添加到 docker 用户组（避免每次使用 sudo）：

1. 添加用户到 docker 组

sudo usermod -aG docker $USER

2. 生效组权限

重新登录系统（或执行以下命令临时生效）：

newgrp docker

3. 验证（无需 sudo）

docker run hello-world  # 直接运行，无需 sudo

六、（可选）安装 Docker Compose

如果需要使用 Docker Compose（用于定义和运行多容器应用），可按以下步骤安装：

1. 下载最新稳定版 Compose

# 查询版本
COMPOSE_VERSION=$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep 'tag_name' | cut -d '"' -f 4)
# 查看版本
echo $COMPOSE_VERSION  # 例如显示：v2.37.1
# 方式一：先在window电脑开VPN下载（推荐）
# 备注：echo $(uname -s) 会显示：Linux
# 备注：echo $(uname -m) 会显示：x86_64
打开浏览器下载：https://github.com/docker/compose/releases/download/v2.37.1/docker-compose-Linux-x86_64
# 上传到以下位置：
cd /usr/local/bin/
# 备注：有备份到阿里网盘上：凤森工作台-网络应用-docker-compose-v2.29.6
# 方式二：直接在服务器上执行，太慢了
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

2. 设置执行权限

sudo chmod +x /usr/local/bin/docker-compose

3. 验证安装

docker-compose --version

常见问题

1. 内核兼容性：Docker 要求内核版本 ≥ 3.10，Ubuntu 22.04 默认内核（5.15+）完全兼容。
2. 防火墙问题：如果使用 ufw 防火墙，需允许 Docker 相关端口（通常无需额外配置，除非自定义规则）。
3. 镜像拉取失败：检查网络连接，或配置 Docker 镜像加速器（如阿里云、腾讯云镜像源）。

通过以上步骤，你已在 Ubuntu 22.04 上成功安装并配置了 Docker 引擎。