【Ubuntu 20.04 LTS】安装Docker引擎

要在Ubuntu上开始使用Docker引擎，确保你满足先决条件，然后安装Docker。

1 先决条件

1.1 系统要求

要安装Docker引擎，您需要以下Ubuntu版本之一的64位版本：

• Ubuntu Jammy 22.04 (LTS)
• Ubuntu Impish 21.10
• Ubuntu Focal 20.04 (LTS)
• Ubuntu Bionic 18.04 (LTS)

Docker引擎兼容x86_64（或amd64）、armhf、arm64和s390x架构。

1.2 卸载旧版本

旧版本的Docker以docker、docker.io或docker-engine为名。在尝试安装新版本之前，请卸载任何此类旧版本。

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

如果apt-get报告说这些软件包都没有安装，那也没关系。

当你卸载Docker时，存储在/var/lib/docker/中的图像、容器、卷和网络不会自动删除。如果你想从一个干净的安装开始，并且喜欢清理任何现有的数据，请参考卸载Docker引擎部分。

2 安装

你可以根据你的需要，以不同的方式安装Docker引擎：

• Docker引擎与Docker Desktop for Linux捆绑在一起。这是最简单、最快速的入门方式。
• 你也可以从Docker的apt资源库中设置和安装Docker引擎。
• 手动安装并手动管理升级。
• 使用脚本快速安装，只推荐用于测试和开发环境。

2.1 资源库安装

在新主机上首次安装Docker引擎之前，需要设置Docker存储库。之后，您可以从存储库安装和更新Docker。

2.1.1 设置存储库

1）更新apt软件包索引和安装包，以允许apt使用HTTPS上的存储库：

sudo apt-get update
1

sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release
1
2
3
4
5

2）添加Docker的官方GPG密钥：

sudo mkdir -p /etc/apt/keyrings
1

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
1

3）使用以下命令设置存储库：

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
1
2
3

2.1.2 安装Docker引擎

1）更新apt软件包索引：

sudo apt-get update
1

运行apt-get更新时收到GPG错误？
你的默认umask可能配置不当，阻止了对版本库公钥文件的检测。在更新软件包索引之前，尝试授予Docker公钥文件的读取权限:
sudo chmod a+r /etc/apt/keyrings/docker.gpg
sudo apt-get update

2）安装Docker Engine、containerd和Docker Compose。

※最新版安装
要安装最新版本，请运行：

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

※特定版本安装
要安装特定版本的Docker 引擎，请首先列出存储库中的可用版本：

apt-cache madison docker-ce | awk '{ print $3 }'
1

选择所需版本并安装：

VERSION_STRING=5:20.10.13~3-0~ubuntu-jammy
1

sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-compose-plugin
1

通过运行hello-world镜像，验证Docker引擎的安装是否成功：

 sudo docker run hello-world
1

这个命令下载一个测试镜像并在一个容器中运行。当容器运行时，它会打印出一条确认信息并退出。

你现在已经成功安装并启动了Docker引擎。docker用户组存在但不包含用户，这就是为什么你需要使用sudo来运行Docker命令。继续进行Linux的后期安装，以允许非特权用户运行Docker命令，并进行其他可选的配置步骤。

将用户$USER添加到docker组。

sudo usermod -aG docker $USER
1

newgrp docker
1

2.1.3 升级Docker引擎

要升级Docker引擎，请按照安装说明，选择你要安装的新版本。

2.2 软件包手动安装

如果你不能使用Docker的apt仓库来安装Docker引擎，你可以下载你的版本的deb文件并手动安装它。每次你想升级Docker引擎时，都需要下载一个新文件。

2.2.1 下载安装

1） 访问链接 https://download.docker.com/linux/ubuntu/dists/
2）在列表中选择你的Ubuntu版本。
3）进入pool/stable/，选择适用的架构（amd64、armhf、arm64或s390x）。
4）下载Docker Engine、CLI、container和Docker Compose包的以下deb文件：

containerd.io_<version>_<arch>.deb
docker-ce_<version>_<arch>.deb
docker-ce-cli_<version>_<arch>.deb
docker-compose-plugin_<version>_<arch>.deb
1
2
3
4

5）安装.deb包。将下面例子中的路径改为你下载Docker包的地方。

sudo dpkg -i ./containerd.io_<version>_<arch>.deb \
	./docker-ce_<version>_<arch>.deb \
	./docker-ce-cli_<version>_<arch>.deb \
	./docker-compose-plugin_<version>_<arch>.deb
1
2
3
4

Docker守护程序自动启动。
6）通过运行hello-world镜像，验证Docker引擎的安装是否成功：

sudo docker run hello-world
1

这个命令下载一个测试镜像并在一个容器中运行。当容器运行时，它会打印出一条确认信息并退出。

你现在已经成功安装并启动了Docker引擎。docker用户组存在但不包含用户，这就是为什么你需要使用sudo来运行Docker命令。继续进行Linux的后期安装，以允许非特权用户运行Docker命令，并进行其他可选的配置步骤。

将用户$USER添加到docker组。

sudo usermod -aG docker $USER
1

newgrp docker
1

2.2.2 升级Docker引擎

要升级Docker引擎，请按照安装说明，选择你要安装的新版本。

2.3 脚本快速安装

Docker在https://get.docker.com/上提供了一个方便的脚本，可以将Docker以非交互式的形式安装到开发环境。此安装方式不建议在生产环境中使用，但它对于根据你的需求创建一个配置脚本很有用。另请参阅使用存储库安装步骤，了解使用软件包仓库的安装步骤。该脚本的源代码是开源的，可以在GitHub上的docker-install仓库找到。

2.3.1 装前须知

在本地运行从互联网上下载的脚本之前，一定要检查这些脚本。安装之前，请熟悉脚本的潜在风险和限制：

• 该脚本需要root或sudo权限才能运行。
• 该脚本试图检测你的Linux发行版和版本，并为你配置你的软件包管理系统。
• 该脚本不允许你自定义大多数安装参数。
• 脚本在不要求确认的情况下安装依赖关系和建议。这可能会安装大量的软件包，这取决于你的主机的当前配置。
• 默认情况下，该脚本安装的是Docker、containerd和runc的最新稳定版本。当使用该脚本配置机器时，这可能会导致Docker的主要版本意外升级。在部署到生产系统之前，一定要在测试环境中测试升级。
• 该脚本不是为升级现有的Docker安装而设计的。当使用该脚本更新现有的安装时，依赖关系可能不会被更新到预期的版本，导致版本过期。

提示：运行前预览脚本步骤
你可以用DRY_RUN=1选项来运行该脚本，以了解该脚本在被调用时将运行哪些步骤。
curl -fsSL https://get.docker.com -o get-docker.sh
DRY_RUN=1 sudo sh ./get-docker.sh

2.3.2 安装最新稳定版本

此示例从下载脚本https://get.docker.com/并运行它在Linux上安装最新稳定版本的Docker：

curl -fsSL https://get.docker.com -o get-docker.sh
1

sudo sh get-docker.sh
1

你现在已经成功安装并启动了Docker引擎。在基于Debian的发行版上，docker服务会自动启动。在基于RPM的发行版上，如CentOS、Fedora、RHEL或SLES，你需要使用适当的systemctl或service命令手动启动它。如信息所示，非root用户默认不能运行Docker命令。

2.3.3 安装预发布版本

Docker还在https://test.docker.com/，提供了一个方便的脚本，用于在Linux上安装Docker的预发布版本。这个脚本与get.docker.com上的脚本相同，但将你的软件包管理器配置为使用Docker软件包库的测试通道。测试通道包括Docker的稳定版和预发布版（测试版beta versions ，候选版release-candidates）。使用这个脚本可以提前获得新版本，并在稳定版发布之前在测试环境中评估它们。

要从测试通道在Linux上安装最新版本的Docker，请运行：

curl -fsSL https://test.docker.com -o test-docker.sh
1

sudo sh test-docker.sh
1

2.3.4 升级Docker引擎

如果你使用脚本安装了Docker，你应该直接使用你的软件包管理器升级Docker。重新运行脚本没有任何好处。如果它试图重新安装主机上已经存在的存储库，重新运行它可能会导致问题。

3 卸载Docker引擎

卸载Docker Engine、CLI、containerd和Docker Compose软件包。

sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-compose-plugin
1

主机上的Images、containers、volumes或自定义配置文件不会自动删除。要删除所有镜像、容器和卷，请执行以下操作：

sudo rm -rf /var/lib/docker
1

sudo rm -rf /var/lib/containerd
1

您必须手动删除任何已编辑的配置文件。

4 参考文献

【1】Install Docker Engine on Ubuntu