概述

Docker 是一个开源的应用容器引擎，允许开发者将应用及其依赖打包到一个可移植的容器中，从而实现快速部署和跨平台运行。本指南将详细介绍在 Ubuntu 系统上安装 Docker 的完整步骤，特别使用了清华大学镜像源以加速国内用户的下载过程。

准备工作

在开始安装前，请确保：

• 使用的是 Ubuntu 系统（本教程适用于 Ubuntu 16.04 及以上版本）
• 拥有 sudo 权限或 root 用户权限
• 能够访问互联网

完整安装步骤

1. 卸载旧版本（如有）

为避免版本冲突，建议先卸载系统中可能存在的旧版本 Docker：

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

注意：如果这是首次安装 Docker，系统中可能没有这些旧版本，但执行此命令可以确保环境的清洁。

2. 设置 Docker 仓库

2.1 更新系统包索引

sudo apt-get update

2.2 安装必要的依赖包

sudo apt-get install ca-certificates curl

2.3 创建密钥目录并设置权限

sudo install -m 0755 -d /etc/apt/keyrings

2.4 下载 Docker 官方 GPG 密钥（使用国内镜像）

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

2.5 设置密钥文件权限

sudo chmod a+r /etc/apt/keyrings/docker.asc

2.6 添加 Docker 仓库源（使用清华镜像）

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

重要说明：此命令自动检测系统架构和 Ubuntu 版本代号，确保添加正确的仓库地址。

3. 安装 Docker 引擎

3.1 再次更新包索引

sudo apt-get update

3.2 安装 Docker 及相关组件

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

安装的组件说明：

• docker-ce: Docker 社区版
• docker-ce-cli: Docker 命令行工具
• containerd.io: 容器运行时
• docker-buildx-plugin: 扩展构建功能
• docker-compose-plugin: Docker Compose 插件（用于多容器应用）

4. 启动和启用 Docker 服务

4.1 启动 Docker 服务

sudo systemctl start docker

4.2 设置 Docker 开机自启

sudo systemctl enable docker

验证安装

安装完成后，可以通过以下命令验证 Docker 是否正确安装：

# 查看 Docker 版本信息
sudo docker version

# 运行测试容器
sudo docker run hello-world

如果看到 “Hello from Docker!” 的消息，说明 Docker 已成功安装并正常运行。

配置非 root 用户使用 Docker（可选）

默认情况下，Docker 需要 sudo 权限。如果您希望普通用户也能运行 Docker 命令，可以将用户添加到 docker 组：

sudo usermod -aG docker $USER

注意：执行此命令后，需要注销并重新登录才能生效。

常见问题解决

1. 如果遇到 GPG 密钥错误

可以尝试重新下载密钥：

sudo rm /etc/apt/keyrings/docker.asc
sudo curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo apt-get update

2. 如果仓库地址无法访问

可以尝试其他国内镜像源，如阿里云：

# 替换清华源为阿里云源
sudo sed -i 's|https://mirrors.tuna.tsinghua.edu.cn/docker-ce|https://mirrors.aliyun.com/docker-ce|g' /etc/apt/sources.list.d/docker.list
sudo apt-get update

3. 安装特定版本的 Docker

如果需要安装特定版本，可以先查看可用版本：

apt-cache madison docker-ce

然后安装指定版本：

sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io

配置 Docker 镜像加速（推荐）

为进一步加速 Docker 镜像的拉取，可以配置国内镜像加速器：

1. 创建或修改 Docker 配置文件：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF

2. 重启 Docker 服务使配置生效：

sudo systemctl restart docker

总结

通过以上步骤，已经成功在 Ubuntu 系统上安装了 Docker 社区版。使用清华大学镜像源可以显著加快下载速度，特别适合国内用户。安装完成后，可以开始使用 Docker 来创建、部署和运行容器化应用程序。

Docker 的强大功能将在开发、测试和部署工作中发挥重要作用，帮助实现环境一致性和快速部署。现在，可以尝试拉取其他镜像或创建自己的 Dockerfile 来构建自定义镜像了。

提示：建议定期更新 Docker 以获得最新功能和安全补丁：

sudo apt-get update
sudo apt-get upgrade

1.卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc

2.设置仓库
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo “deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu KaTeX parse error: Expected 'EOF', got '&' at position 20: …etc/os-release &̲& echo \"VERSION_CODENAME”) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

3. 安装Docker
   sudo apt-get update
   sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4. 启动
   sudo systemctl start docker
   sudo systemctl enable docker