在 Ubuntu 上安装 Docker Engine

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

先决条件

防火墙限制

警告

在安装 Docker 之前，请务必考虑以下安全隐患和防火墙不兼容性。

• 如果您使用 ufw 或 firewalld 来管理防火墙设置，请注意，当您使用 Docker 公开容器端口时，这些端口会绕过您的防火墙规则。有关更多信息，请参阅Docker 和 ufw。
• Docker 仅兼容于 `iptables-nft` 和 `iptables-legacy`。在安装了 Docker 的系统上，不支持使用 `nft` 创建的防火墙规则。请确保您使用的任何防火墙规则集都是使用 `iptables` 或 `ip6tables` 创建的，并且您已将它们添加到 `DOCKER-USER` 链中，请参见数据包过滤和防火墙。

操作系统要求

要安装 Docker Engine，您需要以下其中一个 Ubuntu 版本的 64 位版本

• Ubuntu Oracular 24.10
• Ubuntu Noble 24.04 (LTS)
• Ubuntu Jammy 22.04 (LTS)
• Ubuntu Focal 20.04 (LTS)

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

卸载旧版本

在安装 Docker Engine 之前，您需要卸载任何冲突的软件包。

您的 Linux 发行版可能会提供非官方的 Docker 软件包，这些软件包可能与 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部分。

安装方法

您可以通过不同的方式安装 Docker Engine，具体取决于您的需求

• Docker Engine 与适用于 Linux 的 Docker Desktop捆绑在一起。这是入门最简单快捷的方式。

• 从Docker 的 `apt` 仓库设置和安装 Docker Engine。

• 手动安装并手动管理升级。

• 使用便捷脚本。仅推荐用于测试和开发环境。

使用 `apt` 仓库安装

在您首次在新主机上安装 Docker Engine 之前，您需要设置 Docker `apt` 仓库。之后，您可以从仓库安装和更新 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 包。

   最新版本 特定版本

   ---

   要安装最新版本，请运行

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

   要安装特定版本的 Docker Engine，首先列出存储库中可用的版本

   # List the available versions:
   $ apt-cache madison docker-ce | awk '{ print $3 }'
   
   5:27.3.1-1~ubuntu.24.04~noble
   5:27.3.0-1~ubuntu.24.04~noble
   ...
   

   选择所需的版本并安装

   $ VERSION_STRING=5:27.3.1-1~ubuntu.24.04~noble
   $ sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin
   

   ---

3. 运行hello-world镜像验证安装是否成功

   $ sudo docker run hello-world
   

   此命令下载测试镜像并在容器中运行它。容器运行时，它会打印确认消息并退出。

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

提示

尝试在非root用户下运行时收到错误？

docker用户组存在但不包含任何用户，这就是您需要使用sudo运行Docker命令的原因。请继续访问Linux安装后步骤，以允许非特权用户运行Docker命令以及其他可选配置步骤。

升级 Docker Engine

要升级 Docker Engine，请按照安装说明中的步骤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文件

   • 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

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镜像验证安装是否成功

   $ sudo service docker start
   $ sudo docker run hello-world
   

   此命令下载测试镜像并在容器中运行它。容器运行时，它会打印确认消息并退出。

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

提示

尝试在非root用户下运行时收到错误？

docker用户组存在但不包含任何用户，这就是您需要使用sudo运行Docker命令的原因。请继续访问Linux安装后步骤，以允许非特权用户运行Docker命令以及其他可选配置步骤。

升级 Docker Engine

要升级 Docker Engine，请下载较新的软件包文件并重复安装过程，指向新文件。

使用便捷脚本安装

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。docker服务在基于 Debian 的发行版上自动启动。在基于RPM的发行版（如CentOS、Fedora、RHEL或SLES）上，您需要使用相应的systemctl或service命令手动启动它。如消息所示，默认情况下，非root用户无法运行Docker命令。

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

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

安装预发行版

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

使用便捷脚本后升级 Docker

如果您使用便捷脚本安装了 Docker，则应直接使用您的包管理器升级 Docker。重新运行便捷脚本没有任何优势。如果它尝试重新安装主机上已存在的存储库，则重新运行它可能会导致问题。

卸载 Docker Engine

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
   

3. 删除源列表和密钥环

   $ sudo rm /etc/apt/sources.list.d/docker.list
   $ sudo rm /etc/apt/keyrings/docker.asc
   

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

后续步骤

• 请继续访问Linux 安装后步骤。