centos 7 yum源已失效，需替换为阿里云centos-vault归档源：先备份原配置，再下载https://mirrors.aliyun.com/repo/centos-7.repo，最后执行yum clean all && yum makecache。
yum 命令报错「Could not resolve host: mirrorlist.centos.org」或「Cannot prepare internal mirrorlist」，说明 CentOS 7 官方源已彻底不可用——这不是网络问题，是供应链断供。阿里云镜像站目前仍稳定提供 centos-vault 归档源，可直接替换，无需重装系统。
确认 yum 源是否真的失效
别急着改配置，先跑一条命令验证问题根源：
yum check-update
如果返回类似以下任意一种错误，就是源失效的明确信号：
Cannot find a valid baseurl for repo: base/7/x86_64Could not resolve host: mirrorlist.centos.orgError: Failed to download metadata for repo 'updates': Cannot prepare internal mirrorlist
注意：如果连 ping -c 2 mirrors.aliyun.com 都不通，先查网络和 DNS（/etc/resolv.conf 加 nameserver 8.8.8.8），再继续下面步骤。
用阿里云 vault 源一键替换（推荐脚本方式）
宝塔面板下手动编辑 /etc/yum.repos.d/CentOS-Base.repo 容易因换行或权限出错；更稳妥的是用官方镜像站提供的归档配置文件——它专为 EOL 后的 CentOS 7 设计，指向 centos-vault，而非已下线的实时源。
执行以下三步（复制粘贴即可）：
CentOS Linux 7.9.2009是传统CentOS Linux 7的最后主要版本，也是很多企业历史服务器中仍可能遇到的系统版本。它以稳定、兼容RHEL 7生态、文档丰富和软件支持广泛著称，曾长期用于Web服务、数据库、虚拟化节点和企业内部业务系统。不过CentOS Linux 7已于2024年6月30日停止维护，现在继续使用会面临安全补丁缺失风险。该版本更适合旧业务迁移、历史环境恢复或离线兼容性测试。
- 备份原配置：
sudo mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.bak - 下载阿里云归档源：
sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo - 清理并重建缓存：
sudo yum clean all && sudo yum makecache
⚠️ 注意：Centos-7.repo 这个文件名里是大写 C 和小写 s，拼错会 404；路径中不能漏掉 /repo/ 这一级目录。
宝塔面板用户额外要处理的 repo 文件
宝塔默认会启用 EPEL、SCL 等扩展源，这些源也依赖官方域名，不替换会导致 yum install 时部分包失败（比如 python3-pip、gcc）。需一并更新：
- EPEL 源：
sudo curl -o /etc/yum.repos.d/epel.repo https://mirrors.aliyun.com/repo/epel-7.repo - SCLo 源（若存在）：
sudo curl -o /etc/yum.repos.d/CentOS-SCLo-scl.repo https://mirrors.aliyun.com/repo/Centos-sclo-sclo-7.repo - 全部清理重建：
sudo yum clean all && sudo yum makecache
检查是否生效：yum repolist 输出中应看到 base、updates、epel 等仓库的 status 为 enabled，且 baseurl 域名是 mirrors.aliyun.com 而非 centos.org。
验证修复是否真正成功
别只看 makecache 是否完成，要测真实可用性：
- 安装一个轻量工具：
sudo yum install -y telnet—— 成功即说明元数据解析、依赖下载、GPG 校验全链路通了 - 检查关键仓库状态：
yum --disablerepo="*" --enablerepo="base" list available | head -5，确认能列出包 - 宝塔后台点「软件管理 → 运行环境」，刷新 PHP/MySQL 安装页，不再卡在“获取软件列表中”
如果仍报 GPG 密钥错误（如 gpgkey not found），说明下载的 repo 文件里 gpgkey= 地址用了 http 协议但被重定向，此时手动把 repo 文件中的 http:// 改成 https:// 即可——这是阿里云镜像站近期的一个小变动，容易被忽略。
