一、Docker 支持的 Ubuntu 环境

（一）系统版本要求

Docker Engine-Community 对 Ubuntu 系统的支持具有明确的版本范围，以下为官方支持的 LTS 及最新版本：

• Xenial 16.04（长期支持版）
• Bionic 18.04（长期支持版）
• Cosmic 18.10
• Disco 19.04
• 及其他更新版本

（二）硬件架构支持

Docker 引擎对硬件架构的兼容性较强，具体包括：

• x86_64（amd64）架构
• armhf 与 arm64 架构（适用于 ARM 设备）
• s390x（IBM Z 大型机架构）
• ppc64le（IBM Power 架构）

二、自动化快速安装方案

（一）官方脚本安装优势

通过官方提供的 Shell 脚本可实现一键式安装，适合快速搭建测试环境，其特点包括：

• 自动检测系统版本并配置对应仓库
• 一键完成依赖项安装与环境配置
• 快速获取最新边缘版本或测试版本

（二）执行安装命令

# 下载安装脚本
curl -fsSL https://test.docker.com -o test-docker.sh
# 执行安装脚本（需管理员权限）
sudo sh test-docker.sh

（三）注意事项

• 脚本需 root 或 sudo 权限执行，建议先审查脚本内容
• 会自动安装所有依赖项，可能引入大量额外软件包
• 默认安装 edge 通道的最新版本，不支持版本自定义
• 生产环境不建议使用此方法，推荐手动精确安装

三、手动精确安装流程

（一）卸载旧版本 Docker

在安装新版本前，需清理旧版 Docker 相关组件：

sudo apt-get remove docker docker-engine docker.io containerd runc

（二）配置软件仓库

1. 更新包索引并安装依赖

sudo apt-get update
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

2. 添加 Docker 官方 GPG 密钥

curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

3. 设置稳定版软件源

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/ \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

4. 刷新包索引以识别新仓库

sudo apt-get update

（三）安装指定版本 Docker

1. 安装最新稳定版

sudo apt-get install docker-ce docker-ce-cli containerd.io

2. 安装特定版本（先查询可用版本）

# 列出仓库中所有可用版本
apt-cache madison docker-ce
# 示例输出：
# docker-ce | 5:18.09.1~3-0~ubuntu-xenial | https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu xenial/stable amd64 Packages
# 选择版本安装
sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io

四、安装验证与基本使用

（一）运行验证容器

sudo docker run hello-world

（二）预期输出解析

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
1b930d010525: Pull complete
Digest: sha256:c3b4ada4687bbaa170745b3e4dd8ac3f194ca95b2d0518b417fb47e5879d9b5f
Status: Downloaded newer image for hello-world:latest
Hello from Docker!
...（中间为运行流程说明）

• 输出表明 Docker 客户端与守护进程通信正常
• 系统自动从 Docker Hub 拉取测试镜像并运行
• 若看到 "Hello from Docker!" 则安装成功

（三）进阶测试（运行交互式 Ubuntu 容器）

docker run -it ubuntu bash

• -i 参数保持标准输入交互
• -t 参数分配伪终端
• 成功进入容器后可执行 exit 退出

五、非 root 用户配置

（一）安全权限优化

默认情况下 Docker 服务需管理员权限运行，为避免每次使用 sudo，可将用户添加到 docker 组：

sudo usermod -aG docker your-user

（二）生效方式

• 添加后需重新登录用户会话使组权限生效
• 或执行 newgrp docker 命令立即刷新权限

六、完整卸载流程

（一）移除 Docker 软件包

sudo apt-get purge docker-ce

（二）清理数据文件

sudo rm -rf /var/lib/docker

（三）额外清理（可选）

# 移除残留配置文件
sudo rm -rf /etc/docker
# 清理镜像、容器、网络等数据
sudo rm -rf /var/lib/containerd

七、安装注意事项与最佳实践

（一）生产环境建议

• 优先使用仓库安装方式，便于版本控制和依赖管理
• 明确指定 Docker 版本，避免因自动更新导致环境变化
• 配置国内镜像源（如阿里云、中科大镜像）提升拉取速度

（二）镜像源配置示例

# 创建 Docker 配置目录
sudo mkdir -p /etc/docker
# 写入镜像源配置
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF
# 重启 Docker 服务使配置生效
sudo systemctl restart docker