在 Ubuntu 上安装 Docker Engine

系列文章目录

---

前言

要在 Ubuntu 上开始使用 Docker Engine，请确保满足先决条件，然后按照安装步骤进行操作。

---

一、先决条件

注意事项

如果您使用 ufw 或 firewalld 管理防火墙设置，请注意当您使用 Docker 暴露容器端口时，这些端口会绕过您的防火墙规则。有关详细信息，请参阅 Docker 和 ufw。

1.1 操作系统要求

要安装 Docker Engine，你需要这些 Ubuntu 版本中的一个 64 位版本：

• Ubuntu Mantic 23.10
• Ubuntu Lunar 23.04
• Ubuntu Jammy 22.04 (LTS)
• Ubuntu Focal 20.04 (LTS)

适用于 Ubuntu 的 Docker Engine 兼容 x86_64（或 amd64）、armhf、arm64、s390x 和 ppc64le (ppc64el) 体系结构。

1.2 卸载旧版本

在安装 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 引擎部分。

二、安装方法

你可以根据自己的需要，用不同的方法安装 Docker Engine：

• Docker Engine 捆绑了 Linux 版 Docker Desktop。这是最简单快捷的入门方法。
• 从 Docker 的 apt 代码库中设置并安装 Docker Engine。
• 手动安装并管理升级。
• 使用便捷脚本。仅推荐用于测试和开发环境。

2.1 使用 apt 代码库安装

在新主机上首次安装 Docker Engine 之前，需要先设置 Docker 资源库。之后，你就可以从版本库中安装和更新 Docker 了。

1. 设置 Docker 的 apt 仓库。

   # Add Docker's official GPG key:
   sudo apt-get update
   sudo apt-get install ca-certificates curl
   sudo install -m 0755 -d /etc/apt/keyrings
   sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
   sudo chmod a+r /etc/apt/keyrings/docker.asc
   
   # Add the repository to Apt sources:
   echo \
     "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
     $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
     sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
   sudo apt-get update

   注意事项

   如果你使用的是 Ubuntu 的衍生发行版，比如 Linux Mint，你可能需要使用 UBUNTU_CODENAME 而不是 VERSION_CODENAME。

2. 安装 Docker 软件包。

   1. 要安装最新版本，请运行

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

   2. 要安装特定版本的 Docker Engine，首先要列出版本库中的可用版本：

      # List the available versions:
      apt-cache madison docker-ce | awk '{ print $3 }'
      
      5:24.0.0-1~ubuntu.22.04~jammy
      5:23.0.6-1~ubuntu.22.04~jammy
      ...

      选择所需版本并安装：

      VERSION_STRING=5:24.0.0-1~ubuntu.22.04~jammy
      sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin

   3. 运行 hello-world 映像，验证 Docker Engine 安装是否成功。

      sudo docker run hello-world

      此命令将下载测试映像并在容器中运行。容器运行后，它会打印一条确认消息并退出。

现在您已成功安装并启动了 Docker Engine。

提示

尝试在没有 root 的情况下运行时出现错误？

docker 用户组存在，但不包含任何用户，这就是为什么你需要使用 sudo 来运行 Docker 命令。继续阅读 Linux postinstall，允许非特权用户运行 Docker 命令，并了解其他可选的配置步骤。

2.1.1 升级 Docker 引擎

要升级 Docker Engine，请按照安装说明的第 2 步操作，选择要安装的新版本。

2.2 从软件包安装

如果你无法使用 Docker 的 apt 仓库来安装 Docker Engine，你可以为你的版本下载 deb 文件并手动安装。每次升级 Docker Engine 时，你都需要下载一个新文件。

1. 访问 https://download.docker.com/linux/ubuntu/dists/。

2. 在列表中选择你的 Ubuntu 版本。

3. 转到 pool/stable/，选择适用的架构（amd64、armhf、arm64 或 s390x）。

4. 为 Docker Engine、CLI、containerd 和 Docker Compose 软件包下载以下 deb 文件：

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

5. 安装 .deb 包。将下面示例中的路径更新为下载 Docker 软件包的位置。

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

   Docker 守护进程会自动启动。

6. 运行 hello-world 映像，验证 Docker Engine 安装是否成功。

   sudo service docker start
   sudo docker run hello-world

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

现在你已经成功安装并启动了 Docker Engine。

提示

尝试在没有 root 的情况下运行时遇到错误？

docker 用户组存在，但不包含任何用户，这就是为什么你需要使用 sudo 来运行 Docker 命令。继续阅读 Linux postinstall，允许非特权用户运行 Docker 命令，并了解其他可选的配置步骤。

2.2.1 升级 Docker 引擎

要升级 Docker Engine，请下载更新的软件包文件，然后重复安装步骤，并指向新文件。

2.3 使用便捷脚本安装

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

在本地运行从互联网下载的脚本之前，请务必对其进行检查。在安装之前，请先熟悉方便脚本的潜在风险和限制：

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

提示：运行前预览脚本步骤

你可以使用 --dry-run 选项运行脚本，了解脚本在调用时会运行哪些步骤：

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh --dry-run

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

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Executing docker install script, commit: 7cae5f8b0decc17d6571f9f52eb840fbc13b2737
<...>

现在你已经成功安装并启动了 Docker Engine。在基于 Debian 的发行版中，docker 服务会自动启动。在基于 RPM 的发行版上，如 CentOS、Fedora、RHEL 或 SLES，你需要使用相应的 systemctl 或 service 命令手动启动它。如消息所示，非 root 用户默认情况下无法运行 Docker 命令。

以非特权用户身份使用 Docker，还是以无 root 模式安装？

安装脚本需要 root 或 sudo 权限才能安装和使用 Docker。如果要授予非 root 用户访问 Docker 的权限，请参阅 Linux 的安装后步骤。你也可以在没有 root 权限的情况下安装 Docker，或将其配置为在无根模式下运行。有关在无根模式下运行 Docker 的说明，请参阅以非 root 用户身份运行 Docker 守护进程（无根模式）。

2.3.1 安装预发布版本

Docker 还在 https://test.docker.com/ 提供了一个方便的脚本，用于在 Linux 上安装 Docker 的预发布版本。该脚本与 get.docker.com 上的脚本相同，只是将软件包管理器配置为使用 Docker 软件包仓库的测试通道。测试通道包括 Docker 的稳定版和预发布版（测试版、候选发布版）。使用此脚本可提前访问新版本，并在稳定版发布前在测试环境中对其进行评估。

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

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

2.3.2 使用便利脚本后升级 Docker

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

2.3.3 卸载 Docker 引擎

1. 卸载 Docker Engine、CLI、containerd 和 Docker Compose 软件包：

   sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras

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

   sudo rm -rf /var/lib/docker
   sudo rm -rf /var/lib/containerd

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