AlmaLinux 10 dnf versionlock 锁版本:插件安装、锁定文件位置与 exclude 的区别
This content is not available in your language yet.
在 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 是什么、装哪个包
Section titled “versionlock 是什么、装哪个包”versionlock 是 dnf 的官方插件:把「允许参与安装/更新事务的版本」收窄到锁定条目匹配的版本。EL10 里一条命令即可装好:
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 的「命令提供者」虚拟写法。不需要手动启用插件,装完即生效。
添加、列出、删除(实测)
Section titled “添加、列出、删除(实测)”# 锁定当前已装(或仓库里指定)的版本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不同。
锁定文件在哪、格式是什么
Section titled “锁定文件在哪、格式是什么”这是和旧教程差异最大的一点。EL10 的锁定条目默认路径是:
/etc/dnf/plugins/versionlock.list由插件配置 /etc/dnf/plugins/versionlock.conf 指定(实测内容):
[main]enabled = 1locklist = /etc/dnf/plugins/versionlock.list条目格式(add 生成的实际内容,含自动加的注释行):
# Added lock on Fri Oct 30 15:52:30 2026hostname-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 vs exclude vs 仓库快照
Section titled “versionlock vs exclude vs 仓库快照”三种「让包不动」的手段,粒度和用途完全不同:
| 手段 | 配置位置 | 屏蔽范围 | 适用场景 |
|---|---|---|---|
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 “跨版本升级时的注意事项(未实测口径)”以下基于插件机制推断,本页未实测,升级前请以实际迁移演练为准:
- 锁定条目是否会被自动翻译/迁移无法验证:条目里的
el10、版本号都是某一代发行版的产物。跨大版本迁移(如 EL9→EL10)时,旧条目大概率失配或残留,应在迁移前审查并清理/etc/dnf/plugins/versionlock.list,升级稳定后按新仓库重新锁定。 - 锁库不锁依赖会制造冲突:只锁一个库而放任依赖方更新,
dnf update可能在同一事务里因版本约束失败。出现这类冲突时的具体报错与最小修复路径,本文未实测。 - 安全更新会被锁挡住:长期锁定意味着补丁也进不来。对面向互联网的服务,把「锁定」改成「锁定 + 定期 review 锁定文件」的组合,比设完就忘安全。
- 跨大版本升级(leapp 等迁移路径)时锁定条目的迁移影响。
- 锁定包与依赖更新在同一 update 事务中的实际冲突场景:完全更新后的容器仓库只有单一版本,无法触发真实升级阻断;锁过滤语义由 step-3b 的手工锁定文件演示间接覆盖。
- 锁
kernel这类 installonly 包的行为。 - EPEL 等第三方仓库与 versionlock 的组合(本页仅用 baseos)。