解决 RHEL 7.5 安装 Docker 报错：依赖包缺失与 YUM 源失效问题

原创 已于 2025-11-19 11:16:12 修改 · 1k 阅读 · 8 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
标签
#docker #容器 #运维
于 2025-11-19 11:15:13 首次发布

解决 RHEL 7.5 安装 Docker 报错：依赖包缺失与 YUM 源失效问题

解决 RHEL 7.5 安装 Docker 报错：依赖包缺失与 YUM 源失效问题

在 RHEL 7.5 系统中安装 Docker 时，常会遇到一系列棘手问题：YUM 源 404 报错、依赖包校验失败、CentOS 源与 RHEL 系统不兼容等。本文结合实际操作场景，详细拆解问题根源，提供一套完整的解决方案，帮助大家快速搞定 Docker 安装。

前置说明
当前使用操作系统版本：RHEL 7.5

[root@mysqldb01 ~]# cat /etc/os-release 
NAME="Red Hat Enterprise Linux Server"
VERSION="7.5 (Maipo)"
ID="rhel"
ID_LIKE="fedora"
VARIANT="Server"
VARIANT_ID="server"
VERSION_ID="7.5"
PRETTY_NAME="Red Hat Enterprise Linux Server 7.5 (Maipo)"
ANSI_COLOR="0;31"
CPE_NAME="cpe:/o:redhat:enterprise_linux:7.5:GA:server"
HOME_URL="https://www.redhat.com/"
BUG_REPORT_URL="https://bugzilla.redhat.com/"

REDHAT_BUGZILLA_PRODUCT="Red Hat Enterprise Linux 7"
REDHAT_BUGZILLA_PRODUCT_VERSION=7.5
REDHAT_SUPPORT_PRODUCT="Red Hat Enterprise Linux"
REDHAT_SUPPORT_PRODUCT_VERSION="7.5"
[root@mysqldb01 ~]#

一、问题背景与核心报错

1. 操作初衷

在 RHEL 7.5 服务器上通过 YUM 安装 Docker CE，执行常规安装步骤：
安装完整步骤参考《入门篇：零基础 | 一入 Docker 深似海》

# 下载阿里云 Docker 源
wget http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
# 修改系统版本适配
sed -i 's/$releasever/7/g' docker-ce.repo
# 安装 Docker 核心组件
yum -y install docker-ce docker-ce-cli containerd.io

2. 关键报错

  • 第一阶段：docker-compose-plugin 包校验失败（Package does not match intended download），镜像源元数据不一致。
  • 第二阶段：清理缓存后出现 YUM 源 404，提示 CentOS-7 - Base - 163.com 仓库无法访问。
  • 第三阶段：排查发现系统为 RHEL 7.5（非 CentOS 7），默认订阅源未注册，第三方 CentOS 源适配失败。

二、问题根源分析

  1. RHEL 系统订阅限制：RHEL 需注册红帽订阅才能使用官方源，未注册时无法获取依赖包，导致 YUM 功能异常。
  2. CentOS 7 EOL 影响：CentOS 7 已停止官方支持（EOL），多数公共镜像源（如 163 源）已下架相关仓库，直接使用旧源会触发 404。
  3. 系统兼容性问题：RHEL 与 CentOS 虽同源兼容，但默认缺少 CentOS/GPG 密钥，且源配置中的版本变量（$releasever）需手动适配。
  4. Docker 依赖链缺失：Docker 安装需 fuse-overlayfs、container-selinux 等依赖包，这些包需从 EPEL 源获取，默认 RHEL 源未包含。

三、完整解决方案

核心思路

替换 RHEL 默认订阅源为 CentOS 7 归档源（兼容 RHEL 7.5），补充 EPEL 源提供额外依赖，重新配置 Docker 源并适配系统版本，最终完成安装。

步骤 1：备份原有 YUM 源配置

避免误删配置文件，先备份当前所有 repo 文件：

# 创建备份目录
mkdir -p /etc/yum.repos.d/backup
# 移动原有 repo 文件到备份目录
mv /etc/yum.repos.d/*.repo /etc/yum.repos.d/backup/

步骤 2：配置 CentOS 7 归档源（兼容 RHEL 7.5）

选择阿里云归档源（速度快、稳定性高），适配 RHEL 7.5 系统：

# 下载 CentOS 7 Base 源
wget -O /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo
# 下载 EPEL 7 源（提供额外依赖）
wget -O /etc/yum.repos.d/epel.repo https://mirrors.aliyun.com/repo/epel-7.repo

# 替换版本变量为 7（适配 RHEL 7 系列）
sed -i 's/$releasever/7/g' /etc/yum.repos.d/CentOS-Base.repo
sed -i 's/$releasever/7/g' /etc/yum.repos.d/epel.repo

# 禁用 GPG 校验（RHEL 无 CentOS 密钥，避免校验失败）
sed -i 's/gpgcheck=1/gpgcheck=0/g' /etc/yum.repos.d/CentOS-Base.repo
sed -i 's/gpgcheck=1/gpgcheck=0/g' /etc/yum.repos.d/epel.repo

步骤 3：重新配置 Docker 源

下载适配 CentOS 7 的 Docker 源，修改版本变量以兼容 RHEL 7.5：

# 下载阿里云 Docker CE 源
wget -O /etc/yum.repos.d/docker-ce.repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

# 替换版本变量为 7（适配 RHEL 7）
sed -i 's/$releasever/7/g' /etc/yum.repos.d/docker-ce.repo
# 禁用 GPG 校验（避免密钥不匹配问题）
sed -i 's/gpgcheck=1/gpgcheck=0/g' /etc/yum.repos.d/docker-ce.repo

步骤 4：清理缓存并重建元数据

# 清理所有旧缓存
yum clean all
# 重建 YUM 缓存（拉取新源元数据）
yum makecache

步骤 5：安装 Docker 核心组件

此时 YUM 源已完全适配，执行安装命令：

# 安装 Docker 核心组件
yum -y install docker-ce docker-ce-cli containerd.io

# （可选）安装缺失依赖（若上述命令报错）
yum -y install fuse-overlayfs slirp4netns container-selinux libfuse3.so.3

重塑上述步骤至此未遇到报错，安装成功。
在这里插入图片描述

步骤 6：启动 Docker 并验证

# 启动 Docker 服务
systemctl start docker
# 设置开机自启
systemctl enable docker
# 查看 Docker 状态（显示 active (running) 即为成功）
systemctl status docker
# 验证 Docker 版本
docker --version

在这里插入图片描述

四、常见问题补充

1. 仍提示 docker-compose-plugin 包报错？

跳过该插件安装，后续通过官方脚本手动补充：

# 只安装 Docker 核心组件
yum -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-ce-rootless-extras

# 手动安装 docker-compose-plugin
curl -SL https://github.com/docker/compose/releases/download/v2.27.1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
# 验证
docker compose version

2. YUM 源仍无法访问？

替换为 CentOS 官方归档源（vault.centos.org），修改 CentOS-Base.repo：

# 将阿里云镜像地址替换为官方归档源
sed -i 's/mirrors.aliyun.com/vault.centos.org/g' /etc/yum.repos.d/CentOS-Base.repo
# 重建缓存
yum makecache

3. 安装后 Docker 启动失败？

检查 SELinux 状态，若未关闭可能导致权限问题：

# 临时关闭 SELinux（测试用）
setenforce 0
# 永久关闭 SELinux（编辑配置文件）
sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config
# 重启服务器后生效
reboot

五、总结与注意事项

  1. 系统兼容性：RHEL 7.x 与 CentOS 7 归档源完全兼容，无需修改内核，可放心使用。
  2. 安全提醒：RHEL 7.5 和 CentOS 7 均已停止官方更新，存在安全风险，建议长期使用时迁移到 RHEL 8/9 或 CentOS Stream 系列。
  3. 源选择建议：优先使用阿里云、华为云等国内归档源，速度优于官方海外源。
  4. 依赖包处理：Docker 安装的核心依赖需从 EPEL 源获取，务必确保 EPEL 源配置正确。

若有转载，请标明出处：https://blog.csdn.net/CharlesYuangc/article/details/155017355

docker-compose-plugin-2.27.1-1.el7.x86-64 包下载地址
09-18
docker-compose-plugin-2.27.1-1.el7.x86_64 包下载地址
docker-compose-windows-x86-64-v2.27.1.exe
05-25
Docker Compose 是一个用于定义和运行多容器Docker应用程序的命令行工具
Error downloading packages: docker-compose-plugin-2.27.1-1.el7.x86_64: [Errno 256] No more mirrors
m0_53677355的博客
08-25 9366
摘要：Docker部署失败通常因镜像源问题导致。解决方案包括：1) 清理yum缓存（sudo yum clean all）；2) 清理Docker官方源元数据（sudo yum --enablerepo=docker-ce-stable clean metadata）；3) 重新安装依赖；4) 配置清华镜像源（修改/etc/yum.repos.d/docker-ce.repo）；5) 生成缓存加速安装（sudo yum makecache fast）；6) 安装Docker引擎（sudo yum insta
linux安装docker-compose
StreamlineWq的博客
06-04 1024
注意：在某些情况下，你可能需要将Docker Compose的路径添加到你的系统环境变量中。但通常，如果你按照上述步骤将Docker Compose安装在/usr/local/bin/目录下，那么它应该已经可以在你的系统任何位置被访问了。(uname -m)是用来动态获取你的操作系统名称和机器架构的。百度出来一大堆垃圾，没一个是对的，最后还是ai好。3.成功并且查看版本。
宝塔面板软件商店报错排查指南：从C++库缺失到PHP安装失败的完整修复
mars5的博客
03-01 591
本文提供了宝塔面板软件商店中PHP安装失败的完整排查与修复指南。针对CentOS等系统常见的C++库缺失、依赖错误及系统兼容性问题，文章详细分析了错误原因，并给出了从软件源修复、依赖安装到手动编译的系统性解决方案，帮助用户彻底解决PHP安装难题。
Linux发行版选择指南：Ubuntu、Debian、RHEL与国产系统的底层差异
weixin_30727835的博客
06-19 292
Linux发行版并非简单操作系统的不同版本，而是融合内核策略、包管理哲学与更新模型的完整技术契约。理解APT与DNF背后的信任机制、cgroup v1/v2对Docker兼容性的影响、Debian stable的冻结策略与RHEL的backport原则，是规避部署故障的前提。尤其在AI训练（WSL2+GPU）、信创适配（国产发行版路径漂移）、生产运维（rpm/yum事务回滚）等场景中，发行版基因直接决定系统稳定性、安全响应速度与长期维护成本。本文聚焦ubuntu、debian、rhel及linux国产四大技
CentOS 8安装MariaDB避坑指南：等保/RAGFlow适配实战
最新发布
dianxiangong2403的博客
06-20 337
MariaDB作为主流开源关系型数据库，其在Linux系统中的部署并非简单执行安装命令即可完成。尤其在已停止维护的CentOS 8环境下，包管理策略变更、SELinux策略缺失、内核兼容性问题及默认配置缺陷共同构成多重隐性门槛。本文围绕MariaDB核心原理展开，解析服务单元注册机制、配置文件加载路径依赖、InnoDB缓冲池与连接池协同机制等关键技术点，强调环境预检、安全加固与场景化调优的技术价值。面向RAGFlow元数据存储、等保三级测评、虚拟机轻量部署等典型工程场景，提供可验证的实操路径与故障诊断链路，
容器指南大纲
CharlesYuangc的博客
11-21 344
序号概述文章链接1Docker 基础篇入门篇：零基础 | 一入 Docker 深似海2容器存储配置Docker 镜像存储路径详解：查看与修改全指南3容器镜像制作（commit）Docker 镜像构建：手把手教你用 docker commit 定制专属镜像4容器镜像制作（Dockerfile）从零了解 Dockerfile：构建属于你的 Docker 镜像5容器基础维护Docker 容器的基本概念与操作指南6镜像&容器区别Docker 镜像与容器的区别与联系7容器体系结构机制。
CentOS 8 下 Nginx 编译安装与生产级配置实战
weixin_34378969的博客
06-19 362
Nginx 是高性能 Web 服务器与反向代理的工业标准，其核心原理基于事件驱动模型与异步非阻塞 I/O，在 Linux 系统中深度依赖内核机制（如 epoll）、权限体系（如 SELinux）和包管理生态。在 CentOS 8 这一已结束生命周期（EOL）但仍在大量服役的操作系统上，直接使用 dnf 安装将导致版本冻结、安全漏洞无法修复、模块冗余及兼容性风险，技术价值在于通过源码编译实现版本可控、攻击面收敛与路径可定制。典型应用场景包括金融离线环境部署、政务云信创适配、IPv6 双栈服务及 PCI DSS
docker-compose-linux-x86-64v2.27.7z
05-05
Docker Compose 是一个用于定义和运行多容器Docker应用程序的命令行工具
docker和docker-compose安装包.rar
04-12
docker离线安装所需的所有依赖包和docker本身的包，还有docker-compose工具的安装包，使用方法直接去这篇博客：https://cuichongxin.blog.csdn.net/article/details/118033211
redhat7.2 离线安装docker-ce依赖包
05-08
redhat7.2 离线安装docker所需的依赖包，亲测可用。 下载后指定此文件夹为yum源，然后 yum install docker-ce即可
docker报错：Error downloading packages
weixin_69737423的博客
01-16 3115
docker下载报错处理
centos 7.x最新手动部署Docker（解决Error downloading packages报错）
weixin_39825996的博客
08-30 590
执行以下命令来卸载旧版本的Docker和相关的软件包并删除Docker相关源，这个命令会帮你卸载掉所有列出的与Docker相关的程序。#安装Docker社区版本，容器运行时containerd.io，以及Docker构建和Compose插件。#如果参考的本文安装Docker，那么Compose插件将默认安装到您的实例中，您可以通过如下命令查看。，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。#通过查看Docker版本命令，验证Docker是否安装成功。#删除Docker相关源。
docker-compose2.27.3版本安装
weixin_46177735的博客
10-22 895
1，首先，你需要下载 docker-compose 的二进制文件。你可以从 Docker 的 GitHub 仓库或官方网站下载。
CentOS8 Docker安装
hcd1129的博客
01-20 285
1 环境： CentOS Linux release 8.2.2004 (Core) 2 安装步骤 #卸载 CentOS 8.1 自带的podman rpm -qa | grep -i podman
docker安装失败
qq_44696583的博客
08-29 3026
docker安装失败： 在centos7中安装docker会出现安装失败问题 问题描述： 安装docker，出现输入的界面都按 y,也就是执行 yum install -y docker-ce 报出没有更多的镜像去重试 <!--具体错误界面--> Error downloading packages: containerd.io-1.4.9-3.1.el7.x86_64: [Errno 256] No more mirrors to try. 原因分析： 直接使用yum下载安装,存
Redhat7.5离线安装docker
zzz3112362088的博客
12-09 2864
1.下载docker离线安装 对应版本可以在https://download.docker.com/linux/static/stable/x86_64/这个路径下载选择 这里我选择以下这个版本 https://download.docker.com/linux/static/stable/x86_64/docker-18.06.3-ce.tgz 2.上传至服务器进行安装 1）安装支...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

君九@DBA

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值