Fedora换源教程 - Echo's blog

常用国内镜像源#

换源方法#

方法 1: 使用 sed 命令快速换源 ( 推荐 )#

备份原有配置#

PRTCL // BASH

1
sudo cp -r /etc/yum.repos.d /etc/yum.repos.d.backup

更换为阿里云源#

PRTCL // BASH

1
sudo sed -e 's|^metalink=|#metalink=|g' \
2
         -e 's|^#baseurl=http://download.example/pub/fedora/linux|baseurl=https://mirrors.aliyun.com/fedora|g' \
3
         -i.bak \
4
         /etc/yum.repos.d/fedora.repo \
5
         /etc/yum.repos.d/fedora-updates.repo

更换为清华源#

PRTCL // BASH

1
sudo sed -e 's|^metalink=|#metalink=|g' \
2
         -e 's|^#baseurl=http://download.example/pub/fedora/linux|baseurl=https://mirrors.tuna.tsinghua.edu.cn/fedora|g' \
3
         -i.bak \
4
         /etc/yum.repos.d/fedora.repo \
5
         /etc/yum.repos.d/fedora-updates.repo

更换为中科大源#

PRTCL // BASH

1
sudo sed -e 's|^metalink=|#metalink=|g' \
2
         -e 's|^#baseurl=http://download.example/pub/fedora/linux|baseurl=https://mirrors.ustc.edu.cn/fedora|g' \
3
         -i.bak \
4
         /etc/yum.repos.d/fedora.repo \
5
         /etc/yum.repos.d/fedora-updates.repo

更新缓存#

PRTCL // BASH

1
sudo dnf makecache

方法 2: 手动编辑配置文件#

第一步: 备份原有配置#

PRTCL // BASH

1
sudo cp /etc/yum.repos.d/fedora.repo /etc/yum.repos.d/fedora.repo.bak
2
sudo cp /etc/yum.repos.d/fedora-updates.repo /etc/yum.repos.d/fedora-updates.repo.bak

第二步: 编辑 fedora.repo#

PRTCL // BASH

1
sudo nano /etc/yum.repos.d/fedora.repo

注释掉metalink=开头的行,取消注释baseurl=行并修改为镜像源地址。

阿里云源配置示例:

PRTCL // INI

1
[fedora]
2
name=Fedora $releasever - $basearch
3
#metalink=https://mirrors.fedoraproject.org/metalink?repo=fedora-$releasever&arch=$basearch
4
baseurl=https://mirrors.aliyun.com/fedora/releases/$releasever/Everything/$basearch/os/
5
enabled=1
6
countme=1
7
metadata_expire=7d
8
repo_gpgcheck=0
9
type=rpm
10
gpgcheck=1
11
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
12
skip_if_unavailable=False

清华源配置示例:

PRTCL // INI

1
[fedora]
2
name=Fedora $releasever - $basearch
3
#metalink=https://mirrors.fedoraproject.org/metalink?repo=fedora-$releasever&arch=$basearch
4
baseurl=https://mirrors.tuna.tsinghua.edu.cn/fedora/releases/$releasever/Everything/$basearch/os/
5
enabled=1
6
countme=1
7
metadata_expire=7d
8
repo_gpgcheck=0
9
type=rpm
10
gpgcheck=1
11
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
12
skip_if_unavailable=False

中科大源配置示例:

PRTCL // INI

1
[fedora]
2
name=Fedora $releasever - $basearch
3
#metalink=https://mirrors.fedoraproject.org/metalink?repo=fedora-$releasever&arch=$basearch
4
baseurl=https://mirrors.ustc.edu.cn/fedora/releases/$releasever/Everything/$basearch/os/
5
enabled=1
6
countme=1
7
metadata_expire=7d
8
repo_gpgcheck=0
9
type=rpm
10
gpgcheck=1
11
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
12
skip_if_unavailable=False

第三步: 编辑 fedora-updates.repo#

PRTCL // BASH

1
sudo nano /etc/yum.repos.d/fedora-updates.repo

阿里云源配置示例:

PRTCL // INI

1
[updates]
2
name=Fedora $releasever - $basearch - Updates
3
#metalink=https://mirrors.fedoraproject.org/metalink?repo=updates-released-f$releasever&arch=$basearch
4
baseurl=https://mirrors.aliyun.com/fedora/updates/$releasever/Everything/$basearch/
5
enabled=1
6
countme=1
7
repo_gpgcheck=0
8
type=rpm
9
gpgcheck=1
10
metadata_expire=6h
11
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
12
skip_if_unavailable=False

清华源配置示例:

PRTCL // INI

1
[updates]
2
name=Fedora $releasever - $basearch - Updates
3
#metalink=https://mirrors.fedoraproject.org/metalink?repo=updates-released-f$releasever&arch=$basearch
4
baseurl=https://mirrors.tuna.tsinghua.edu.cn/fedora/updates/$releasever/Everything/$basearch/
5
enabled=1
6
countme=1
7
repo_gpgcheck=0
8
type=rpm
9
gpgcheck=1
10
metadata_expire=6h
11
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
12
skip_if_unavailable=False

中科大源配置示例:

PRTCL // INI

1
[updates]
2
name=Fedora $releasever - $basearch - Updates
3
#metalink=https://mirrors.fedoraproject.org/metalink?repo=updates-released-f$releasever&arch=$basearch
4
baseurl=https://mirrors.ustc.edu.cn/fedora/updates/$releasever/Everything/$basearch/
5
enabled=1
6
countme=1
7
repo_gpgcheck=0
8
type=rpm
9
gpgcheck=1
10
metadata_expire=6h
11
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
12
skip_if_unavailable=False

第四步: 编辑 fedora-modular.repo( 如果存在 )#

PRTCL // BASH

1
sudo nano /etc/yum.repos.d/fedora-modular.repo

修改方式与上述相同,将 baseurl 改为对应镜像源。

阿里云源:

PRTCL // INI

1
[fedora-modular]
2
name=Fedora Modular $releasever - $basearch
3
#metalink=https://mirrors.fedoraproject.org/metalink?repo=fedora-modular-$releasever&arch=$basearch
4
baseurl=https://mirrors.aliyun.com/fedora/releases/$releasever/Modular/$basearch/os/
5
enabled=1
6
metadata_expire=7d
7
repo_gpgcheck=0
8
type=rpm
9
gpgcheck=1
10
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
11
skip_if_unavailable=False

第五步: 编辑 fedora-updates-modular.repo( 如果存在 )#

PRTCL // BASH

1
sudo nano /etc/yum.repos.d/fedora-updates-modular.repo

阿里云源:

PRTCL // INI

1
[updates-modular]
2
name=Fedora Modular $releasever - $basearch - Updates
3
#metalink=https://mirrors.fedoraproject.org/metalink?repo=updates-released-modular-f$releasever&arch=$basearch
4
baseurl=https://mirrors.aliyun.com/fedora/updates/$releasever/Modular/$basearch/
5
enabled=1
6
repo_gpgcheck=0
7
type=rpm
8
gpgcheck=1
9
metadata_expire=6h
10
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
11
skip_if_unavailable=False

第六步: 更新缓存#

PRTCL // BASH

1
sudo dnf clean all
2
sudo dnf makecache

方法 3: 使用 dnf config-manager#

禁用 metalink,启用 baseurl#

PRTCL // BASH

1
sudo dnf config-manager --set-disabled fedora
2
sudo dnf config-manager --set-disabled updates

添加新源#

PRTCL // BASH

1
sudo dnf config-manager --add-repo https://mirrors.aliyun.com/fedora/

更新缓存#

PRTCL // BASH

1
sudo dnf makecache

验证换源成功#

查看当前源配置#

PRTCL // BASH

1
cat /etc/yum.repos.d/fedora.repo
2
cat /etc/yum.repos.d/fedora-updates.repo

测试下载速度#

PRTCL // BASH

1
sudo dnf makecache

观察下载速度,应该明显提升。

查看源列表#

PRTCL // BASH

1
dnf repolist

安装测试软件#

PRTCL // BASH

1
sudo dnf install neofetch -y

如果安装速度很快,说明换源成功。

恢复默认源#

恢复备份#

PRTCL // BASH

1
sudo cp /etc/yum.repos.d.backup/* /etc/yum.repos.d/
2
sudo dnf clean all
3
sudo dnf makecache

或手动恢复#

编辑配置文件,取消注释metalink=行,注释掉baseurl=行:

PRTCL // BASH

1
sudo nano /etc/yum.repos.d/fedora.repo
2
sudo nano /etc/yum.repos.d/fedora-updates.repo

恢复为:

PRTCL // INI

1
[fedora]
2
name=Fedora $releasever - $basearch
3
metalink=https://mirrors.fedoraproject.org/metalink?repo=fedora-$releasever&arch=$basearch
4
#baseurl=https://mirrors.aliyun.com/fedora/releases/$releasever/Everything/$basearch/os/
5
enabled=1
6
...

更新缓存:

PRTCL // BASH

1
sudo dnf clean all
2
sudo dnf makecache

一键换源脚本#

阿里云源脚本#

创建脚本文件:

PRTCL // BASH

1
nano change-to-aliyun.sh

添加以下内容:

PRTCL // BASH

1
#!/bin/bash
2

3
# 备份原有配置
4
sudo cp -r /etc/yum.repos.d /etc/yum.repos.d.backup.$(date +%Y%m%d)
5

6
# 更换为阿里云源
7
sudo sed -e 's|^metalink=|#metalink=|g' \
8
         -e 's|^#baseurl=http://download.example/pub/fedora/linux|baseurl=https://mirrors.aliyun.com/fedora|g' \
9
         -i.bak \
10
         /etc/yum.repos.d/fedora.repo \
11
         /etc/yum.repos.d/fedora-updates.repo
12

13
# 如果存在 modular 源也一并更换
14
if [ -f /etc/yum.repos.d/fedora-modular.repo ]; then
15
    sudo sed -e 's|^metalink=|#metalink=|g' \
16
             -e 's|^#baseurl=http://download.example/pub/fedora/linux|baseurl=https://mirrors.aliyun.com/fedora|g' \
17
             -i.bak \
18
             /etc/yum.repos.d/fedora-modular.repo \
19
             /etc/yum.repos.d/fedora-updates-modular.repo
20
fi
21

22
# 清理并重建缓存
23
sudo dnf clean all
24
sudo dnf makecache
25

26
echo "已成功更换为阿里云镜像源!"

赋予执行权限并运行:

PRTCL // BASH

1
chmod +x change-to-aliyun.sh
2
./change-to-aliyun.sh

清华源脚本#

PRTCL // BASH

1
#!/bin/bash
2

3
sudo cp -r /etc/yum.repos.d /etc/yum.repos.d.backup.$(date +%Y%m%d)
4

5
sudo sed -e 's|^metalink=|#metalink=|g' \
6
         -e 's|^#baseurl=http://download.example/pub/fedora/linux|baseurl=https://mirrors.tuna.tsinghua.edu.cn/fedora|g' \
7
         -i.bak \
8
         /etc/yum.repos.d/fedora.repo \
9
         /etc/yum.repos.d/fedora-updates.repo
10

11
if [ -f /etc/yum.repos.d/fedora-modular.repo ]; then
12
    sudo sed -e 's|^metalink=|#metalink=|g' \
13
             -e 's|^#baseurl=http://download.example/pub/fedora/linux|baseurl=https://mirrors.tuna.tsinghua.edu.cn/fedora|g' \
14
             -i.bak \
15
             /etc/yum.repos.d/fedora-modular.repo \
16
             /etc/yum.repos.d/fedora-updates-modular.repo
17
fi
18

19
sudo dnf clean all
20
sudo dnf makecache
21

22
echo "已成功更换为清华大学镜像源!"

更换第三方源#

RPM Fusion 源换源#

RPM Fusion 提供 Fedora 官方不包含的软件包。

启用 RPM Fusion#

PRTCL // BASH

1
sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
2
sudo dnf install https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

更换为清华源#

PRTCL // BASH

1
sudo sed -e 's|^metalink=|#metalink=|g' \
2
         -e 's|^#baseurl=https://download1.rpmfusion.org|baseurl=https://mirrors.tuna.tsinghua.edu.cn/rpmfusion|g' \
3
         -i.bak \
4
         /etc/yum.repos.d/rpmfusion-*.repo

更换为中科大源#

PRTCL // BASH

1
sudo sed -e 's|^metalink=|#metalink=|g' \
2
         -e 's|^#baseurl=https://download1.rpmfusion.org|baseurl=https://mirrors.ustc.edu.cn/rpmfusion|g' \
3
         -i.bak \
4
         /etc/yum.repos.d/rpmfusion-*.repo

更新缓存#

PRTCL // BASH

1
sudo dnf makecache

Cisco OpenH264 源换源#

编辑配置文件:

PRTCL // BASH

1
sudo nano /etc/yum.repos.d/fedora-cisco-openh264.repo

修改为:

PRTCL // INI

1
[fedora-cisco-openh264]
2
name=Fedora $releasever openh264 (From Cisco) - $basearch
3
#metalink=https://mirrors.fedoraproject.org/metalink?repo=fedora-cisco-openh264-$releasever&arch=$basearch
4
baseurl=https://mirrors.tuna.tsinghua.edu.cn/fedora/openh264/$releasever/$basearch/
5
enabled=1
6
metadata_expire=14d
7
type=rpm
8
repo_gpgcheck=0
9
gpgcheck=1
10
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$releasever-$basearch
11
skip_if_unavailable=True

其他软件源配置#

Docker 源换源#

添加 Docker 仓库#

PRTCL // BASH

1
sudo dnf config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/fedora/docker-ce.repo

或手动编辑#

PRTCL // BASH

1
sudo nano /etc/yum.repos.d/docker-ce.repo

PRTCL // INI

1
[docker-ce-stable]
2
name=Docker CE Stable - $basearch
3
baseurl=https://mirrors.aliyun.com/docker-ce/linux/fedora/$releasever/$basearch/stable
4
enabled=1
5
gpgcheck=1
6
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/fedora/gpg

安装 Docker#

PRTCL // BASH

1
sudo dnf install docker-ce docker-ce-cli containerd.io -y

配置 Docker 镜像加速#

PRTCL // BASH

1
sudo mkdir -p /etc/docker
2
sudo tee /etc/docker/daemon.json <<-'EOF'
3
{
4
  "registry-mirrors": [
5
    "https://docker.mirrors.ustc.edu.cn",
6
    "https://hub-mirror.c.163.com",
7
    "https://mirror.ccs.tencentyun.com"
8
  ]
9
}
10
EOF
11
sudo systemctl daemon-reload
12
sudo systemctl restart docker

Python pip 换源#

临时使用#

PRTCL // BASH

1
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <package>

永久配置#

PRTCL // BASH

1
mkdir -p ~/.pip
2
cat > ~/.pip/pip.conf <<EOF
3
[global]
4
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
5
[install]
6
trusted-host = pypi.tuna.tsinghua.edu.cn
7
EOF

或使用 pip 命令配置#

PRTCL // BASH

1
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

Node.js npm 换源#

临时使用#

PRTCL // BASH

1
npm install --registry=https://registry.npmmirror.com <package>

永久配置#

PRTCL // BASH

1
npm config set registry https://registry.npmmirror.com

验证#

PRTCL // BASH

1
npm config get registry

或使用 cnpm#

PRTCL // BASH

1
npm install -g cnpm --registry=https://registry.npmmirror.com
2
cnpm install <package>

Rust Cargo 换源#

编辑配置文件:

PRTCL // BASH

1
mkdir -p ~/.cargo
2
nano ~/.cargo/config

添加:

PRTCL // TOML

1
[source.crates-io]
2
replace-with = 'tuna'
3

4
[source.tuna]
5
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"

或使用中科大源:

PRTCL // TOML

1
[source.crates-io]
2
replace-with = 'ustc'
3

4
[source.ustc]
5
registry = "https://mirrors.ustc.edu.cn/crates.io-index"

DNF 配置优化#

加速 DNF 下载#

编辑 DNF 配置:

PRTCL // BASH

1
sudo nano /etc/dnf/dnf.conf

添加以下配置:

PRTCL // INI

1
# 最大并行下载数
2
max_parallel_downloads=10
3

4
# 启用最快镜像选择
5
fastestmirror=True
6

7
# 增加超时时间
8
timeout=60
9

10
# 启用增量下载
11
deltarpm=True
12

13
# 保留缓存
14
keepcache=True

清理缓存#

PRTCL // BASH

1
sudo dnf clean all

重建缓存#

PRTCL // BASH

1
sudo dnf makecache --refresh

常见问题#

更新时出现 GPG 签名错误#

PRTCL // BASH

1
sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$(rpm -E %fedora)-$(uname -m)

或临时跳过 GPG 检查:

PRTCL // BASH

1
sudo dnf install --nogpgcheck <package>

无法连接到镜像源#

检查网络连接:

PRTCL // BASH

1
ping mirrors.aliyun.com

尝试更换其他镜像源。

更新速度仍然很慢#

尝试更换其他镜像源
检查本地网络状况
优化 DNF 配置 ( 参考上文 )
使用axel或aria2加速下载

安装 axel:

PRTCL // BASH

1
sudo dnf install axel -y

配置 DNF 使用 axel:

PRTCL // BASH

1
sudo nano /etc/dnf/dnf.conf

添加:

PRTCL // INI

1
pluginpath=/usr/lib/python3.*/site-packages/dnf-plugins

提示”仓库元数据已过期”#

强制刷新元数据:

PRTCL // BASH

1
sudo dnf clean metadata
2
sudo dnf makecache --refresh

某些软件包找不到#

检查是否启用了必要的仓库:

PRTCL // BASH

1
dnf repolist --all

启用禁用的仓库:

PRTCL // BASH

1
sudo dnf config-manager --set-enabled <repo-name>

更换源后无法更新#

检查配置文件语法:

PRTCL // BASH

1
sudo dnf repolist

如果报错,检查 repo 文件格式是否正确。

恢复备份:

PRTCL // BASH

1
sudo cp /etc/yum.repos.d.backup/* /etc/yum.repos.d/

镜像源速度测试#

使用 dnf-plugins-core 测试#

PRTCL // BASH

1
sudo dnf install dnf-plugins-core -y
2
sudo dnf config-manager --set-enabled fastestmirror

手动测试下载速度#

PRTCL // BASH

1
time wget -O /dev/null https://mirrors.aliyun.com/fedora/releases/39/Everything/x86_64/os/repodata/repomd.xml
2
time wget -O /dev/null https://mirrors.tuna.tsinghua.edu.cn/fedora/releases/39/Everything/x86_64/os/repodata/repomd.xml
3
time wget -O /dev/null https://mirrors.ustc.edu.cn/fedora/releases/39/Everything/x86_64/os/repodata/repomd.xml

比较下载时间,选择最快的源。

系统升级注意事项#

升级 Fedora 版本#

在升级 Fedora 版本前,建议恢复为官方源:

PRTCL // BASH

1
sudo cp /etc/yum.repos.d.backup/* /etc/yum.repos.d/
2
sudo dnf clean all
3
sudo dnf upgrade --refresh

升级完成后再次更换为镜像源。

或直接使用镜像源升级#

PRTCL // BASH

1
sudo dnf upgrade --refresh
2
sudo dnf install dnf-plugin-system-upgrade -y
3
sudo dnf system-upgrade download --releasever=40
4
sudo dnf system-upgrade reboot

常用国内镜像源#

阿里云镜像源#

清华大学镜像源#

中科大镜像源#

网易镜像源#

上海交大镜像源#

换源方法#

方法 1: 使用 sed 命令快速换源 ( 推荐 )#

备份原有配置#

更换为阿里云源#

更换为清华源#

更换为中科大源#

更新缓存#

方法 2: 手动编辑配置文件#

第一步: 备份原有配置#

第二步: 编辑 fedora.repo#

第三步: 编辑 fedora-updates.repo#

第四步: 编辑 fedora-modular.repo( 如果存在 )#

第五步: 编辑 fedora-updates-modular.repo( 如果存在 )#

第六步: 更新缓存#

方法 3: 使用 dnf config-manager#

禁用 metalink,启用 baseurl#

添加新源#

更新缓存#

验证换源成功#

查看当前源配置#

测试下载速度#

查看源列表#

安装测试软件#

恢复默认源#

恢复备份#

或手动恢复#

一键换源脚本#

阿里云源脚本#

清华源脚本#

更换第三方源#

RPM Fusion 源换源#

启用 RPM Fusion#

更换为清华源#

更换为中科大源#

更新缓存#

Cisco OpenH264 源换源#

其他软件源配置#

Docker 源换源#

添加 Docker 仓库#

或手动编辑#

安装 Docker#

配置 Docker 镜像加速#

Python pip 换源#

临时使用#

永久配置#

或使用 pip 命令配置#

Node.js npm 换源#

临时使用#

永久配置#

验证#

或使用 cnpm#

Rust Cargo 换源#

DNF 配置优化#

加速 DNF 下载#

清理缓存#

重建缓存#

常见问题#

更新时出现 GPG 签名错误#

无法连接到镜像源#

更新速度仍然很慢#

提示”仓库元数据已过期”#

某些软件包找不到#

更换源后无法更新#

推荐镜像源选择#

教育网用户#

电信用户#

联通 / 移动用户#

海外用户#

镜像源速度测试#

使用 dnf-plugins-core 测试#

手动测试下载速度#

系统升级注意事项#

升级 Fedora 版本#

或直接使用镜像源升级#