如果你正在使用 Fedora Linux，或者正准备从 Ubuntu、CentOS 甚至 Windows 转过来，你一定经历过那种“心碎”的时刻：打开终端，满怀期待地输入 sudo dnf update，结果屏幕上一片红色的报错，要么是因为连接超时，要么是因为 GPG 密钥校验失败，再或者就是那个令人绝望的进度条卡在 99% 好几个小时不动。
别担心，这不是你的操作有问题，也不是 Fedora 本身有 bug，而是因为你可能还在使用默认的官方源，而在中国大陆的网络环境下，这些源往往像是一条拥堵不堪的国道，不仅慢，还容易塌方。今天，我就带你手把手地把这条“国道”改成“高铁线”——通过配置阿里云或清华大学的镜像源，彻底解决更新失败和安装缓慢的问题。这不仅仅是一个技术配置，更是让你获得流畅 Linux 体验的关键一步。
为什么默认源会让你“痛不欲生”？
首先，我们要理解问题的根源。Fedora 是一个由社区驱动的项目，它的官方软件仓库（Repository）主要托管在美国或其他海外节点。对于身处海外的用户来说，这完全没问题。但对于国内用户，物理距离带来的网络延迟，以及国际出口带宽的拥塞，使得下载 RPM 包变得极其困难。
更糟糕的是，Fedora 对安全性有着极高的要求。每一次更新都需要验证软件的数字签名（GPG Key）。如果网络连接不稳定，导致下载中断，或者 GPG 密钥服务器响应超时，DNF（Fedora 的软件包管理器）就会判定校验失败，从而拒绝安装或更新。这就是为什么很多人遇到“GPG key 错误”或者“Failed to download metadata”的原因。
此外，Fedora 的更新频率非常高（通常每 6 个月一个大版本，期间频繁的小版本更新），这意味着你需要下载的数据量并不小。如果每次更新都要从海外源拉取几百兆甚至几个 G 的数据，不仅浪费时间，还容易因为网络波动导致系统状态不一致，进而引发“依赖冲突”这种让人头疼的问题。
准备工作：确认当前环境
在动手修改配置文件之前，我们需要先确认一下你当前的 Fedora 版本。不同的版本对应的镜像路径可能略有不同。打开你的终端，运行以下命令：
cat /etc/fedora-release
你会看到类似这样的输出：
Fedora release 39 (Thirty Nine)
记下这个版本号，比如这里是 39。稍后我们在配置镜像时会用到它。同时，为了确保后续操作顺利，建议先备份现有的源配置文件，这是一种良好的习惯，万一配错了，我们还可以回退。
sudo cp /etc/yum.repos.d/fedora.repo /etc/yum.repos.d/fedora.repo.bak
sudo cp /etc/yum.repos.d/fedora-updates.repo /etc/yum.repos.d/fedora-updates.repo.bak
如果有 fedora-modular 或 updates-modular 相关的文件，也一并备份。
方案一：切换到阿里云镜像源（稳定首选）
阿里云镜像站是国内非常稳定的选择，尤其是对于服务器和高负载场景。它的同步频率很高，且 CDN 覆盖广泛。
第一步：清理并禁用旧源
首先，我们需要暂时禁用默认的官方源，防止它们干扰新的配置。我们可以直接重命名现有的 repo 文件，或者创建一个空的配置文件来禁用它们。这里我们采用重命名的方式，简单直接。
sudo mv /etc/yum.repos.d/fedora.repo /etc/yum.repos.d/fedora.repo.disabled
sudo mv /etc/yum.repos.d/fedora-updates.repo /etc/yum.repos.d/fedora-updates.repo.disabled
sudo mv /etc/yum.repos.d/fedora-modular.repo /etc/yum.repos.d/fedora-modular.repo.disabled 2>/dev/null || true
sudo mv /etc/yum.repos.d/fedora-updates-modular.repo /etc/yum.repos.d/fedora-updates-modular.repo.disabled 2>/dev/null || true
注意：如果某些文件不存在，mv 命令会报错，加上 2>/dev/null || true 可以忽略这些错误，让脚本继续执行。
第二步：下载阿里云的源配置文件
阿里云提供了自动化的配置脚本，这是最省事的方法。我们可以直接使用 curl 或 wget 下载它。
sudo dnf install -y aliyun-fedorarepo
如果系统中没有安装 aliyun-fedorarepo 这个包（通常默认是没有的），你可以手动下载配置文件。访问阿里云的镜像帮助页面，找到对应版本的配置。假设你使用的是 Fedora 39，你可以手动创建或下载如下内容：
创建一个新文件 /etc/yum.repos.d/aliyun-fedora.repo：
sudo nano /etc/yum.repos.d/aliyun-fedora.repo
在文件中填入以下内容（以 Fedora 39 为例，请根据你的实际版本调整 baseurl 中的版本号）：
[fedora]
name=Fedora $releasever - $basearch
failovermethod=priority
baseurl=https://mirrors.aliyun.com/fedora/releases/$releasever/Everything/$basearch/os/
https://mirrors.aliyun.com/fedora/releases/$releasever/Everything/$basearch/debug/
mirrorlist=https://mirrors.fedoraproject.org/metalink?repo=fedora-$releasever&arch=$basearch
enabled=1
gpgcheck=1
countme=1
metadata_expire=7d
repo_gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
[updates]
name=Fedora $releasever - $basearch - Updates
failovermethod=priority
baseurl=https://mirrors.aliyun.com/fedora/updates/$releasever/Everything/$basearch/
https://mirrors.aliyun.com/fedora/updates/$releasever/Everything/$basearch/debug/
mirrorlist=https://mirrors.fedoraproject.org/metalink?repo=updates-released-f$releasever&arch=$basearch
enabled=1
gpgcheck=1
countme=1
metadata_expire=7d
repo_gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
关键点解释：
baseurl：指定了阿里云镜像的具体路径。$releasever会自动替换为 Fedora 的版本号（如 39）。gpgkey：指向本地的 GPG 密钥文件。这是解决“GPG 密钥错误”的核心。Fedora 的官方密钥通常位于/etc/pki/rpm-gpg/目录下。enabled=1：启用该源。failovermethod=priority：优先使用 baseurl，如果失败再尝试 mirrorlist。
保存并退出编辑器（在 Nano 中按 Ctrl+O, Enter, Ctrl+X）。
第三步：导入 GPG 密钥
有时候，即使配置了源，系统也可能找不到正确的 GPG 密钥。我们可以显式地导入阿里云镜像站提供的密钥，或者确保本地密钥是最新的。
sudo rpm --import https://mirrors.aliyun.com/fedora/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-primary
请将 $releasever 替换为你的实际版本，例如 39。
第四步：测试与更新
现在，让我们清理一下 DNF 的缓存，然后尝试更新系统。
sudo dnf clean all
sudo dnf makecache
sudo dnf update
如果一切正常，你应该能看到下载速度飞快提升，不再出现超时或 GPG 错误。
方案二：切换到清华大学 TUNA 镜像源（社区友好）
清华大学 TUNA 镜像站也是国内非常优秀的开源镜像源，尤其受到开发者社区的喜爱。它的界面友好，文档齐全。
第一步：禁用旧源
同样，先禁用默认源：
sudo mv /etc/yum.repos.d/fedora.repo /etc/yum.repos.d/fedora.repo.disabled
sudo mv /etc/yum.repos.d/fedora-updates.repo /etc/yum.repos.d/fedora-updates.repo.disabled
第二步：配置清华源
创建一个新的 repo 文件：
sudo nano /etc/yum.repos.d/tsinghua-fedora.repo
填入以下内容（以 Fedora 39 为例）：
[fedora]
name=Fedora $releasever - $basearch
failovermethod=priority
baseurl=https://mirrors.tuna.tsinghua.edu.cn/fedora/releases/$releasever/Everything/$basearch/os/
mirrorlist=https://mirrors.fedoraproject.org/metalink?repo=fedora-$releasever&arch=$basearch
enabled=1
gpgcheck=1
countme=1
metadata_expire=7d
repo_gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
[updates]
name=Fedora $releasever - $basearch - Updates
failovermethod=priority
baseurl=https://mirrors.tuna.tsinghua.edu.cn/fedora/updates/$releasever/Everything/$basearch/
mirrorlist=https://mirrors.fedoraproject.org/metalink?repo=updates-released-f$releasever&arch=$basearch
enabled=1
gpgcheck=1
countme=1
metadata_expire=7d
repo_gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
第三步：处理 GPG 密钥
清华源通常也建议使用官方的 GPG 密钥。如果遇到问题，可以尝试手动导入：
sudo rpm --import https://mirrors.tuna.tsinghua.edu.cn/fedora/gpg-keys/RPM-GPG-KEY-fedora-$releasever-primary
第四步：验证
同样执行清理和更新命令：
sudo dnf clean all
sudo dnf makecache
sudo dnf update
常见陷阱与解决方案
在切换镜像源的过程中，你可能会遇到一些奇怪的问题。别慌，我们来逐一排查。
问题 1：GPG 密钥错误
现象： 报错信息包含 Public key for xxx.rpm is not installed 或 The GPG keys listed for the "Fedora" repository are already installed but they are not correct for this package.
原因： 本地存储的 GPG 密钥与当前源提供的签名不匹配，或者密钥文件路径错误。
解决：
- 检查密钥路径： 确保你的 repo 文件中
gpgkey指向的文件确实存在。在 Fedora 中，密钥通常位于/etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch。注意$basearch可能是x86_64或aarch64。 - 重新导入密钥： 删除旧的密钥并重新导入。
sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch - 忽略 GPG 检查（仅用于测试）： 如果只是想临时下载某个包，可以在 repo 文件中设置
gpgcheck=0，但这会降低安全性，不建议长期使用。
问题 2：下载速度慢，但源已切换
现象： 已经配置了阿里云或清华源，但 dnf update 的速度依然很慢。
原因：
- DNS 解析问题： 你的 DNS 服务器可能无法正确解析镜像站的域名，导致回退到较慢的默认源或境外源。
- CDN 节点问题： 阿里云或清华的 CDN 在某些地区可能拥堵。
- 其他未禁用的源： 你可能只禁用了
fedora.repo和fedora-updates.repo，但还有其他第三方源（如 RPM Fusion）在使用默认源。
解决：
- 检查 DNS： 尝试将 DNS 更改为
114.114.114.114或223.5.5.5（阿里 DNS）。 - 禁用所有非镜像源： 确保所有以
.repo结尾的文件都被禁用，或者只保留你配置的镜像源文件。 - 检查 RPM Fusion： 如果你使用了 RPM Fusion 源，也需要单独配置其镜像。RPM Fusion 的官方源通常较慢，建议也切换到国内的镜像（如清华也有 RPM Fusion 的镜像）。
问题 3：系统崩溃或依赖冲突
现象： 更新过程中断，导致系统无法正常启动，或者 dnf 命令报错 Error: Transaction check error...
原因： 这通常是因为网络中断导致部分包下载不完整，或者在更新过程中强制终止了进程。
解决：
修复事务： 尝试让 DNF 自动修复。
sudo dnf autoremove sudo dnf distro-sync重装关键包： 如果某个核心包损坏，可能需要手动重装。
回滚： 如果以上方法无效，且你有使用 Btrfs 文件系统（Fedora 默认），可以利用快照功能回滚到之前的状态。
# 列出快照 btrfs subvolume list / # 挂载旧快照并启动（需要重启进入 GRUB 菜单选择旧快照）
给新手的贴心建议
我知道，对于刚接触 Linux 的朋友来说，命令行配置看起来有点吓人。但其实，只要按照步骤来，就像搭积木一样简单。这里有几个小窍门，能让你事半功倍：
- 善用 Tab 键： 在输入文件路径或命令时，多按 Tab 键，系统会自动补全，减少拼写错误。
- 查看日志： 如果遇到问题，不要只看最后一行报错。使用
sudo journalctl -xe或查看/var/log/dnf.log来获取更详细的信息。 - 不要害怕备份： 在修改任何系统配置文件之前，先备份。这是 Linux 玩家的基本素养。
- 保持好奇心： 学习 Linux 的过程也是学习网络、安全和系统架构的过程。每一次排错都是一次成长的机会。
结语
配置镜像源，看似只是一个简单的网络设置，但它直接影响着你使用 Fedora 的体验。一个快速的、稳定的软件源，能让你在开发、学习和日常使用中更加顺畅，不再被等待和错误信息所困扰。
无论是选择阿里云的稳定可靠，还是清华大学的社区友好，关键在于找到一个适合你网络环境的源。希望这篇指南能帮助你解决更新失败和安装缓慢的问题，让你在 Fedora 的世界里自由驰骋。
如果你在安装过程中遇到了其他问题，欢迎随时查阅 Fedora 官方文档，或在社区中提问。记住，Linux 社区是一个非常友好的地方，大家都会很乐意帮助新手的。现在，去试试 sudo dnf update 吧，感受一下飞一般的感觉！