当前位置：首页 > news >正文

解决 CentOS 8 报错：Failed to download metadata for repo ‘BaseOS‘

news 2025/11/3 8:19:01

❌ 一、问题现象：完整的错误输出

当你尝试使用网络上常见的“一键安装 Docker”命令时，例如：

bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

你可能会看到如下报错信息：

CentOS-8 - Base - mirrors.jdcloudcs.com                                                               3.9 kB/s | 153  B     00:00    
Errors during downloading metadata for repository 'BaseOS':- Status code: 404 for http://mirrors.jdcloudcs.com/centos/8/BaseOS/x86_64/os/repodata/repomd.xml (IP: 11.175.20.64)
错误：Failed to download metadata for repo 'BaseOS': Cannot download repomd.xml: Cannot download repodata/repomd.xml: All mirrors were tried✘ 生成软件源缓存出错，请先解决系统原有软件源错误以确保 yum 软件包管理工具可用！

紧接着，脚本会中断并提示：

✘ 执行失败，请检查错误信息。

🧩 二、错误来源解析：这不是 Docker 的问题，而是系统基础环境的问题！

1. 脚本做了什么？

我们来看这个命令的本质：

bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

curl -sSL：静默下载脚本内容
<( ... )：进程替换，将远程脚本当作本地文件传给 bash
bash：执行该脚本

这个脚本来自开源项目 LinuxMirrors，功能是：

自动检测系统类型
配置国内镜像源
安装 Docker Engine
可选配置 Docker 镜像加速器

但它在安装 Docker 之前，必须先确保系统的 yum（或 dnf）可以正常工作。

2. 脚本内部发生了什么？

该脚本在执行过程中会调用以下关键步骤：

# 1. 同步软件源（等价于 yum makecache）
yum makecache# 2. 安装依赖包（如 yum-utils、device-mapper-persistent-data、lvm2）
yum install -y yum-utils

正是在这一步，脚本尝试更新软件源缓存时，触发了底层 yum 的元数据下载失败。

⚠️ 所以：
你看到的错误不是 Docker 安装失败，而是系统软件源本身已不可用！

🧠 三、根本原因：CentOS 8 已于 2021 年停止维护（EOL）

这是整个问题的根源。

🔴 CentOS Linux 8 的生命周期已于 2021 年 12 月 31 日正式结束（End of Life, EOL）

这意味着：

官方不再提供任何更新（包括安全补丁、Bug 修复）
所有主流镜像站（如 mirrors.jdcloudcs.com、mirrors.aliyun.com 的默认路径）已将 CentOS 8 的默认仓库下线
原来的 baseurl=http://mirror.example.com/centos/8/... 地址返回 404 Not Found

因此，当你执行一键脚本时，它试图运行 yum makecache 来准备安装环境，结果失败。

🔍 四、错误关键词深度解读

错误信息	含义
`Status code: 404`	请求的资源不存在，服务器返回“未找到”
`repomd.xml`	YUM 软件源的核心元数据文件，描述了整个仓库结构
`Cannot download repomd.xml`	无法获取仓库定义，yum 无法继续工作
`All mirrors were tried`	所有配置的镜像地址都尝试失败，说明源已失效
`✘ 生成软件源缓存出错`	来自 `docker.sh` 脚本的自定义提示，表明 `yum makecache` 失败

💡 简单来说：你的系统想找“软件清单”，但原来的“图书馆”已经关门了。而一键安装脚本就是那个“借书的人”，它发现图书馆关门后就直接告诉你：“借不了书”。

✅ 五、解决方案

要解决此问题，必须将软件源从已失效的官方路径切换到 CentOS Vault 存档镜像，即历史版本归档库。

✅ CentOS Vault 是 CentOS 官方为 EOL 版本提供的永久归档站点，地址为：https://vault.centos.org

我们可以通过国内高速镜像（如阿里云、清华）来加速访问。

🛠️ 六、详细解决步骤

步骤 1：确认当前系统版本

cat /etc/centos-release

输出示例：

CentOS Linux release 8.5.2111

记下版本号（这里是 8.5.2111），后续配置将基于此版本。

步骤 2：进入 yum 源目录并备份原始配置

cd /etc/yum.repos.d

列出当前 repo 文件：

ls *.repo

你会发现文件名可能是：

CentOS-8.repo ← CentOS 8 默认主文件
CentOS-Base.repo
CentOS-Linux-*.repo

备份原文件（防止出错可恢复）：

sudo mv CentOS-8.repo CentOS-8.repo.bak

如果提示 mv: cannot stat，说明文件不存在或名称不同，请使用正确的文件名。

步骤 3：下载阿里云提供的 CentOS Vault 镜像源

阿里云维护了完整的 CentOS 存档镜像，我们可以从中获取适用于 CentOS 8 的 repo 文件。

执行命令下载：

sudo curl -o CentOS-8.repo https://mirrors.aliyun.com/repo/Centos-vault-8.5.2111.repo

📌 注意事项：

8.5.2111 应与你系统的实际版本一致。
若你是 8.4.2105，请替换为 Centos-vault-8.4.2105.repo
下载地址格式统一为：https://mirrors.aliyun.com/repo/Centos-vault-<version>.repo

🔗 阿里云 repo 列表：https://mirrors.aliyun.com/repo/

步骤 4：检查并修正 repo 文件中的 baseurl（重要！）

虽然下载了正确的 repo 文件，但其中可能仍包含动态变量 $releasever，而在 EOL 后这些变量可能指向无效路径。

编辑文件：

sudo vi CentOS-8.repo

查找所有类似以下行：

baseurl=http://mirrors.aliyun.com/centos/$releasever/BaseOS/$basearch/os/

将其替换为固定路径，例如：

baseurl=https://mirrors.aliyun.com/centos-vault/8.5.2111/BaseOS/x86_64/os/

🔧 在 vi 中批量替换（推荐）：

:%s|http://mirrors.aliyun.com/centos/$releasever|https://mirrors.aliyun.com/centos-vault/8.5.2111|g
:%s|http://|https://|g

保存退出：:wq

✅ 替换完成后，所有 URL 都应以 https://mirrors.aliyun.com/centos-vault/8.5.2111/... 开头。

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

sudo yum clean all
sudo yum makecache

如果一切正常，你会看到：

Metadata cache created.

🎉 恭喜！yum 已恢复正常。

步骤 6：重新执行一键安装 Docker 脚本

现在再运行原来的命令：

bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

你会发现脚本可以顺利执行，不再报错，并开始安装 Docker。

📚 七、相关知识点科普

1. 什么是 `repomd.xml`？

是 YUM/DNF 软件源的“目录索引”文件
包含软件包列表、依赖关系、校验和等元数据
必须先下载此文件才能进行安装操作
路径一般为：repodata/repomd.xml

2. 什么是 EOL（End of Life）？

表示操作系统版本停止维护
不再接收安全更新、功能补丁
继续使用会面临漏洞暴露风险
Red Hat 官方建议迁移到替代方案

3. 为什么一键脚本不自动处理这个问题？

因为：

脚本无法判断你是“首次配置”还是“源已损坏”
修改系统源属于高风险操作，需用户确认
不同系统版本、网络环境差异大，自动化修复易出错

所以这类脚本通常会先检查基础环境是否可用，不可用则直接退出并提示错误。

⚠️ 八、重要提醒：不要长期依赖 CentOS 8

虽然我们通过修改软件源“复活”了 CentOS 8，但：

🔴 这只是一个临时解决方案！

因为：

即使能安装旧包，也无法获得新的安全更新
新漏洞不会被修复，系统越来越危险
第三方软件（如 Docker、containerd）可能逐步停止支持

🔄 九、推荐迁移方案

建议尽快将系统迁移到以下长期支持的替代品：

✅ 推荐 1：AlmaLinux

由 CloudLinux 团队发起，完全二进制兼容 RHEL。

官网：https://almalinux.org

一键迁移脚本：

curl -O https://raw.githubusercontent.com/AlmaLinux/almalinux-deploy/master/almalinux-deploy.sh
sudo bash almalinux-deploy.sh

✅ 推荐 2：Rocky Linux

由原 CentOS 创始人 Gregory Kurtzer 创建，目标是“真正的 CentOS 继承者”。

官网：https://rockylinux.org

提供迁移工具 migrate2rocky：

curl -O https://raw.githubusercontent.com/rocky-linux/rocky-tools/main/migrate2rocky/migrate2rocky.sh
sudo bash migrate2rocky.sh -r

🧰 十、附录：完整可用的 CentOS-8.repo 示例

以下是适用于 CentOS 8.5.2111 的最小化 CentOS-8.repo 配置（阿里云镜像）：

[BaseOS]
name=CentOS-8 - Base
baseurl=https://mirrors.aliyun.com/centos-vault/8.5.2111/BaseOS/x86_64/os/
gpgcheck=1
enabled=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-centosofficial[AppStream]
name=CentOS-8 - AppStream
baseurl=https://mirrors.aliyun.com/centos-vault/8.5.2111/AppStream/x86_64/os/
gpgcheck=1
enabled=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-centosofficial[PowerTools]
name=CentOS-8 - PowerTools
baseurl=https://mirrors.aliyun.com/centos-vault/8.5.2111/PowerTools/x86_64/os/
gpgcheck=1
enabled=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-centosofficial

✅ 将此内容保存为 /etc/yum.repos.d/CentOS-8.repo 即可直接使用。

📝 十一、总结

场景	解决方法
执行 `bash <(curl -sSL https://linuxmirrors.cn/docker.sh)` 报错	先修复系统软件源
`Failed to download metadata for repo 'BaseOS'`	切换到 CentOS Vault 存档源
`repomd.xml 404`	使用阿里云、清华等镜像的 vault 路径
`yum makecache 失败`	清理缓存 + 替换 baseurl 为固定版本
长期使用风险	迁移到 AlmaLinux 或 Rocky Linux