FXXT技术栈标志FXXT技术栈Linux、Docker、Nginx 与后端运维全部 Runbook

RUNBOOK / CentOS / yum

CentOS yum/dnf 仓库连接超时:baseurl 与 DNS

yum makecache 或 dnf update 无法连接 mirrorlist。

故障现象与判断依据

最可能原因

需同时核对发行版生命周期、repo 文件和 DNS;旧版仓库可能已迁移归档。

典型输出 · 公开案例或官方资料LOG
Errors during downloading metadata for repository 'baseos':
  - Curl error (6): Couldn't resolve host name
Error: Failed to download metadata

安全诊断

以下命令用于读取状态、验证解析或复现请求;先确认目标主机、权限与影响范围。命令中的占位符必须替换为当前环境的实际值。

ShellREAD / VERIFY
dnf -v makecache
grep -R "^\(baseurl\|mirrorlist\|proxy\)" /etc/yum.repos.d /etc/dnf/dnf.conf
dnf clean all

推荐修复步骤

  1. 1读取 /etc/yum.repos.d 中启用的 baseurl 与 mirrorlist。
  2. 2确认系统版本仍受支持,归档版本按官方归档说明迁移。
  3. 3清理元数据后重新生成缓存,不用随机替换所有 repo。

验证、限制与回滚

修复后的验证

yum repolist 有预期仓库数,安全更新可查。

风险提示与回滚

不要以关闭证书校验、删除全部缓存、无限重试、关闭防火墙或放宽到 chmod 777 来替代根因定位。任何配置变更前先保留原文件和校验结果;若验证失败,恢复该备份并重新采集日志。

可信来源与适用边界

参考来源DNF Configuration Reference — DNF @DNF_VERSION@-1 documentation

proxy configuration 此页将环境级案例与本 Runbook 的检查步骤分开呈现,不能把示例日志当作当前服务器的真实事件。

网络环境检测

当 DNS、代理链路、海外依赖源或下载超时已通过本页命令确认是网络层问题时,可继续核对独立网络服务;这不替代本地根因修复。

访问边界云官方网站 →具体套餐、价格、可用线路、服务内容及相关规则以官网当前页面为准;不会携带你在工作台输入的命令、日志、Token、IP 或邮箱。