Linux APT包版本锁定怎么设置?如何避免升级误改关键依赖
在已有 Debian 或 Ubuntu 服务器上,如果目标是让某个软件包继续保持当前版本,优先使用 apt-mark hold;如果必须让 APT 始终选择某个明确版本,则使用 /etc/apt/preferences.d/ 中的版本策略。两者都不是“永久冻结”:显式指定其他版本、强制改变 held package、依赖关系冲突或软件源移除旧版本,都可能绕过或破坏原有锁定效果。
实际维护中,最容易误判的是“锁定已经设置,但 apt-cache policy 仍显示新版本”。apt-mark hold 只表示该包在常规安装和升级事务中保持不变,Candidate 仍可能是软件源中的新版本;最终应通过 apt-mark showhold、apt-cache policy 和 apt-get -s 模拟升级分别确认状态、候选版本和实际变更计划。
现状与条件
先确认系统、架构和软件包状态
以下操作适用于使用 APT 的 Debian、Ubuntu 及其衍生系统。先确认发行版信息、架构、已安装版本和候选版本,不要直接编辑 APT 数据库文件。
. /etc/os-release
printf '发行版:%s %s\n' "$ID" "$VERSION_ID"
printf '代号:%s\n' "${VERSION_CODENAME:-unknown}"
printf '架构:%s\n' "$(dpkg --print-architecture)"
PKG=nginx
dpkg-query -W -f='${Package}\t${Version}\t${Status}\n' "$PKG" 2>/dev/null || true
apt-cache policy "$PKG"
apt-cache madison "$PKG"
apt-cache policy 通常会显示类似结果,具体版本会随发行版、软件源和架构变化:
nginx:
Installed: 1.24.0-2ubuntu7.2
Candidate: 1.24.0-2ubuntu7.3
Version table:
*** 1.24.0-2ubuntu7.2 100
100 /var/lib/dpkg/status
1.24.0-2ubuntu7.3 500
500 http://archive.ubuntu.com/ubuntu ...
这里的含义是:
Installed是当前已安装版本;Candidate是按照当前 APT 策略准备安装的版本;100、500等数字是版本优先级;apt-mark hold可能不会改变 Candidate,但会让常规升级事务跳过该软件包;- 版本锁定策略生效后,目标版本通常会成为 Candidate,但仍不能阻止管理员显式安装其他版本。
备份配置并记录当前选择状态
版本锁定本身不会修改业务数据,但后续安装、降级或依赖调整可能触发服务重启、配置文件合并或相关软件包变更。生产环境应在维护窗口操作,并先保存 APT 配置、软件源和 dpkg 选择状态。
STAMP="$(date +%F-%H%M%S)"
BACKUP="/root/apt-lock-backup-$STAMP"
sudo install -d -m 700 "$BACKUP"
sudo cp -a /etc/apt "$BACKUP/"
sudo dpkg --get-selections | sudo tee "$BACKUP/dpkg-selections" >/dev/null
sudo apt-config dump | sudo tee "$BACKUP/apt-config.dump" >/dev/null
printf '备份目录:%s\n' "$BACKUP"
如果目标软件包属于数据库、Web 服务、容器运行时或网络组件,除了备份 APT 配置,还应保存应用自身配置,并确认当前是否存在虚拟机快照或文件系统快照。不要把 /var/lib/dpkg/status、APT 锁文件或软件包列表当作普通文本直接修改。
对于运行网站、业务后台、数据库或接口服务的服务器,APT 版本策略关系到应用依赖的持续维护。A5数据提供香港、美国、日本等多个地区的物理服务器,涵盖常规建站、Xeon Gold与AMD EPYC等配置,并有SSD或NVMe存储及不同网络线路方案,可为不同地区的业务部署和多任务运行提供硬件与网络资源。
确认旧版本仍可获取
APT 的版本锁定只能约束当前可见的软件包版本,不能替代软件包仓库。软件源清理旧版本、发行版升级、架构变化或第三方仓库下线后,原版本可能无法重新安装。
apt-cache madison "$PKG"
apt list -a "$PKG" 2>/dev/null
ls -lh /var/cache/apt/archives/"$PKG"_*.deb 2>/dev/null || true
如果目标版本只存在于本机缓存,清理缓存后可能无法恢复;如果版本只存在于内部仓库,应先确认仓库地址、发行版代号和架构没有变化。
日常操作
只要求暂时不升级:使用 hold
如果目标是“保持当前已安装版本,待测试完成后再恢复升级”,使用 apt-mark hold 最直接。
PKG=nginx
sudo apt-mark hold "$PKG"
sudo apt-mark showhold
dpkg-query -W -f='${Package}\t${Version}\t${Status}\n' "$PKG"
hold 的特点如下:
| 方式 | 主要作用 | Candidate 是否一定改变 | 适用场景 |
|---|---|---|---|
apt-mark hold | 阻止常规 APT 操作自动变更当前版本 | 否 | 临时维护、等待兼容性验证 |
| APT preferences | 改变版本候选和安装优先级 | 通常会 | 需要固定到明确版本 |
| unattended-upgrades 黑名单 | 只限制自动升级工具 | 不一定 | 自动更新策略的补充控制 |
dpkg --set-selections | 修改 dpkg 的 hold 状态 | 否 | 批量迁移旧环境,不建议作为日常首选 |
apt-mark hold 不会把版本号写成某个历史版本。如果管理员先解除 hold,软件包通常会按照当前仓库和 APT 策略继续升级。
必须固定到明确版本:配置 preferences
当“保持当前版本”不够,需要指定某个准确版本时,在 /etc/apt/preferences.d/ 创建独立配置文件。文件名建议使用字母、数字、短横线和 .pref 后缀,避免把规则直接混在发行版自带配置中。
先把目标版本填入变量,并确认该版本实际存在:
PKG=nginx
TARGET='请替换为 apt-cache policy 中存在的完整版本号'
apt-cache policy "$PKG"
apt-cache madison "$PKG"
版本号必须使用 APT 显示的完整值。某些版本包含 epoch、发行版修订号或架构相关信息,不能只凭软件包上游版本号猜测。
例如,以下配置表示将 nginx 的候选版本固定到指定版本:
sudo tee /etc/apt/preferences.d/20-nginx-version.pref >/dev/null <<EOF
Package: nginx
Pin: version $TARGET
Pin-Priority: 1001
EOF
Pin-Priority: 1001 高于 1000,除了选择目标版本外,还可能允许 APT 将已安装的新版本降级到目标版本。因此,只有在目标版本已经确认、软件源可用并完成维护窗口准备时才使用。若只是暂时阻止升级而不希望触发降级,优先采用 apt-mark hold。
写入后立即检查策略是否被读取:
apt-cache policy "$PKG"
apt-get -s install "$PKG"
apt-get -s dist-upgrade
如果 Candidate 已变为目标版本,说明 preferences 至少参与了候选选择;如果模拟事务仍计划删除关键依赖、升级相关组件或降级大量软件包,应停止实际执行,先处理依赖冲突。
需要锁定一组相互依赖的软件包
不要因为一个服务由多个软件包组成,就把所有依赖统一设置成同一个版本。先查看依赖关系:
PKG=nginx
apt-cache depends "$PKG"
apt-cache rdepends --installed "$PKG"
例如,主程序、核心组件和公共配置包可能需要保持兼容,但它们的版本号未必完全相同。对多个软件包进行锁定时,应分别从 apt-cache policy 获取可用版本,再配置独立条目:
Package: nginx
Pin: version <nginx的完整版本号>
Pin-Priority: 1001
Package: nginx-core
Pin: version <nginx-core的完整版本号>
Pin-Priority: 1001
Package: nginx-common
Pin: version <nginx-common的完整版本号>
Pin-Priority: 1001
如果只锁定底层库,例如 libc6、libssl 或 systemd,影响范围可能远大于目标服务。除非已经验证整个软件包集合和安全更新策略,否则不建议为了保护一个应用而冻结基础系统库。
执行指定版本安装或降级前先模拟
如果当前版本不是目标版本,不要直接使用 -y 执行。先用模拟模式检查计划:
PKG=nginx
TARGET='请替换为目标完整版本号'
apt-get -s install "$PKG=$TARGET"
重点查看以下内容:
- 是否出现
DOWNGRADED或明确的降级提示; - 是否计划删除目标服务或其他关键软件包;
- 是否新增、降级或升级了目标包之外的大量依赖;
- 是否提示依赖无法满足;
- 是否涉及服务重启。
确认计划符合预期后,再执行实际变更:
sudo apt-get install "$PKG=$TARGET"
只有在模拟结果明确是必要降级,并且已经确认软件源、配置和回滚路径时,才考虑根据 APT 提示增加 --allow-downgrades。不要把 --allow-downgrades、--allow-change-held-packages 和 -y 组合成无审查的自动执行命令。
完成指定版本安装后,可以再设置 hold,形成“当前版本不自动变化”的双重控制:
sudo apt-mark hold "$PKG"
但要明确两层控制的职责:preferences 决定候选版本,hold 控制常规事务是否改变当前安装状态。两者同时存在时,后续排查必须分别检查。

结果检查
检查安装版本、候选版本和 hold 状态
使用以下命令完成基础验收:
PKG=nginx
dpkg-query -W -f='${Package}\t${Version}\t${Status}\n' "$PKG"
apt-cache policy "$PKG"
apt-mark showhold | grep -Fx "$PKG" || true
期望结果取决于使用的锁定方式:
- 仅使用 hold:
Installed保持不变,Candidate可能仍然是更高版本,但apt-mark showhold应列出该包; - 仅使用 preferences:
Candidate应为目标版本,是否能安装还要看该版本是否存在及依赖是否满足; - 两者同时使用:当前版本、候选版本和 hold 状态都应符合维护计划。
用模拟升级确认不会误改关键依赖
模拟命令不会安装软件包,但可以显示 APT 计划采取的动作:
apt-get -s upgrade
apt-get -s dist-upgrade
sudo apt-get check
upgrade 通常不会主动处理需要新增或删除依赖的复杂变更,dist-upgrade 会进行更积极的依赖解析,因此两者都应检查。apt-get check 用于检测依赖关系是否已经损坏。
如果只想观察某个软件包是否出现在变更计划中,可以保存模拟结果再搜索:
PKG=nginx
apt-get -s dist-upgrade | tee "/tmp/apt-sim-$PKG.txt"
grep -E "(^Inst |^Conf |$PKG)" "/tmp/apt-sim-$PKG.txt" || true
如果 hold 生效,目标软件包通常不会出现在实际安装、升级或删除动作中。若 Candidate 是新版本但模拟升级没有变更该包,这属于正常现象,不代表 hold 失效。
检查所有配置来源,避免规则冲突
APT 规则可能来自主配置文件、preferences.d、软件源优先级和自动更新配置。先确认 APT 实际使用的路径:
sudo apt-config dump | grep -E 'Dir::Etc::(sourcelist|sourceparts|preferences)'
再检查版本策略文件:
sudo find /etc/apt/preferences.d -maxdepth 1 -type f -print \
-exec sed -n '1,120p' {} \; 2>/dev/null
sudo sed -n '1,160p' /etc/apt/preferences 2>/dev/null || true
检查软件源是否存在重复仓库、错误发行版代号或第三方来源:
grep -R --line-number --include='*.list' --include='*.sources' \
-E '^[[:space:]]*deb[[:space:]]' \
/etc/apt/sources.list /etc/apt/sources.list.d 2>/dev/null || true
在 apt-cache policy 中,如果同一个软件包出现多个来源和多个优先级,应先确认哪一个来源是预期来源。不要只通过修改优先级掩盖仓库代号错误或混用不同发行版的软件源。
检查自动升级任务
如果服务器启用了自动升级,还要确认自动任务的实际行为。先判断组件是否存在:
command -v unattended-upgrade || true
systemctl status unattended-upgrades --no-pager 2>/dev/null || true
在维护窗口内可以执行模拟检查:
sudo unattended-upgrade --dry-run --debug
同时查看历史记录:
sudo tail -n 100 /var/log/apt/history.log
sudo tail -n 100 /var/log/unattended-upgrades/unattended-upgrades.log 2>/dev/null || true
一般情况下,自动升级使用 APT 的候选和 hold 状态。如果组织策略要求某个包无论自动策略如何都不参与自动更新,可以在确认自动升级组件已安装后配置黑名单:
Unattended-Upgrade::Package-Blacklist {
"nginx";
};
这类黑名单只针对 unattended-upgrades,不会阻止管理员手动执行 apt-get install,也不会替代 apt-mark hold 或 preferences。配置后仍需用 --dry-run 验证,不能仅凭文件内容判断生效。
异常处理
设置了 hold,但软件包仍然被升级
按以下顺序检查:
- 确认 hold 状态是否存在:
apt-mark showhold
dpkg --get-selections | awk '$2 == "hold" {print $1 "\t" $2}'
- 确认执行升级的命令是否显式指定了软件包或版本。显式安装、配置管理工具、镜像构建脚本都可能与普通
apt upgrade不同。 - 检查是否使用了绕过 hold 的参数:
grep -R --line-number -E 'allow-change-held-packages|apt(-get)? .*install' \
/etc/cron* /etc/systemd /usr/local/sbin /usr/local/bin 2>/dev/null || true
- 查看 APT 和自动升级日志:
sudo grep -E 'nginx|upgrade|install|remove' \
/var/log/apt/history.log \
/var/log/unattended-upgrades/unattended-upgrades.log 2>/dev/null || true
如果 apt-mark showhold 没有输出,说明 hold 没有设置成功、已被解除,或检查的包名不正确。如果 hold 存在但 Candidate 仍是新版本,不要据此判断失败,应以 apt-get -s dist-upgrade 是否计划变更为准。
preferences 文件存在,但 Candidate 没有改变
重点检查以下几项:
Package:是否写成了正确的二进制包名,而不是源码包名;Pin: version是否包含 epoch、发行版修订号等完整版本信息;- 目标版本是否仍存在于当前架构的软件源;
- 文件是否放在 APT 实际读取的
preferences.d路径; - 文件名是否被 APT 忽略;
- 是否有其他更具体的规则或重复规则;
Pin-Priority是否低于其他版本的优先级。
用下面的命令定位:
PKG=nginx
apt-cache policy "$PKG"
apt-cache madison "$PKG"
sudo apt-get update
apt-cache policy "$PKG"
apt-get update 只刷新软件包索引,不会安装升级目标软件包,但会改变本机可见的软件源版本列表。执行后如果目标版本消失,说明问题可能是仓库保留策略,而不是 pin 语法。
不要在多个文件中为同一个包写互相矛盾的规则。建议保留一个职责清晰的锁定文件,给出原因、目标版本和维护截止日期注释:
# 维护原因:等待应用兼容性验证
# 复查日期:YYYY-MM-DD
Package: nginx
Pin: version <目标完整版本号>
Pin-Priority: 1001
依赖解析要求升级或删除关键包
如果模拟安装显示类似“未满足依赖”“将删除关键软件包”或需要同时升级大量基础库,应停止实际执行。先查看目标包及关键依赖的版本:
PKG=nginx
apt-cache depends "$PKG"
apt-cache policy "$PKG"
apt-get -s install "$PKG"
apt-get -s dist-upgrade
常见原因包括:
- 目标包的旧版本依赖一个仓库中已经不存在的库;
- 只锁定了主程序,没有锁定与其严格耦合的组件;
- 混用了不同发行版代号或不同仓库分支;
- 当前已安装的依赖版本超出了目标包支持范围;
- 通过高优先级 pin 强制选择了不再适配的旧版本。
不要使用强制参数让 APT“先装上再说”。如果业务确实需要整套旧版本,应为主程序、组件和严格依赖建立经过测试的版本集合,并准备可用的软件源或本地软件包;如果只是为了暂时避开一次升级,通常应撤销过度严格的 pin,改用单包 hold。
APT 被其他进程占用
如果出现无法获取 dpkg 或 APT 锁的提示,先找出占用进程:
ps -ef | grep -E '[a]pt|[d]pkg|[u]nattended'
sudo systemctl status apt-daily.service apt-daily-upgrade.service --no-pager
不要直接删除 /var/lib/dpkg/lock、/var/lib/apt/lists/lock 等锁文件。确认没有正在运行的安装、升级或配置事务后,再按照系统服务状态处理;强行删除锁文件可能造成 dpkg 状态损坏。
必要恢复
解除 hold 并恢复正常候选
解除 hold 不会立即安装新版本,只是允许后续 APT 事务再次处理该包:
PKG=nginx
sudo apt-mark unhold "$PKG"
apt-mark showhold | grep -Fx "$PKG" || true
apt-cache policy "$PKG"
apt-get -s install "$PKG"
确认模拟结果只包含预期升级后,再执行实际安装。若目标包有服务属性,应在执行前确认重启影响,并在执行后检查服务状态。
暂停或删除版本策略文件
如果要恢复由软件源决定候选版本,先备份再移走对应策略文件。以下操作只会移除版本选择规则,不会卸载软件包,但必须确认路径准确,避免误移其他 APT 配置。
PKG=nginx
RULE=/etc/apt/preferences.d/20-nginx-version.pref
DISABLED="/root/20-nginx-version.pref.disabled.$(date +%F-%H%M%S)"
sudo test -f "$RULE"
sudo cp -a "$RULE" "$DISABLED"
sudo mv "$RULE" "$DISABLED"
apt-cache policy "$PKG"
apt-get -s install "$PKG"
如果此前配置了多个相关软件包的 pin,应逐个检查并记录恢复前后的 Candidate。不要只删除主程序的规则,却保留底层库或组件的旧版本锁定。
版本变更失败时恢复
如果指定版本安装后服务异常,先保留日志和 APT 历史记录,不要立即执行没有目标的 apt-get -f install。该命令可能为了修复依赖而升级、降级或删除其他软件包。
sudo cp -a /var/log/apt/history.log \
"/root/apt-lock-backup-$(date +%F-%H%M%S)-history.log"
sudo systemctl status nginx --no-pager 2>/dev/null || true
sudo journalctl -u nginx -n 100 --no-pager 2>/dev/null || true
apt-cache madison nginx
如果旧版本仍在仓库或本地缓存中,先模拟回退:
PKG=nginx
OLD_VERSION='请替换为已验证可用的旧版本号'
apt-get -s install "$PKG=$OLD_VERSION"
确认不会删除关键依赖后,再执行回退。若旧版本已经不在仓库、涉及基础库降级,优先使用维护前的虚拟机或文件系统快照恢复,而不是临时拼接多个旧版本软件包。
上线或验收检查清单
- [ ] 已确认发行版、版本代号、架构和目标软件包名称。
- [ ] 已记录
Installed、Candidate和目标完整版本号。 - [ ] 已备份
/etc/apt、dpkg 选择状态和相关应用配置。 - [ ] 已确认目标版本仍存在于软件源或本地软件包缓存。
- [ ] 临时冻结场景已执行
apt-mark hold,并能在apt-mark showhold中看到目标包。 - [ ] 精确版本场景已检查
/etc/apt/preferences和/etc/apt/preferences.d/,没有重复或冲突规则。 - [ ] 已使用
apt-get -s install和apt-get -s dist-upgrade检查实际变更计划。 - [ ]
sudo apt-get check未报告依赖损坏。 - [ ] 已确认自动升级任务不会按显式规则绕过当前策略。
- [ ] 目标服务、关键端口和应用健康检查均正常。
- [ ] 已记录解除 hold、移除 pin 和恢复旧版本的具体命令。
- [ ] 已设置复查日期,避免临时版本锁定长期阻塞安全更新。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5445.html



