当前位置：首页 > news >正文

在 Ubuntu Server 22.04 上安装 Docker 的详细步骤

news 2025/12/16 10:12:53

在 Ubuntu Server 22.04 上安装 Docker 的详细步骤

本文档详细记录了在 Ubuntu Server 22.04 上安装 Docker 的完整过程，包括解决过程中遇到的问题。希望能对读者有所帮助。

安装过程，重点需要看官方文档。https://docs.docker.com/engine/install/ubuntu/

卸载冲突的软件包
更新系统软件包
安装依赖包
添加 Docker 中科大 GPG 密钥
添加 Docker 中科大镜像稳定版软件源
再次更新软件包
安装最新版本的 Docker
配置 Docker 使用镜像加速器（hub）
重新启动 Docker 服务
验证 Docker 安装
实时查看 Docker 服务日志
附加资源
总结

步骤 1：卸载冲突的软件包

在安装 Docker Engine 之前，您需要卸载所有有冲突的软件包。发行版维护者在 APT 中提供了 Docker 软件包的非官方发行版。您必须先卸载这些软件包，然后才能安装 Docker Engine 的正式版本。

要卸载的非官方软件包包括：

docker.io
docker-compose
docker-compose-v2
docker-doc
podman-docker

此外，Docker Engine 依赖于 containerd 和 runc。Docker Engine 将这些依赖项捆绑为一个包：containerd.io。如果您之前安装了 containerd 或 runc，请卸载它们以避免与 Docker Engine 捆绑的版本发生冲突。

运行以下命令来卸载所有冲突的包：

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

apt-get 可能会报告您没有安装这些包。

注意：卸载 Docker 时，不会自动删除存储在 /var/lib/docker/ 中的图像、容器、卷和网络。如果您想从全新安装开始，并且希望清理所有现有数据，请阅读卸载 Docker Engine 部分。

步骤 2：更新系统软件包

首先，更新系统中的现有软件包：

sudo apt update

步骤 3：安装依赖包

安装必要的依赖包，这些包用于通过 HTTPS 获取软件仓库：

sudo apt install apt-transport-https ca-certificates curl software-properties-common

步骤 4：添加 Docker 中科大 GPG 密钥

为了确保下载的 Docker 软件包的真实性和完整性，我们需要添加 Docker 的 GPG 密钥：

sudo mkdir -p /etc/apt/keyrings
sudo curl -fsSL http://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

可能的问题

无法下载 GPG 密钥：
- 错误信息：curl: (6) Could not resolve host: mirrors.ustc.edu.cn
- 解决方案：在网上搜索其他镜像站点。参考连接：https://blog.csdn.net/m0_46471328/article/details/138043873
背景知识：GPG 密钥用于验证软件包的完整性和真实性，确保下载的软件包没有被篡改。

步骤 5：添加 Docker 中科大镜像稳定版软件源

我们使用中科大的镜像源来加快下载速度：

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

可能的问题

镜像源添加失败：
- 错误信息：bash: /etc/apt/sources.list.d/docker.list: Permission denied
- 解决方案：确保使用 sudo 运行命令以获得必要的权限。
背景知识：软件源是存储软件包的服务器地址，添加 Docker 的中科大镜像源可以加快下载速度，并提高可靠性。

步骤 6：再次更新软件包

添加新的 Docker 软件源后，再次更新系统中的软件包索引：

sudo apt update

可能的问题

更新失败：
- 错误信息：Failed to fetch http://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/dists/focal/stable/binary-amd64/Packages 404 Not Found
- 解决方案：检查 sources.list.d/docker.list 文件中的镜像源地址是否正确，并确认中科大镜像源可用。
背景知识：更新软件包索引是为了让系统知道最新的软件包信息，包括新添加的软件源中的包。

步骤 7：安装最新版本的 Docker

安装 Docker 及其依赖包：

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

可能的问题

安装失败：
- 错误信息：E: Unable to locate package docker-ce
- 解决方案：确保之前步骤中的镜像源已正确添加并更新了软件包索引。
背景知识：Docker 是一个开源的平台，用于开发、交付和运行应用程序。它将应用程序及其依赖项打包到一个标准化的单元中，称为容器。

步骤 8：配置 Docker 使用镜像加速器（hub）

由于国内访问 Docker Hub 可能会有速度和连接问题，我们配置 Docker 使用腾讯云的镜像加速器：

sudo mkdir -p /etc/docker
echo '{"registry-mirrors": ["https://ccr.ccs.tencentyun.com"]
}' | sudo tee /etc/docker/daemon.json > /dev/null

可能的问题

无法访问镜像加速器：
- 错误信息：dial tcp: lookup ccr.ccs.tencentyun.com on 127.0.0.53:53: no such host
- 解决方案：确保配置的镜像加速器地址正确并可访问，可能需要更换其他地址。地址 127.0.0.53:53 是一个本地 DNS 缓存服务，通常是由系统的 systemd-resolved 服务提供的。
背景知识：镜像加速器可以提高从 Docker Hub 拉取镜像的速度，特别是在国内网络环境下。

步骤 9：重新启动 Docker 服务

使配置生效，重新启动 Docker 服务：

sudo systemctl daemon-reload
sudo systemctl restart docker

步骤 10：验证 Docker 安装

运行一个简单的 Docker 容器来验证安装是否成功：

sudo docker run hello-world

可能的问题

无法访问 Docker Hub：
- 错误信息：denied: requested access to the resource is denied unauthorized: authentication required
- 解决方案：通过以下命令登录 Docker Hub：
```
sudo docker login
```
按照提示输入 Docker Hub 用户名和密码即可。
网络连接问题：
- 错误信息：dial tcp: lookup registry-1.docker.io on 127.0.0.53:53: no such host
- 解决方案：配置镜像加速器并重启 Docker 服务后，再次尝试拉取镜像。
背景知识：hello-world 镜像是一个非常小的镜像，用于验证 Docker 是否正常工作。

实时查看 Docker 服务日志

你可以使用以下命令实时查看 Docker 服务的日志：

sudo journalctl -u docker.service -f

这个命令的作用是：

sudo：以超级用户权限运行命令。
journalctl：查看系统日志的命令。
-u docker.service：指定查看 Docker 服务的日志。
-f：实时查看日志输出，类似于 tail -f。

附加资源

Docker 官方文档
Docker Hub
Docker 入门指南
Docker 社区支持

总结

通过上述步骤，我成功在 Ubuntu Server 22.04 上安装并配置了 Docker。主要就是镜像地址问题，通过调整配置文件和更换镜像源，我顺利解决了这些问题。希望你也一样。