在Fedora上安装Docker引擎

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

先决条件

操作系统要求

要安装Docker引擎，您需要以下Fedora版本之一的维护版本：

• Fedora 40
• Fedora 41

卸载旧版本

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

您的Linux发行版可能提供了非官方的Docker软件包，这些软件包可能与Docker提供的官方软件包发生冲突。在安装Docker Engine的官方版本之前，您必须卸载这些软件包。

$ sudo dnf remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-selinux \
                  docker-engine-selinux \
                  docker-engine

dnf 可能会报告您没有安装这些软件包。

存储在/var/lib/docker/中的镜像、容器、卷和网络在卸载Docker时不会自动删除。

安装方法

您可以根据需要以不同的方式安装Docker Engine：

• 您可以 设置Docker的存储库 并从它们安装， 以便于安装和升级任务。这是 推荐的方法。

• 您可以下载RPM包， 手动安装，并完全手动管理 升级。这在无法访问互联网的隔离系统上安装 Docker时非常有用。

• 在测试和开发环境中，您可以使用自动化的 便捷脚本 来安装 Docker。

使用rpm仓库安装

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

设置仓库

安装dnf-plugins-core包（它提供了管理您的DNF仓库的命令）并设置仓库。

$ sudo dnf -y install dnf-plugins-core
$ sudo dnf-3 config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo

安装 Docker 引擎

1. 安装Docker包。

   Latest Specific version

   ---

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

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

   如果提示接受GPG密钥，请验证指纹是否匹配 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35，如果匹配，请接受它。

   此命令安装Docker，但不会启动Docker。它还会创建一个docker组，但默认情况下不会将任何用户添加到该组。

   要安装特定版本，首先列出仓库中可用的版本：

   $ dnf list docker-ce --showduplicates | sort -r
   
   docker-ce.x86_64    3:27.4.0-1.fc41    docker-ce-stable
   docker-ce.x86_64    3:27.3.1-1.fc41    docker-ce-stable
   <...>
   

   返回的列表取决于启用的存储库，并且特定于您的Fedora版本（在本例中由.fc40后缀表示）。

   通过其完全限定的包名称安装特定版本，该名称是包名称（docker-ce）加上版本字符串（第二列），用连字符（-）分隔。例如，docker-ce-3:27.4.0-1.fc41。

   将替换为所需的版本，然后运行以下命令进行安装：

   $ sudo dnf install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin
   

   此命令安装Docker，但不会启动Docker。它还会创建一个docker组，但默认情况下不会将任何用户添加到该组。

   ---

2. 启动 Docker 引擎。

   $ sudo systemctl enable --now docker
   

   这将配置Docker的systemd服务在系统启动时自动启动。如果您不希望Docker自动启动，请使用sudo systemctl start docker代替。

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

   $ sudo docker run hello-world
   

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

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

提示

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

docker 用户组存在但不包含任何用户，这就是为什么你需要使用 sudo 来运行 Docker 命令。继续到 Linux 安装后步骤 以允许非特权用户运行 Docker 命令以及其他可选配置步骤。

升级 Docker 引擎

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

从包安装

如果您无法使用Docker的rpm仓库来安装Docker引擎，您可以下载适用于您版本的.rpm文件并手动安装。每次升级Docker引擎时，您都需要下载一个新文件。

1. 前往 https://download.docker.com/linux/fedora/ 并选择您的Fedora版本。然后浏览到x86_64/stable/Packages/ 并下载您想要安装的Docker版本的.rpm文件。

2. 安装Docker引擎，将以下路径更改为您下载Docker包的路径。

   $ sudo dnf install /path/to/package.rpm
   

   Docker 已安装但未启动。docker 组已创建，但未将任何用户添加到该组。

3. 启动Docker引擎。

   $ sudo systemctl enable --now docker
   

   这将配置Docker的systemd服务在系统启动时自动启动。如果您不希望Docker自动启动，请使用sudo systemctl start docker代替。

4. 通过运行hello-world镜像来验证安装是否成功：

   $ sudo docker run hello-world
   

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

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

提示

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

docker 用户组存在但不包含任何用户，这就是为什么你需要使用 sudo 来运行 Docker 命令。继续到 Linux 安装后步骤 以允许非特权用户运行 Docker 命令以及其他可选配置步骤。

升级 Docker 引擎

要升级Docker Engine，请下载较新的包文件并重复 安装过程，使用dnf upgrade 而不是dnf install，并指向新文件。

使用便捷脚本安装

Docker 提供了一个便捷脚本在 https://get.docker.com/ 以非交互方式将 Docker 安装到 开发环境中。虽然这个便捷脚本不推荐用于生产环境，但它对于创建符合您需求的配置脚本非常有用。同时，请参考 使用仓库安装 步骤来了解使用包仓库进行安装的步骤。该脚本的源代码是开源的，您可以在 docker-install 仓库在 GitHub 上找到。

在本地运行之前，始终检查从互联网下载的脚本。 在安装之前，请熟悉便利脚本的潜在风险和限制：

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

使用Docker作为非特权用户，还是以无根模式安装？

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

安装预发布版本

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 引擎

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

   $ sudo dnf remove 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
   

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

下一步

• 继续 Linux 安装后步骤.