仓库管理

适用于 CentOS Stream 9 & 10 / AlmaLinux 9.x & 10.x / Rocky Linux 9.x & 10.x

软件仓库（Repository）是 DNF 获取软件包的来源。合理管理仓库是系统管理的基本功——你需要知道系统目前配置了哪些仓库、如何添加新仓库、以及如何控制仓库的优先级。

你将学到

• 查看和管理已配置的仓库
• 启用和禁用仓库
• 添加第三方仓库
• .repo 文件的结构
• 配置仓库优先级
• 使用 dnf config-manager

前置条件

• 一台已安装 EL 9.x / 10.x 的系统
• 拥有 sudo 权限的用户账户
• 系统已联网
• 了解 DNF 基础操作

查看仓库

列出已启用的仓库

查看当前启用的仓库

$ dnf repolist

输出示例：

repo id                         repo name
appstream                       AlmaLinux 9 - AppStream
baseos                          AlmaLinux 9 - BaseOS
extras                          AlmaLinux 9 - Extras

列出所有仓库（包括已禁用的）

查看所有仓库

$ dnf repolist all

输出示例：

repo id                      repo name                          status
appstream                    AlmaLinux 9 - AppStream            enabled
appstream-debug              AlmaLinux 9 - AppStream - Debug    disabled
appstream-source             AlmaLinux 9 - AppStream - Source   disabled
baseos                       AlmaLinux 9 - BaseOS               enabled
baseos-debug                 AlmaLinux 9 - BaseOS - Debug       disabled
baseos-source                AlmaLinux 9 - BaseOS - Source      disabled
crb                          AlmaLinux 9 - CRB                  disabled
extras                       AlmaLinux 9 - Extras               enabled

查看仓库详细信息

查看某个仓库的详细信息

$ dnf repoinfo baseos

输出示例：

Repo-id            : baseos
Repo-name          : AlmaLinux 9 - BaseOS
Repo-status        : enabled
Repo-revision      : 1711234567
Repo-updated       : Mon 24 Mar 2026 08:00:00 AM CST
Repo-pkgs          : 1,842
Repo-available-pkgs: 1,842
Repo-size          : 1.5 G
Repo-baseurl       : https://repo.almalinux.org/almalinux/9/BaseOS/x86_64/os/
Repo-expire        : 86,400 second(s) (last: Mon 24 Mar 2026 10:15:00 AM CST)
Repo-filename      : /etc/yum.repos.d/almalinux-baseos.repo

.repo 文件结构

所有仓库配置文件存放在 /etc/yum.repos.d/ 目录下，以 .repo 为后缀。

查看 repo 配置文件列表

$ ls /etc/yum.repos.d/

一个典型的 .repo 文件内容如下：

/etc/yum.repos.d/almalinux-baseos.repo 示例（EL 9）

[baseos]
name=AlmaLinux $releasever - BaseOS
baseurl=https://repo.almalinux.org/almalinux/$releasever/BaseOS/$basearch/os/
enabled=1
gpgcheck=1
countme=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-AlmaLinux-9
metadata_expire=86400

/etc/yum.repos.d/almalinux-baseos.repo 示例（EL 10）

[baseos]
name=AlmaLinux $releasever - BaseOS
baseurl=https://repo.almalinux.org/almalinux/$releasever/BaseOS/$basearch/os/
enabled=1
gpgcheck=1
countme=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-AlmaLinux-10
metadata_expire=86400

gpgkey 按大版本区分（-9 / -10），与 $releasever 无关；实际以系统 almalinux-release 包自带的 repo 文件为准。

各字段说明：

字段	说明
[baseos]	仓库 ID，唯一标识符
name	仓库名称，仅用于显示
baseurl	仓库的 URL 地址
mirrorlist	镜像列表 URL（与 baseurl 二选一）
enabled	1 启用，0 禁用
gpgcheck	1 启用 GPG 签名验证，0 禁用
gpgkey	GPG 公钥路径
metadata_expire	元数据过期时间（秒）
priority	仓库优先级（需要 dnf-plugins-core）

提示

$releasever 和 $basearch 是 DNF 变量，分别代表系统版本号（如 9）和架构（如 x86_64），DNF 会自动替换它们。

启用和禁用仓库

使用 dnf config-manager

EL 9 与 EL 10 都使用 DNF 4（EL 10 为 4.20），config-manager 语法相同：

禁用一个仓库

$ sudo dnf config-manager --set-disabled crb

启用一个仓库

$ sudo dnf config-manager --set-enabled crb

验证变更

$ dnf repolist | grep crb
crb                             AlmaLinux 9 - CRB

注意

CRB (CodeReady Builder) 仓库包含开发库和头文件，许多 EPEL 包依赖它。如果你打算启用 EPEL，通常也需要启用 CRB。

临时启用/禁用仓库

如果只想在某次操作中临时使用某个仓库，不必修改配置：

临时启用某个仓库来安装包

$ sudo dnf install --enablerepo=crb some-devel-package

临时禁用某个仓库

$ sudo dnf update --disablerepo=epel

添加第三方仓库

方法一：安装仓库 RPM 包

大多数知名第三方仓库提供 RPM 包来自动配置仓库：

以 EPEL 为例

$ sudo dnf install epel-release

这会自动在 /etc/yum.repos.d/ 下创建相应的 .repo 文件并导入 GPG 密钥。

方法二：使用 dnf config-manager 添加

直接添加仓库 URL

$ sudo dnf config-manager --add-repo https://example.com/repo/el9/example.repo

这会将远程 .repo 文件下载到 /etc/yum.repos.d/。

方法三：手动创建 .repo 文件

1. 创建 .repo 文件

   创建自定义仓库配置

   $ sudo vi /etc/yum.repos.d/my-custom.repo

   写入以下内容：

   [my-custom-repo]
   name=My Custom Repository
   baseurl=https://repo.example.com/el9/$basearch/
   enabled=1
   gpgcheck=1
   gpgkey=https://repo.example.com/RPM-GPG-KEY-example

2. 刷新缓存

   清除并重建缓存

   $ sudo dnf clean all
   $ sudo dnf makecache

3. 验证仓库已生效

   确认新仓库出现在列表中

   $ dnf repolist

警告

手动添加仓库时，务必启用 gpgcheck=1 并配置正确的 gpgkey。禁用 GPG 检查意味着你信任仓库中的任何包，这有安全风险。

仓库优先级

当多个仓库提供同名软件包时，可以通过优先级控制 DNF 优先从哪个仓库获取。

1. 确认 dnf-plugins-core 已安装

   安装 DNF 插件核心包

   $ sudo dnf install -y dnf-plugins-core

2. 编辑仓库配置文件，添加 priority 字段

   编辑仓库文件

   $ sudo vi /etc/yum.repos.d/epel.repo

   在 [epel] 段中添加：

   priority=10

优先级规则：

• 数值越小优先级越高
• 默认优先级为 99
• 建议将官方仓库保持默认或设为较高优先级，第三方仓库设为较低优先级

仓库	建议优先级
baseos / appstream	10（默认即可）
EPEL	20
其他第三方仓库	30 及以上

提示

优先级配置可以防止第三方仓库的包覆盖官方仓库的包。这是使用第三方仓库时的一个重要安全措施。

dnf config-manager 常用操作汇总

EL 9 与 EL 10（DNF 4.20）语法一致：

查看某个仓库的配置

$ dnf config-manager --dump baseos

设置仓库的某个选项

$ sudo dnf config-manager --save --setopt=epel.priority=20

添加远程仓库文件

$ sudo dnf config-manager --add-repo https://example.com/repo.repo

启用仓库

$ sudo dnf config-manager --set-enabled <repo-id>

禁用仓库

$ sudo dnf config-manager --set-disabled <repo-id>

常见问题

提示 “Cannot find a valid baseurl for repo”

通常是网络问题或仓库 URL 失效：

检查网络连通性

$ curl -I https://repo.almalinux.org/

如果使用 mirrorlist，检查 DNS 是否正常

# 注意：mirrorlist.centos.org 已随 CentOS Linux 7 EOL（2024-06）停用；
# Stream 9/10 的 mirrorlist 指向 mirrors.centos.org（MirrorManager），不再是旧主机名
$ dig mirrors.centos.org

如果你手头的 repo 文件里还写着 mirrorlist.centos.org，那是 EL7 时代的配置，在 Stream 9/10 上会解析失败或返回空列表——换成 mirrors.centos.org，或直接改用 baseurl 指向可用的镜像站。使用国内服务器时，通常还需要把地址替换为国内镜像源。

使用国内镜像源

以阿里云镜像为例，编辑对应的 .repo 文件，将 baseurl 替换为阿里云地址：

备份原始配置

$ sudo cp /etc/yum.repos.d/almalinux-baseos.repo /etc/yum.repos.d/almalinux-baseos.repo.bak

警告

修改仓库地址前，务必备份原始的 .repo 文件。如果镜像源出现问题，你可以快速恢复。

提示 “GPG check FAILED”

仓库的 GPG 密钥可能未导入：

手动导入 GPG 密钥

$ sudo rpm --import https://repo.example.com/RPM-GPG-KEY-example

查看已导入的 GPG 密钥

$ rpm -qa gpg-pubkey*

延伸阅读

• DNF 包管理基础 — 日常包管理操作
• EPEL 与第三方源 — 安装和使用 EPEL
• RPM 基础 — 底层包管理工具
• man dnf.conf — DNF 配置文件详细说明
• man yum.conf — 仓库配置文件格式参考