两个你设过一次就忘了的设置

Proxmox VE 9 不用你开口,就替你做了两件有用的事。 它给 Fisher-Price OS (Windows) 客户机提供在 KVM 上正常运行所需的半虚拟化功能,并且在启动时加载最新的 CPU 微码。

两者都是自动的。两者也都取决于你曾经做过一次的某个决定,可能是好几年前,此后再也没看过。

第一个取决于你创建虚拟机时选的 OS 类型。 选 Microsoft Windows 下的任何一项,Proxmox 每次启动都会加上 Hyper-V enlightenments。 留在 Other(导入磁盘或克隆老机器时很容易就这么留着了),客户机就一个都拿不到。 它能启动,能运行,只是更慢,而且没有任何东西告诉你。

第二个取决于主机是怎么到 9 版本的。 9.0 安装程序会启用 Debian 的 firmware 组件,并为你的 CPU 安装微码软件包。 从 8.x 升级上来的主机保留原来的软件源,在大多数主机上,这意味着根本没有微码软件包。 在运行内核 6.17.9 或更新版本的 AMD Zen 5 主机上,这不是理论上的缺口:使用 EPYC CPU 类型的客户机会启动不了。

两个默认设置,两个被遗忘的选择虚拟机:由它的 OS 类型决定OS 类型,设一次Microsoft WindowsOther 或 Linux加上 hv_ 标志每次启动一个都没有也没有警告主机:由它怎么到 9 决定Proxmox VE 9 主机9.x 安装程序从 8.x 升级微码软件包已安装没有软件包pve8to9 只是警告
两个默认设置都挂在一个早在出问题之前就做出的选择上。每种情况下右边那条路,就是没有任何警告的那条。

本文接下来逐个讲:它是什么,Proxmox 套用的确切规则,在缺失的地方如何打开,以及如何证明它生效了。 这些规则来自一台运行中的 9.2 主机上的 qemu-server 和 pve-manager 代码,不是凭记忆,因为其中两条和大多数人的猜测不一样。

Enlightenment 到底是什么

为真实硬件写的客户机操作系统,会在很多到了虚拟机里就纯属浪费的事情上花大量力气。 它通过模拟芯片来编程定时器,在一个连调度都没被调度上的 vCPU 持有的锁上空转,主机偷走几毫秒时它就触发看门狗。

半虚拟化解决这个问题的办法,是让客户机知道自己是客户机,直接和 hypervisor 对话。 Linux 用的是 KVM 自己的接口。 Fisher-Price OS (Windows) 只会说一种半虚拟化方言,就是 Hyper-V 的,所以 KVM 实现了这种方言,并告诉客户机它运行在一个兼容 Hyper-V 的 hypervisor 上。 其中的每一项叫作一个 enlightenment。

没人要求,就一项都不开。 QEMU 的文档说得很直白:“No Hyper-V enlightenments are enabled by default by either KVM or QEMU”1。 在 Proxmox 上,负责提出要求的是 qemu-server,而且它只在 OS 类型是 Microsoft Windows 下某一项时才提。

在任何主机上你都能看到差别。 下面是我 9.2 节点上的一台 Linux 虚拟机,ostype: l26,CPU 类型 host:

# qm showcmd 101 --pretty | grep -- -cpu
  -cpu host,+kvm_pv_eoi,+kvm_pv_unhalt \

两个给 Linux 自己的半虚拟化中断和自旋锁处理用的 KVM 标志,一个 hv_ 标志都没有。 对 Linux 来说是对的。对只懂 Hyper-V 的客户机来说是错的。

每个 enlightenment 做什么,按 QEMU 的说明1:

标志客户机得到什么省掉了什么
hv_timeHyper-V 参考时钟和 TSC 页无需 exit 的时间戳读取
hv_relaxed被告知关掉看门狗超时vCPU 被调度出去时的误报超时
hv_vapic给 APIC 用的 VP assist 页无需 exit 的中断结束
hv_spinlocks半虚拟化自旋锁,通知主机前的重试次数在一个持有者没在运行的锁上空转
hv_vpindex它自己的虚拟处理器编号后面四项的前提
hv_runtime每个 vCPU 实际运行了多久如实看到被偷走的时间
hv_synic, hv_stimer合成中断控制器和定时器模拟的定时器硬件
hv_ipi一次 hypercall 向多个 vCPU 发 IPI每个目标 CPU 一次 APIC exit
hv_reset通过 hypervisor 复位
hv_evmcsenlightened VMCS,仅限 Intel更快的嵌套虚拟化
hv_tlbflush半虚拟化 TLB shoot-down等待没在运行的 vCPU

OS 类型就是开关

规则在一个函数里:qemu-server 的 CPUConfig.pm 中的 get_hyperv_enlightenments2。 OS 类型先被换算成一个版本号:win11 变成 11,win10 变成 10,w2k8 和 wvista 都变成 6,XP 和 2003 类型变成 5。 Linux、Other 以及其他一切都变成 0。

然后按顺序过关卡。

qemu-server 逐道关卡加上哪些 hv_ 标志从 OS 类型到 hv_ 标志,按代码运行的顺序OS 类型版本低于 6?是停止:什么都不加OVMF 固件且版本低于 8?是停止:什么都不加机器版本 2.3,然后 2.6 或更新加上spinlocks vapic time reset vpindex runtime版本 7 或以上加上relaxed synic stimer ipiIntel 主机,版本 11,机器版本 11.0+pve2加上evmcs
qemu-server 套用它们的顺序。版本低于 6 的在第一道关卡就停了;UEFI 客户机如果类型早于 8.x,就在第二道停下,什么都不加。

读规则是一回事,跑一遍更好。 所以我在两台 9.2 主机上加载了已安装的 CPUConfig.pm,AMD 那几行用我的 AMD Ryzen 节点,Intel 那几行用一台 Intel Celeron N5100 节点,然后用每种组合去调用这个函数:

OS 类型固件机器版本主机加上的 enlightenments
l26 或 other任意任意任意无
wxp (5)SeaBIOS11.0任意无
w2k8 (Vista/2008)SeaBIOS11.0任意spinlocks、vapic、time、reset、vpindex、runtime
win7SeaBIOS11.0任意上面六项,再加 relaxed、synic、stimer、ipi
win7OVMF11.0任意无
win10OVMF11.0+pve2Intel完整的十项,没有 evmcs
win11OVMF11.0+pve1Intel完整的十项,没有 evmcs
win11OVMF11.0+pve2Intel完整的十项,再加 evmcs
win11SeaBIOS11.0+pve2AMD完整的十项,没有 evmcs

在你动 GUI 之前,这里面有三点值得知道。

OS 类型早于 8.x 的 UEFI 客户机什么都拿不到。 固件是 OVMF 且版本低于 8 时,代码会提前返回。 一台你迁到 UEFI 的 7/2008r2 客户机,已经悄无声息地丢掉了它原有的每一个 enlightenment。

hv_evmcs 要同时满足三个条件。 Intel 主机、11/2022/2025 OS 类型,以及 11.0+pve2 或更新的机器版本。 10/2016/2019 客户机默认永远拿不到它,不管机器版本多新。

主机厂商是在虚拟机启动时读取的。 检查调用的是执行启动的那个节点上的 read_cpuinfo,而不是虚拟机当初创建的地方。 在 Intel 和 AMD 混合的集群里,同一台虚拟机在一个节点上有 hv_evmcs,在另一个节点上没有,每次冷启动都重新决定。

更老的机器版本关卡(2.3、2.6、2.12、3.1)只对固定在 QEMU 远古机器版本上的虚拟机有意义。 你今天创建的任何东西都能通过它们。

所以,选和客户机最接近的 OS 类型,而不是列表里最新的那个。 10/2016/2019 客户机就该用 10/2016/2019。 Proxmox 的文档给出了类型除了这些标志之外还重要的第二个理由:它还会设定诸如虚拟 RTC 是否按本地时间运行之类的东西3。

为什么你的旧虚拟机拿不到 7 月的修复

默认带上 hv_evmcs 是新近的事。 它在 2026年7月15日 随 qemu-server 9.2.0 到来,用于“mitigate guest freezes and 100% CPU usage seen on certain Intel CPUs with Windows guests that use Virtualization-Based Security (VBS)”4,并且和机器版本 11.0+pve2 绑在一起。

问题就出在这个绑定上,因为 Proxmox 会在每台 Microsoft Windows OS 类型的虚拟机创建的那一刻,把它的机器版本固定下来。 文档给出了理由:“Windows is sensitive to changes in the virtual hardware - even between cold boots”3。 这是个合理的决定。它同时也意味着,一台 2026年6月 创建的虚拟机停在 11.0+pve1 或更老的版本上,并会一直停在那里,直到有人去挪它。

会有人替你挪吗?不会。 新的默认值只对新虚拟机和你主动升级的虚拟机生效,别的一概不管。

如果你有 Intel 主机在跑开了 VBS 的 11/2022/2025 客户机,而其中有任何一台曾经卡死在 100% CPU,这是第一件要查的事:

qm config <vmid> | grep -E '^(ostype|machine):'

ostype: win11 配上低于 pc-q35-11.0+pve2 的 machine: 行,就需要往上挪才能拿到修复。 挪动会改变客户机看到的虚拟硬件,而这恰恰是固定版本要防止的事。 所以要在维护窗口里做,先做好备份或快照,然后通过 Hardware → Machine → Edit,勾上 Advanced,选择版本。

如果这一行是以 pc-i440fx- 开头的,版本反倒是小问题:这台客户机根本就不该在 i440fx 上,理由见 Always Use Q35, Not i440fx,下文的 设置它,并证明它生效了 会讲到。

同样这几个月里还落地了两个相关的默认值,既然你都到这儿了,值得知道。 qemu-server 9.1.12 为 11/2022/2025 类型关掉了 cet-ibt 和 cet-ss 标志,因为在 QEMU 11.0 和暴露这两个标志的 7.x 内核下,开了 VBS 的客户机启动失败4。 而 9.1.14 暴露了 CPU 的 level 属性,文档描述它是“a known workaround for Hyper-V boot failures of Windows guests on recent Intel hosts when the CPU type is host or max”3。

QEMU 这一侧,逐个版本看

qemu-server 负责构造命令行。pve-qemu-kvm 是运行它的那个 QEMU,7 月的修复两者都需要。

只有装了 QEMU 11.0 二进制,才能选机器版本 11.0+pve2,因为 qemu-server 拒绝任何比它在主机上找到的 QEMU 更新的机器版本5。 +pve2 是 qemu-server 自己的修订计数,不是 QEMU 的,所以任何 11.0 构建都满足它。 9.2.0 发布当天,这一对是这样的:

软件包版本发布日期带来了什么
qemu-server9.2.02026年7月15日hv-evmcs 默认值和机器版本 11.0+pve2
pve-qemu-kvm11.0.2-12026年7月1日QEMU 11.0.2,当天的最新版
pve-qemu-kvm,最低要求11.0.0-12026年5月5日第一个 QEMU 11.0 构建

apt 会确保你两个都有吗?不会。 qemu-server 9.2.0 声明的依赖不比 pve-qemu-kvm (>= 7.1~) 更强6,所以一个把 QEMU 压在 10.x 上的节点,会一声不吭地装上新的 qemu-server,然后却提供不了修复所依赖的那个机器版本。 两个都要查,每个节点都要查。这是我今天的 9.2 主机,两者都早已超过:

# pveversion -v | grep -E '^(qemu-server|pve-qemu-kvm):'
pve-qemu-kvm: 11.0.3-4
qemu-server: 9.2.11

自 Proxmox VE 9.0 搭载 10.0.2 发布以来7,每个 QEMU 版本都为 Fisher-Price OS (Windows) 客户机带来了自己的修复。 下面是涉及客户机的那些,出自 Proxmox 的软件包变更日志8和 QEMU 上游的变更日志9:

QEMUProxmox 构建为客户机修了什么
10.010.0.2-1,2025年6月17日“PCI Label Id” 缺陷,英文版无害,但可能让本地化安装卡死
10.110.1.2-3,2025年11月17日一个弄坏鼠标指针的 VNC 剪贴板回归
10.110.1.2-5,2025年12月22日带 TPM 磁盘的虚拟机备份卡住,一个 io_uring 修复
11.011.0.0-1,2026年5月5日swtpm 存放 TPM 状态所用的 FUSE 导出中的一个回归
11.011.0.2-1,2026年7月1日Hyper-V enlightenments 被识别为 CPUID 标志,于是自定义 CPU 型号可以带上它们

QEMU 11.0 也弄坏了一样东西:它开始暴露 cet-ibt 和 cet-ss,这就是让 VBS 客户机启动不了、迫使 qemu-server 9.1.12 把它们关掉的原因,上文已经讲过。

同一批版本里 guest agent 的修复是另一回事。QEMU 10.1、10.2 和 11.0 各自修了 guest agent 的 VSS 和文件系统冻结处理中的一部分,包括 11.0 治好的那个“Access denied Event ID 8194”9。 这些都不会随 pve-qemu-kvm 一起到来。这类客户机的 agent 是放在 virtio-win 驱动 ISO 里发布的10,所以只有你在虚拟机里更新 agent 时它才会变。

两个可以手动设置的标志

Proxmox 不让你给虚拟机随便加 CPU 标志。 Hardware → Processors → Edit,勾上 Advanced,Extra CPU Flags 提供一个固定列表,定义在 CPUFlags.pm 里11。 列表上有两项是 enlightenment,而且正是 Proxmox 默认不设置的那两项,至少到 7 月之前是这样。

标志Proxmox 自己的描述什么时候设置
hv-tlbflush“Improve performance in overcommitted Windows guests. May lead to guest bluescreens on old CPUs.”可选。先拿一台虚拟机试,盯着它。
hv-evmcs“Improve performance for nested virtualization. Only supported on Intel CPUs.”在 Intel 上,客户机里跑嵌套 Hyper-V、WSL2 或 VBS 时。11/2022/2025 在 11.0+pve2 下已经默认打开。

两者都是在 2019年7月23日 的 qemu-server 6.0-6 中改成需要手动开启的,变更日志里的描述是“sometimes problematic”4。 hv-tlbflush 这样一待就是七年。这已经清楚地暗示了,在你把它推到整个集群之前它需要多少测试。

QEMU 自己对 hv-evmcs 的说明是:它只适用于 Intel,并且“some virtualization features (e.g. Posted Interrupts) are disabled when hv-evmcs is enabled”1。 在一台没做嵌套虚拟化的客户机上手动打开它,你什么也得不到,还要付出这个代价。

设置它,并证明它生效了

新虚拟机:Create VM → OS,把 Type 设为 Microsoft Windows,Version 选最接近的那个。

已有的虚拟机:Options → OS Type → Edit,选版本,OK。 把已有虚拟机改成 Microsoft Windows 类型时,Proxmox 会固定它的机器版本,和创建时一样4,所以配置里的 machine: 行也会跟着变,这在意料之中。

还要把它放到 q35 上。一个开了 enlightenments 的客户机没理由待在 pc-i440fx 上。 那是一个没有 PCIe 总线的芯片组,理由远不止直通,全都在 Always Use Q35, Not i440fx 里。

向导不会拦你,而且对大多数 Microsoft Windows 类型,它恰恰会把你放在那里。 Proxmox 自己的文档称 Intel 440FX 为“the default”3,而 GUI 的 OS 默认值只为一项覆盖了它:11/2022/2025 得到 machine: 'q35' 和 bios: 'ovmf'12。 其他每一种 Microsoft Windows 类型都继承通用默认值,而通用默认值根本不设机器类型。 所以一台一路点 Next 创建的 10/2016/2019 客户机会落在 i440fx 上,开着 enlightenments,同时用着错误的芯片组。

向导里选的 OS 类型得到的机器类型得到的固件
11/2022/2025q35OVMF
10/2016/2019 以及更老的每一种 Microsoft Windows 类型i440fxSeaBIOS
Other、Linuxi440fxSeaBIOS

在完成向导之前,到 System 选项卡改掉它。 对已经存在的虚拟机,换芯片组对虚拟硬件的改动比升机器版本更大,所以同样的维护窗口和备份规则都适用,客户机对此会作何反应,q35 那篇文章里有讲。

然后要正经地停机。 enlightenments 是 QEMU 命令行上的参数,而这一行只在 QEMU 进程启动时才构造。 从客户机内部重启,用的还是同一个进程,所以还是旧标志。关机,等到 stopped,再点 Start。

从主机上证明,因为答案在那里:

qm showcmd <vmid> --pretty | grep -o "hv_[a-z_]*[=0-9a-fx]*" | sort -u

它打印出 qemu-server 下次启动时会交给 QEMU 的东西。 Intel 上一台 11.0+pve2 的 11/2022/2025 客户机应该列出十一项:hv_evmcs、hv_ipi、hv_relaxed、hv_reset、hv_runtime、hv_spinlocks=0x1fff、hv_stimer、hv_synic、hv_time、hv_vapic 和 hv_vpindex。 同样的客户机在 AMD 上列出十项。结果为空,说明 OS 类型不是 Microsoft Windows 下的某一项,或者是 UEFI 上一个早于 8.x 的类型。

如果改完之后客户机启动不了,就把 OS 类型改回 Other 启动一次,以确定是不是 enlightenments 的问题。 没有它们也能跑。只是跑得更差。

微码:它修什么,从哪里来

第二个默认设置位于 hypervisor 之下,而不是之上。

CPU 微码是厂商给处理器本身的固件。 更新会修复安全漏洞和严重的 CPU 缺陷,而对担心速度损失的人来说,Proxmox 管理指南说中了要害:“a patched microcode is usually still more performant than an unpatched microcode where the kernel itself has to do mitigations”13。

它可以来自三个地方,彼此独立。

来源何时应用谁发布今天在我的 9.2 主机上
主板 BIOS/UEFI 更新每次上电,持久主板或服务器厂商最后一版 BIOS 带的是什么就是什么
Debian non-free-firmware启动早期,从 initramfs 加载Debianintel-microcode 3.20251111.1~deb13u1,amd64-microcode 3.20250311.1
Proxmox VE 软件源启动早期,从 initramfs 加载Proxmoxamd64-microcode 3.20251202.1~bpo13+1,没有 Intel 软件包

BIOS 这条路是 Proxmox 推荐的13。 早期加载这条路是安全网,用在主板厂商已经不再发布 BIOS 更新的时候,而对任何用了几年的设备,他们通常已经不发了。

第三行让我意外。 Proxmox 在自己的软件源里带了一个比 Debian trixie 更新的 amd64-microcode14,pin 优先级相同,所以 apt 会选 Proxmox 的那个。 在配置了 Proxmox 软件源的 AMD 主机上,你最终运行的就是这个版本,而且下一节会说明,要紧的正是这个版本。

启动过程中微码在哪里应用一次启动,从左到右上电BIOS 微码引导程序加载 initramfs内核启动早期更新主机运行客户机启动后期加载被封掉持久,主板厂商来自 initramfs,Debian 或 Proxmox黑名单位于/etc/modprobe.d
早期加载发生在内核启动任何其他东西之前。在运行中的系统上做后期加载,是 Debian 封掉的那条路,而且一直封着。

早期加载是本文要配置的东西。 微码被放进 initramfs,内核在启动的最开始、任何其他东西运行之前应用它。

后期加载是把它应用到一个正在运行的系统上。 内核自己的文档有一节标题就叫“Why is late loading dangerous?”,而且从 5.19 起它默认不再启用15。 Debian 也封掉了它。这是我主机上的文件,原样照录:

# cat /etc/modprobe.d/amd64-microcode-blacklist.conf
# The microcode module attempts to apply a microcode update when
# it autoloads.  This is not always safe, so we block it by default.
blacklist microcode

别动它。上面这台主机有这个文件,照样显示了一次成功的早期更新,所以它不碍任何事。

两条路都需要重启。绕不过去。

而且只适用于 x86。Proxmox 的指南直说了:“There is no equivalent operating-system-level microcode package for arm64”13。

为什么升级来的主机上一个都没有

non-free-firmware 里的“non-free”讲的是许可证,不是钱,也不是 Proxmox 订阅。 Debian 的 wiki 解释过:内核那一侧是自由软件,但厂商的更新数据是“opaque”,“and its contents are unknown to Debian”16。 这就是它为什么单独放在一个组件里,也是为什么 Debian 系统不打开这个组件就拿不到它。

Proxmox VE 9.0 的安装程序会打开它。发行说明说,ISO 会“Install the microcode package matching the current platform”,并且“installations now have the non-free-firmware repository enabled”7。 升级两样都不做,因为它保留你在 8.x 上的软件源配置。

全新安装 9.x从 8.x 升级
non-free-firmware由安装程序启用8.x 上是什么就是什么,经常没有
微码软件包按检测到的 CPU 安装没有,直到你加上这个组件
谁告诉你用不着pve8to9,一个 FAIL 加一个 WARN,而且前提是你运行了它
后续更新apt full-upgrade 加一次重启一样,只要软件包装上了

检查工具确实会标出来,比我预料的还响。这是它在我那台从 8.x 升上来的 Intel 节点上的输出:

# pve8to9 | grep -i -B1 -A2 microcode
PASS: Legacy file '/etc/sysctl.conf' is not present.
INFO: Checking if matching CPU microcode package is installed.
FAIL: unable to determine installed intel-microcode version.
WARN: The matching CPU microcode package 'intel-microcode' could not be found! Consider installing it to receive the latest security and bug fixes for your CPU.
	apt install intel-microcode
SKIP: NOTE: Expensive checks, like CT cgroupv2 compat, not performed without '--full' parameter

那个 FAIL 是副作用:版本查询会为任何没安装的软件包记录一次失败,然后微码检查才轮到发出它自己的警告17。 不管怎样,pve8to9 是检查工具,不是关卡。它不执行升级,也拦不住升级,所以升级会直接从它身边开过去。

这在实际中要紧吗?下面是两个要紧的例子,第一个就是我自己的。

那台 Intel 节点是一颗 Celeron N5100。它的软件源列表里早就有 non-free-firmware,所以软件包只差一条命令,而直到 2026年10月27日 都没人运行过它。 就算别人都没注意到,内核注意到了:

# dmesg | grep -i microcode
[    0.000000] x86/CPU: Running old microcode
[    0.497219] microcode: Current revision: 0x0000001d
# lscpu | grep -i 'old microcode'
Vulnerability Old microcode:             Vulnerable

内核保存着“a table of released microcode”,用任何更老版本启动的 CPU 都“will say ‘Vulnerable’”18。 老到什么程度?Intel 的发行说明为这颗芯片给出了答案19:

修订号Intel 发布在这台主机上
0x1dmicrocode-20210608今天主板固件加载的版本
0x2400001fmicrocode-20220207
0x24000023microcode-20220510比这块主板的 BIOS 构建早六个月发布
0x24000024microcode-20230214
0x24000026microcode-20240312在 Debian 的 intel-microcode 3.20251111.1~deb13u1 里

BIOS 版本 5.19,日期 2022年11月8日,它加载的仍然是 Intel 为这颗芯片发布的第一个微码,而构建它的时候已经有两个更新的版本发布了。 这正是早期加载这条路存在的意义:四个更新,就躺在一个这台主机本来就看得到的软件包里。 我写这篇文章时把它装上了,结果如何写在 开启它 里,因为那里有个坑。

第二个例子是 AMD 的。Zen 5 处理器的 RDSEED 指令有缺陷20。 Proxmox 9.1 的发行说明记录了接下来会发生什么:6.17.9 起的内核,“without active microcode update will disable the RDSEED32 CPU-bit, and will fail to run Qemu guests with a CPU type that exposes that bit (for example EPYC or EPYC-v4)”21。 修复是 amd64-microcode 3.20251202.1~bpo13+1 或更新的版本,那是 Proxmox 软件源里的版本,不是 Debian 的。

这里面还套着第二个坑。 在 BIOS 早于 AMD Entrysign 漏洞修复的 Zen 5 主板上,内核会拒绝新微码,并记录 No sha256 digest for patch ID,Proxmox 的建议是更新 BIOS21。 所以在这种硬件上,操作系统这条路只有在主板厂商尽了自己那份责任之后才走得通。

开启它

先记下你现在的状态。在主机上,以 root 身份:

pveversion
grep -m1 vendor_id /proc/cpuinfo                 # GenuineIntel or AuthenticAMD
grep microcode /proc/cpuinfo | uniq              # revision running now
dpkg -l intel-microcode amd64-microcode 2>/dev/null | grep ^ii
dmesg | grep -i microcode
lscpu > /root/lscpu-before.txt                   # vulnerabilities and mitigations

如果 dpkg 已经显示对应的软件包是 ii,这台主机就已经好了,可以直接跳去检查结果。

启用这个组件。 Trixie 的 apt 偏好 deb822 的 .sources 格式,Proxmox 的升级指南指向 apt modernize-sources 来转换旧的单行文件,原文件保留为 .bak22。 然后在 /etc/apt/sources.list.d/debian.sources 里,主仓库和安全仓库两段的 Components: 行都加上 non-free-firmware。 这是我主机上的文件,来自安装程序:

Types: deb
URIs: http://deb.debian.org/debian/
Suites: trixie trixie-updates
Components: main contrib non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: http://security.debian.org/debian-security/
Suites: trixie-security
Components: main contrib non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

两段都要,因为 Debian 通过这两条路向 stable 发布微码。 安全仓库带的是 intel-microcode 3.20250812.1~deb13u1,而主仓库已经到了 3.20251111.1~deb13u123,你要的是最新的那个。

装上和 CPU 对应的那个。

apt update
apt install intel-microcode     # Intel
apt install amd64-microcode     # AMD

只装你那个厂商的。此后新的微码会随普通的 apt full-upgrade 一起到来,每个新版本都和第一次一样需要重启。

安装它会重建 initramfs,因为早期微码必须放在那里。 内核从 initrd 最前面的一个未压缩归档里读取它,路径是 kernel/x86/microcode/GenuineIntel.bin 或 AuthenticAMD.bin15,软件包的安装脚本会触发 initramfs 触发器把它放进去24。 这是写这篇文章时,我的 Intel 节点装上这个软件包的过程:

# grep -A6 'Setting up intel-microcode' /var/log/apt/term.log
Setting up intel-microcode (3.20251111.1~deb13u1) ...
intel-microcode: microcode will be updated at next boot
Processing triggers for man-db (2.13.1-1) ...
Processing triggers for initramfs-tools (0.148.4) ...
update-initramfs: Generating /boot/initrd.img-7.0.14-24-pve
Running hook script 'zz-proxmox-boot'..
Re-executing '/etc/kernel/postinst.d/zz-proxmox-boot' in new private mount namespace..

zz-proxmox-boot 是 Proxmox 的钩子。在 EFI 分区由 proxmox-boot-tool 维护的主机上,它会把新镜像复制过去;这台主机没有需要同步的。

现在看看它生成的是哪个镜像。不指定内核时,update-initramfs -u 只重建最新的那个:“The default is the latest kernel version”25。 同一个节点,紧接着:

# uname -r
7.0.14-23-pve
# for f in /boot/initrd.img-*; do echo "$f: $(lsinitramfs $f 2>/dev/null | grep -c GenuineIntel.bin)"; done
/boot/initrd.img-7.0.12-1-pve: 0
/boot/initrd.img-7.0.14-11-pve: 0
/boot/initrd.img-7.0.14-12-pve: 0
/boot/initrd.img-7.0.14-19-pve: 0
/boot/initrd.img-7.0.14-23-pve: 0
/boot/initrd.img-7.0.14-24-pve: 1
/boot/initrd.img-7.0.14-8-pve: 0

七个镜像里只有一个带了微码,而且不是主机正在运行的那个。

下次启动initramfs 里有没有微码CPU 最终用的修订号
7.0.14-24,默认启动项有软件包里的 0x24000026
7.0.14-23,固定的或后备启动项没有BIOS 的 0x1d
任何更老的没有BIOS 的 0x1d

所以装完之后要重建所有镜像,每次微码更新之后也要再来一次,因为每次都会触发同样的只重建最新镜像。然后再跑一遍上面的循环来证明它:

update-initramfs -u -k all

重启并检查。 这是我的 AMD 9.2 主机装上 Proxmox 软件源的软件包之后:

# grep microcode /proc/cpuinfo | uniq
microcode	: 0xa500012
# dmesg | grep -i microcode
[    0.587928] microcode: Current revision: 0x0a500012
[    0.587930] microcode: Updated early from: 0x0a50000d

Updated early from 就是证明它生效的那一行。 Proxmox 自己的管理指南还显示着较早的措辞 microcode updated early to revision13;当前内核打印的是上面那两行26。两种形式都说明成功了。

没有这一行本身并不是故障。 只有当软件包里有比 CPU 内置修订号和 BIOS 加载的修订号都更新的东西时,它才会出现。 一个软件包覆盖非常多的 CPU 型号,指南说得对:软件包上的日期并不能告诉你,你的型号上一次拿到东西是什么时候13。

在集群上滚动推进

软件源的修改和安装可以在所有节点上同时进行。重启之前什么都不会变。 重启则一次一个节点,每个节点恢复健康之后,下一个才能停机。

微码滚动重启,每轮一个节点逐个节点,然后下一个检查法定人数、Ceph维护模式客户机迁走noout可选重启检查 dmesg等待OSD 都 up 和 in释放取消,迁回下一个节点,同样的步骤
每轮一个节点。两个 Ceph 步骤只适用于超融合集群,noout 那一对是可选的。
步骤命令完成标志
集群健康pvecm status、ceph -s有法定人数,HEALTH_OK
清空节点ha-manager crm-command node-maintenance enable <node>,非 HA 客户机手动迁移节点上没有客户机了
可选,Cephceph osd set nooutceph -s 里显示该标志
重启,验证dmesg | grep -i microcode显示新的修订号
Ceph 已恢复ceph -s所有 OSD 都是 up 和 in,HEALTH_OK
释放node-maintenance disable <node>、ceph osd unset nooutHA 客户机迁回

HA 维护模式会记录每个 HA 客户机从哪里来,等节点退出维护后把它迁回去27。 非 HA 客户机是你的事。

关于 noout,意见不一,两边都有道理。 Ceph 很快就会把一个没动静的 OSD 标记为 down,但要过了 mon_osd_down_out_interval 才会标记为 out,这个值默认是十分钟28,而触发重平衡的是 out。 一次正常的重启远在这之前就回来了。一台 POST 很长、有固件提示、或者 RAID 控制器很慢的服务器,就未必。 设置 noout 可以防止一次慢重启变成一次重平衡。代价是要记得取消它,而一个被遗忘的 noout 会在之后掩盖真正的故障。

整个集群在一个窗口里做完。 各节点跑着不同的微码修订号,恰恰就是这样一种情形:一台 CPU 类型为 host 的客户机(它直接看到物理 CPU 的特性)可以在线迁移到一个报告着另一组特性的节点上。

微码更新出问题时

很少见,但确实会发生,Proxmox 的指南讲得很周全13。

情形这样做为什么
你怀疑新微码用 dis_ucode_ldr 启动一次只在这次启动时禁用加载器29
旧修订号没事,新的有事装回较早的版本并 hold 住purge 可能让一个更老的 BIOS 修订号跑起来
几周之后apt-mark unhold,然后 full-upgrade别处的修复可能在同一微码版本下就治好它

一次性启动:GRUB 菜单(如果隐藏了就按住 Shift),在 Proxmox 启动项上按 E,在以 linux 开头的那一行末尾加上 dis_ucode_ldr,然后 Ctrl+X。 用 systemd-boot 而不是 GRUB 的主机,管理指南的引导程序一章里有讲。

在 Intel 上降级:

apt list -a intel-microcode               # what versions exist
apt install intel-microcode=<version>     # pick the earlier one
apt-mark hold intel-microcode             # stop the next upgrade undoing it
reboot

AMD 上换成 amd64-microcode。只降级,绝不 purge。

默认值是给走了预期那条路的人的承诺

这两件事都不是缺陷。 Proxmox 两次都做了明智的事:在安全的地方打开功能,在可能不安全的地方关着,并把客户机挑剔的虚拟硬件固定住。 安装程序修好了,升级检查工具会标出来,变更日志写明了改了什么、什么时候改的。 Proxmox 尽了它的那份责任。

但默认值是对那个按厂商预期方式做事的人许下的承诺。 全新安装,OS 类型正确,虚拟机在 7 月之后创建。 任何一个环境有历史的人,也就是每个在跑真东西的人,都有一部分落在这个承诺之外,而这个缺口不会自己吭声。 它表现为一台有点慢的客户机,一次没人会联想到机器版本的 VBS 卡死,或者一个 Zen 5 节点,内核更新之后上面的 EPYC 客户机启动不了。

发行说明描述的是全新安装会得到什么。 关于你的主机实际在跑什么,它们只字未提,而这是两个不同的问题。 回答第二个问题的唯一办法就是去看:客户机上的 qm showcmd,主机上的 dmesg,配置里的 machine 那一行。 每台机器都花不了一分钟。

那一分钟就是这份工作。Proxmox 给了你检查的工具,因此,你以为的和实际在跑的之间的那个缺口,得由你来补上,不是他们。


  1. QEMU documentation — Hyper-V Enlightenments — “No Hyper-V enlightenments are enabled by default by either KVM or QEMU”;各标志的说明;hv-evmcs:“The feature is Intel-only”以及“some virtualization features (e.g. Posted Interrupts) are disabled when hv-evmcs is enabled”。 ↩︎ ↩︎ ↩︎

  2. Proxmox qemu-server — CPUConfig.pm — get_hyperv_enlightenments:OVMF 和版本关卡、机器版本限制,以及 hv_evmcs 的 GenuineIntel 检查。本文在 qemu-server 9.2.11 上实际运行。 ↩︎

  3. Proxmox VE admin guide — Qemu/KVM Virtual Machines — “You can choose between the default Intel 440FX or the Q35 chipset”和“switch from the default SeaBIOS to OVMF”;“For Windows guests, the machine version is pinned during creation, because Windows is sensitive to changes in the virtual hardware - even between cold boots”;这类客户机的 level 属性以及 cet-ibt/cet-ss 默认值。 ↩︎ ↩︎ ↩︎ ↩︎

  4. Proxmox qemu-server — Debian changelog — 9.2.0(2026年7月15日)从机器版本 11.0+pve2 起为 Intel 上的 11/2022/2025 客户机启用 hv-evmcs;9.1.14 暴露 level;9.1.12 禁用 cet-ibt 和 cet-ss;切换到 Microsoft Windows OS 类型时固定版本(2025年1月);6.0-6(2019年7月23日)“Make sometimes problematic ‘hv-tlbflush’ and ‘hv-evmcs’ CPU flags optional”。 ↩︎ ↩︎ ↩︎ ↩︎

  5. Proxmox qemu-server — Machine.pm — 当机器版本对应的 QEMU major.minor 比已安装的二进制更新时,can_run_pve_machine_version 返回 false;+pveN 修订号也列在同一个文件里。 ↩︎

  6. Proxmox qemu-server 9.2.0 — debian/control — 在 2026年7月15日 的“bump version to 9.2.0”提交中,运行时依赖是 pve-qemu-kvm (>= 7.1~)。 ↩︎

  7. Proxmox VE Roadmap — 9.0, Installation ISO — “Install the microcode package matching the current platform… This also means that installations now have the non-free-firmware repository enabled.”;同一版本列出了“QEMU 10.0.2” ↩︎ ↩︎

  8. Proxmox pve-qemu — Debian changelog — 10.0.2-1(2025年6月17日)“update QEMU and downstream patches for 10.0.2 release”,其中带有下面那个上游 10.0 修复;10.1.2-3“a regression with VNC clipboard breaking mouse pointer in Windows guests”;10.1.2-5 针对“backup with TPM disk potentially getting stuck”的 io_uring 修复;11.0.0-1“regression when using fuse export for swtpm”;11.0.2-1“recognize Hyper-V enlightenments in the list of supported CPUID flags”。 ↩︎

  9. QEMU upstream changelogs, 10.0 — “Workaround ‘PCI Label Id’ Windows bug, which is normally harmless but on localized versions can lead to guest hangs”;guest agent 的 VSS 和冻结修复见 10.1、10.2 和 11.0,其中包括“Fix guest-fs-freeze cause ‘Access denied Event ID 8194’ in Event Viewer”。 ↩︎ ↩︎

  10. Proxmox VE wiki — Qemu-guest-agent — 对这类客户机:“First you have to download the virtio-win driver iso”。 ↩︎

  11. Proxmox qemu-server — CPUFlags.pm — 单台虚拟机的标志列表,含上文引用的 hv-tlbflush 和 hv-evmcs 描述。 ↩︎

  12. Proxmox pve-manager — OSDefaults.js — win11 条目设置 machine: 'q35' 和 bios: 'ovmf';其他 Microsoft Windows 条目继承 generic,而它不设机器类型。 ↩︎

  13. Proxmox VE admin guide — CPU Microcode Updates — 操作系统早期更新、推荐的 BIOS/UEFI 途径、arm64 没有操作系统层面的软件包、dis_ucode_ldr 步骤,以及降级而不是 purge。 ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  14. Proxmox VE pve-no-subscription repository for trixie — 带有 amd64-microcode 3.20251202.1~bpo13+1,没有 intel-microcode,2026年10月27日 读取。 ↩︎

  15. Linux kernel documentation — The Linux Microcode Loader — “Since kernel 5.19, late loading is not enabled by default”,以及“Why is late loading dangerous?”一节。 ↩︎ ↩︎

  16. Debian Wiki — Microcode — CPU 厂商提供的“opaque”更新数据“is non-free, and its contents are unknown to Debian”。 ↩︎

  17. Proxmox pve-manager — pve8to9.pm — check_cpu_microcode_package 记录这条警告;它先调用的 $get_pkg 查询会为任何没安装的软件包把“unable to determine installed $pkg version.”记为一次失败。 ↩︎

  18. Linux kernel documentation — Old Microcode — “The kernel keeps a table of released microcode. Systems that had microcode older than this at boot will say ‘Vulnerable’.”(内层引号由双引号改为单引号) ↩︎

  19. Intel — Linux Processor Microcode Data Files, release notes — 06-9c-00/01“Celeron N4500/N4505/N5100/N5105”的 JSL 各行,覆盖 20210608 到 20240312 各版本;0x24000026 读自 Debian 软件包中 06-9c-00 的文件头。 ↩︎

  20. AMD security bulletin AMD-SB-7055 — Zen 5 处理器上的 RDSEED 问题。 ↩︎

  21. Proxmox VE Roadmap — 9.1 known issues, AMD Zen5 CPU issue with RDSEED — 客户机启动失败、修复后的软件包版本,以及在没有 Entrysign BIOS 修复的主板上出现的 No sha256 digest 消息。 ↩︎ ↩︎

  22. Proxmox VE wiki — Upgrade from 8 to 9 — apt modernize-sources 转换为 deb822,并把旧文件加上 .bak 后缀保留。 ↩︎

  23. Debian packages — intel-microcode in trixie — stable 和 security 的版本,并在主机上用 apt-cache policy 交叉核对过。 ↩︎

  24. Debian sources — intel-microcode.postinst — dpkg-trigger --no-await update-initramfs,然后是“microcode will be updated at next boot”;amd64-microcode 也一样。 ↩︎

  25. Debian manual — update-initramfs(8) — 关于 -k:“The default is the latest kernel version”,而“all”作用于“on all installed kernel versions that already have an initramfs (with -d or -u)”。 ↩︎

  26. Linux kernel source — arch/x86/kernel/cpu/microcode/core.c — 打印“Current revision: 0x%08x”和“Updated early from: 0x%08x”。 ↩︎

  27. Proxmox VE admin guide — High Availability, maintenance mode — HA 服务会被迁走,并在“automatically once the maintenance mode is disabled and the node is back online”时迁回。 ↩︎

  28. Ceph documentation — Configuring Monitor/OSD Interaction — mon_osd_down_out_interval,“The number of seconds Ceph waits before marking a Ceph OSD Daemon down and out”,默认 10 分钟。 ↩︎

  29. Linux kernel documentation — kernel parameters — dis_ucode_ldr:“Disable the microcode loader.” ↩︎