Docker Engine在Fedora系统上的安装与配置指南

Docker Engine在Fedora系统上的安装与配置指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

Docker Engine是Docker的核心组件，它允许用户在隔离的容器中运行应用程序。本文将详细介绍在Fedora系统上安装Docker Engine的完整流程，包括系统要求、安装方法选择、常见问题解决以及卸载步骤。

系统要求

操作系统版本

Docker Engine支持以下Fedora版本：

• Fedora 42
• Fedora 41

建议使用最新的稳定版Fedora以获得最佳兼容性和安全性支持。

卸载旧版本

在安装新版本前，必须移除可能与官方Docker包冲突的旧版本或非官方版本：

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

注意：此操作不会删除存储在/var/lib/docker/中的镜像、容器、卷和网络数据。

安装方法

Fedora系统上安装Docker Engine主要有三种方式：

1. 使用RPM仓库安装（推荐）

这是最推荐的安装方式，便于后续管理和升级。

设置仓库

1. 安装必要的工具包：

sudo dnf -y install dnf-plugins-core

2. 添加Docker官方仓库：

sudo dnf-3 config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo

安装Docker Engine

有两种安装选择：

安装最新版本：

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后接受即可。

安装特定版本：

1. 首先查看可用版本：

dnf list docker-ce --showduplicates | sort -r

2. 选择并安装特定版本：

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

启动Docker服务

sudo systemctl enable --now docker

此命令会设置Docker在系统启动时自动运行。如果不需要自动启动，可使用：

sudo systemctl start docker

验证安装

运行测试容器：

sudo docker run hello-world

成功运行后会显示确认信息并退出。

2. 手动安装RPM包

适用于无法访问互联网或需要离线安装的场景。

1. 下载所需的RPM包
2. 手动安装：

sudo dnf install /path/to/package.rpm

3. 启动服务（同上）

3. 使用便捷脚本（仅限测试环境）

不建议在生产环境使用此方法，因为脚本会直接安装最新版本且无法自定义配置。

升级Docker Engine

对于仓库安装方式，只需重复安装步骤选择新版本即可。对于手动安装方式，需要下载新版本的RPM包并使用dnf upgrade命令升级。

卸载Docker Engine

1. 移除Docker相关包：

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

常见问题

非root用户权限

默认情况下，只有root用户和docker组用户才能运行Docker命令。要将用户添加到docker组：

sudo usermod -aG docker $USER

然后注销并重新登录使更改生效。

SELinux问题

Fedora默认启用SELinux，如果遇到权限问题，可以尝试：

sudo setenforce 0

但这会降低安全性。更好的解决方案是正确配置SELinux策略。

后续步骤

安装完成后，建议配置以下内容：

• 设置Docker开机自启
• 配置镜像源优化（特别是国内用户）
• 学习基本的Docker命令和概念

通过本文的详细指导，您应该能够在Fedora系统上顺利完成Docker Engine的安装和基本配置。Docker为应用部署提供了轻量级的容器解决方案，是现代化开发和运维的重要工具。

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs