跳转到内容
搜索 AlmaLinux 文档

    浏览当前文档目录

    AlmaLinux 10 dnf versionlock 锁版本:插件安装、锁定文件位置与 exclude 的区别

    在 almalinux:10 容器(aarch64;10.2,dnf 4.20.0,python3-dnf-plugin-versionlock 4.7.0-10.el10,2026-10-30 实时仓库)中实际执行:插件安装、hostname/bc 两个 baseos 小包的 add/list/delete/clear 全流程、锁定文件路径与格式确认、锁过滤语义的决定性演示(锁条目指向旧版本时新版本安装被过滤)、以及 dnf.conf exclude= 的对照行为。原始日志:plans/content-expansion/evidence/logs/alma-versionlock.log。

    本页没有执行:跨大版本升级时锁定条目的迁移影响、锁定项与依赖更新在同一事务中的真实冲突场景(完全更新的容器仓库只有一个版本,触发不了真实升级阻断)、锁内核的行为。相关段落标注「未实测」。

    versionlock 是 dnf 的官方插件:把「允许参与安装/更新事务的版本」收窄到锁定条目匹配的版本。EL10 里一条命令即可装好:

    Terminal window
    sudo dnf install -y 'dnf-command(versionlock)'
    rpm -q python3-dnf-plugin-versionlock
    # python3-dnf-plugin-versionlock-4.7.0-10.el10.noarch

    注意包名是 python3-dnf-plugin-versionlock,dnf-command(versionlock) 只是 dnf 的「命令提供者」虚拟写法。不需要手动启用插件,装完即生效。

    Terminal window
    # 锁定当前已装(或仓库里指定)的版本
    sudo dnf versionlock add hostname-3.23-14.el10
    # Adding versionlock on: hostname-0:3.23-14.el10.*
    sudo dnf versionlock list
    # hostname-0:3.23-14.el10.*
    # 删除单条
    sudo dnf versionlock delete hostname-3.23-14.el10
    # 清空全部
    sudo dnf versionlock clear

    实测中几个容易踩的行为(日志 step-3c):

    • add 会把通配符解析成具体条目:dnf versionlock add 'hostname-*' 写入的是 hostname-0:3.23-14.el10.*,不是字面 hostname-*。想手动控制粒度就直接编辑锁定文件(见下一节)。
    • 对仓库里不存在的版本号 add 会拒绝:dnf versionlock add 'hostname-3.22*' 报 No package found for: hostname-3.22*,且不写任何条目——不能靠 add 写一条「未来版本」的锁。
    • 等价重复 add 有提示:Package already locked in equivalent form。
    • clear 清空整个锁定文件:实测清空后 /etc/dnf/plugins/versionlock.list 为 0 字节,和逐条 delete 不同。

    这是和旧教程差异最大的一点。EL10 的锁定条目默认路径是:

    /etc/dnf/plugins/versionlock.list

    由插件配置 /etc/dnf/plugins/versionlock.conf 指定(实测内容):

    [main]
    enabled = 1
    locklist = /etc/dnf/plugins/versionlock.list

    条目格式(add 生成的实际内容,含自动加的注释行):

    # Added lock on Fri Oct 30 15:52:30 2026
    hostname-0:3.23-14.el10.*

    格式是 name-epoch:version-release.*,开头的 0 是 epoch。很多老教程写的 /etc/dnf/versionlock.list 在 EL10 容器里不存在(实测 cat 报 No such file or directory)——如果你照抄旧路径手写条目,锁不会生效。确认方法:rpm -ql python3-dnf-plugin-versionlock 看插件自带的 versionlock.conf。

    锁生效的语义(决定性演示,日志 step-3b):锁定条目指向旧版本 bc-0:1.07.1-22.el10.*(仓库只有 1.07.1-23)时,dnf install bc 直接报 All matches were filtered out by exclude filtering for argument: bc,退出码 1;把条目改回 bc-0:1.07.1-23.el10.* 后安装正常。也就是说 versionlock 的实现就是给事务加一层候选过滤——不匹配锁定范围的候选一律不可见。

    本页容器是完全更新状态,仓库里没有比锁定版本更新的包,所以 dnf update pkg“ 的实测结果是「无事可做」(Nothing to do,rc=0);「锁住旧版本、仓库来了新版本时 update 被阻断」这一场景由 step-3b 的过滤语义间接证明,但完整事务级的阻断表现属未实测(见文末)。

    三种「让包不动」的手段,粒度和用途完全不同:

    手段配置位置屏蔽范围适用场景
    versionlock/etc/dnf/plugins/versionlock.list锁定版本以外的候选「装着用,但别升」:稳定依赖、内部组件
    exclude=/etc/dnf/dnf.conf(或 repo 文件)该包的所有版本,所有事务「永远不要装/升这个包」:冲突包、替代方案已存在
    仓库快照reposync 本地镜像 + 冻结元数据整个仓库视图停在某时刻可复现构建、批量部署同一基线

    实测对照(日志 step-5):dnf.conf 写 exclude=bc 后,dnf install bc 报 Unable to find a match,dnf list --available bc 也报 No matching Packages to list——exclude 是把包从所有候选里整体抹掉,连「装一个指定版本」都不行。而 versionlock 锁在当前版本时,包照常安装。三者可以叠加:exclude 优先级更高,被 exclude 的包无论锁不锁都不可见。锁内核(kernel 属于 installonly 包,多版本共存)时行为另有特殊性,本文未实测内核锁定。

    决定某个包要不要锁之前,可先用第三方聚合 PkgSeek 看一眼它在 Alma/Rocky/CentOS Stream 各仓库的当期版本分布,帮助判断锁定的代价(速查工具、非官方源;锁定候选以本机仓库实际提供的版本为准)。

    跨版本升级时的注意事项(未实测口径)

    Section titled “跨版本升级时的注意事项(未实测口径)”

    以下基于插件机制推断,本页未实测,升级前请以实际迁移演练为准:

    1. 锁定条目是否会被自动翻译/迁移无法验证:条目里的 el10、版本号都是某一代发行版的产物。跨大版本迁移(如 EL9→EL10)时,旧条目大概率失配或残留,应在迁移前审查并清理 /etc/dnf/plugins/versionlock.list,升级稳定后按新仓库重新锁定。
    2. 锁库不锁依赖会制造冲突:只锁一个库而放任依赖方更新,dnf update 可能在同一事务里因版本约束失败。出现这类冲突时的具体报错与最小修复路径,本文未实测。
    3. 安全更新会被锁挡住:长期锁定意味着补丁也进不来。对面向互联网的服务,把「锁定」改成「锁定 + 定期 review 锁定文件」的组合,比设完就忘安全。
    • 跨大版本升级(leapp 等迁移路径)时锁定条目的迁移影响。
    • 锁定包与依赖更新在同一 update 事务中的实际冲突场景:完全更新后的容器仓库只有单一版本,无法触发真实升级阻断;锁过滤语义由 step-3b 的手工锁定文件演示间接覆盖。
    • 锁 kernel 这类 installonly 包的行为。
    • EPEL 等第三方仓库与 versionlock 的组合(本页仅用 baseos)。