两个你设过一次就忘了的设置
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 类型的客户机会启动不了。
本文接下来逐个讲:它是什么,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_time | Hyper-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_evmcs | enlightened 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。
然后按顺序过关卡。
读规则是一回事,跑一遍更好。
所以我在两台 9.2 主机上加载了已安装的 CPUConfig.pm,AMD 那几行用我的 AMD Ryzen 节点,Intel 那几行用一台 Intel Celeron N5100 节点,然后用每种组合去调用这个函数:
| OS 类型 | 固件 | 机器版本 | 主机 | 加上的 enlightenments |
|---|---|---|---|---|
l26 或 other | 任意 | 任意 | 任意 | 无 |
wxp (5) | SeaBIOS | 11.0 | 任意 | 无 |
w2k8 (Vista/2008) | SeaBIOS | 11.0 | 任意 | spinlocks、vapic、time、reset、vpindex、runtime |
win7 | SeaBIOS | 11.0 | 任意 | 上面六项,再加 relaxed、synic、stimer、ipi |
win7 | OVMF | 11.0 | 任意 | 无 |
win10 | OVMF | 11.0+pve2 | Intel | 完整的十项,没有 evmcs |
win11 | OVMF | 11.0+pve1 | Intel | 完整的十项,没有 evmcs |
win11 | OVMF | 11.0+pve2 | Intel | 完整的十项,再加 evmcs |
win11 | SeaBIOS | 11.0+pve2 | AMD | 完整的十项,没有 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-server | 9.2.0 | 2026年7月15日 | hv-evmcs 默认值和机器版本 11.0+pve2 |
pve-qemu-kvm | 11.0.2-1 | 2026年7月1日 | QEMU 11.0.2,当天的最新版 |
pve-qemu-kvm,最低要求 | 11.0.0-1 | 2026年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:
| QEMU | Proxmox 构建 | 为客户机修了什么 |
|---|---|---|
| 10.0 | 10.0.2-1,2025年6月17日 | “PCI Label Id” 缺陷,英文版无害,但可能让本地化安装卡死 |
| 10.1 | 10.1.2-3,2025年11月17日 | 一个弄坏鼠标指针的 VNC 剪贴板回归 |
| 10.1 | 10.1.2-5,2025年12月22日 | 带 TPM 磁盘的虚拟机备份卡住,一个 io_uring 修复 |
| 11.0 | 11.0.0-1,2026年5月5日 | swtpm 存放 TPM 状态所用的 FUSE 导出中的一个回归 |
| 11.0 | 11.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/2025 | q35 | OVMF |
| 10/2016/2019 以及更老的每一种 Microsoft Windows 类型 | i440fx | SeaBIOS |
| Other、Linux | i440fx | SeaBIOS |
在完成向导之前,到 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 加载 | Debian | intel-microcode 3.20251111.1~deb13u1,amd64-microcode 3.20250311.1 |
| Proxmox VE 软件源 | 启动早期,从 initramfs 加载 | Proxmox | amd64-microcode 3.20251202.1~bpo13+1,没有 Intel 软件包 |
BIOS 这条路是 Proxmox 推荐的13。 早期加载这条路是安全网,用在主板厂商已经不再发布 BIOS 更新的时候,而对任何用了几年的设备,他们通常已经不发了。
第三行让我意外。
Proxmox 在自己的软件源里带了一个比 Debian trixie 更新的 amd64-microcode14,pin 优先级相同,所以 apt 会选 Proxmox 的那个。
在配置了 Proxmox 软件源的 AMD 主机上,你最终运行的就是这个版本,而且下一节会说明,要紧的正是这个版本。
早期加载是本文要配置的东西。 微码被放进 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 发布 | 在这台主机上 |
|---|---|---|
0x1d | microcode-20210608 | 今天主板固件加载的版本 |
0x2400001f | microcode-20220207 | |
0x24000023 | microcode-20220510 | 比这块主板的 BIOS 构建早六个月发布 |
0x24000024 | microcode-20230214 | |
0x24000026 | microcode-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。
在集群上滚动推进
软件源的修改和安装可以在所有节点上同时进行。重启之前什么都不会变。 重启则一次一个节点,每个节点恢复健康之后,下一个才能停机。
| 步骤 | 命令 | 完成标志 |
|---|---|---|
| 集群健康 | pvecm status、ceph -s | 有法定人数,HEALTH_OK |
| 清空节点 | ha-manager crm-command node-maintenance enable <node>,非 HA 客户机手动迁移 | 节点上没有客户机了 |
| 可选,Ceph | ceph osd set noout | ceph -s 里显示该标志 |
| 重启,验证 | dmesg | grep -i microcode | 显示新的修订号 |
| Ceph 已恢复 | ceph -s | 所有 OSD 都是 up 和 in,HEALTH_OK |
| 释放 | node-maintenance disable <node>、ceph osd unset noout | HA 客户机迁回 |
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 给了你检查的工具,因此,你以为的和实际在跑的之间的那个缺口,得由你来补上,不是他们。
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”。 ↩︎ ↩︎ ↩︎Proxmox qemu-server —
CPUConfig.pm—get_hyperv_enlightenments:OVMF 和版本关卡、机器版本限制,以及hv_evmcs的GenuineIntel检查。本文在 qemu-server 9.2.11 上实际运行。 ↩︎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默认值。 ↩︎ ↩︎ ↩︎ ↩︎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”。 ↩︎ ↩︎ ↩︎ ↩︎Proxmox qemu-server —
Machine.pm— 当机器版本对应的 QEMU major.minor 比已安装的二进制更新时,can_run_pve_machine_version返回 false;+pveN修订号也列在同一个文件里。 ↩︎Proxmox qemu-server 9.2.0 —
debian/control— 在 2026年7月15日 的“bump version to 9.2.0”提交中,运行时依赖是pve-qemu-kvm (>= 7.1~)。 ↩︎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” ↩︎ ↩︎
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”。 ↩︎
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”。 ↩︎ ↩︎
Proxmox VE wiki — Qemu-guest-agent — 对这类客户机:“First you have to download the virtio-win driver iso”。 ↩︎
Proxmox qemu-server —
CPUFlags.pm— 单台虚拟机的标志列表,含上文引用的hv-tlbflush和hv-evmcs描述。 ↩︎Proxmox pve-manager —
OSDefaults.js—win11条目设置machine: 'q35'和bios: 'ovmf';其他 Microsoft Windows 条目继承generic,而它不设机器类型。 ↩︎Proxmox VE admin guide — CPU Microcode Updates — 操作系统早期更新、推荐的 BIOS/UEFI 途径、arm64 没有操作系统层面的软件包、
dis_ucode_ldr步骤,以及降级而不是 purge。 ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎Proxmox VE
pve-no-subscriptionrepository for trixie — 带有amd64-microcode3.20251202.1~bpo13+1,没有intel-microcode,2026年10月27日 读取。 ↩︎Linux kernel documentation — The Linux Microcode Loader — “Since kernel 5.19, late loading is not enabled by default”,以及“Why is late loading dangerous?”一节。 ↩︎ ↩︎
Debian Wiki — Microcode — CPU 厂商提供的“opaque”更新数据“is non-free, and its contents are unknown to Debian”。 ↩︎
Proxmox pve-manager —
pve8to9.pm—check_cpu_microcode_package记录这条警告;它先调用的$get_pkg查询会为任何没安装的软件包把“unable to determine installed $pkg version.”记为一次失败。 ↩︎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’.”(内层引号由双引号改为单引号) ↩︎
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的文件头。 ↩︎AMD security bulletin AMD-SB-7055 — Zen 5 处理器上的 RDSEED 问题。 ↩︎
Proxmox VE Roadmap — 9.1 known issues, AMD Zen5 CPU issue with RDSEED — 客户机启动失败、修复后的软件包版本,以及在没有 Entrysign BIOS 修复的主板上出现的
No sha256 digest消息。 ↩︎ ↩︎Proxmox VE wiki — Upgrade from 8 to 9 —
apt modernize-sources转换为 deb822,并把旧文件加上.bak后缀保留。 ↩︎Debian packages —
intel-microcodein trixie — stable 和 security 的版本,并在主机上用apt-cache policy交叉核对过。 ↩︎Debian sources —
intel-microcode.postinst—dpkg-trigger --no-await update-initramfs,然后是“microcode will be updated at next boot”;amd64-microcode也一样。 ↩︎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)”。 ↩︎Linux kernel source —
arch/x86/kernel/cpu/microcode/core.c— 打印“Current revision: 0x%08x”和“Updated early from: 0x%08x”。 ↩︎Proxmox VE admin guide — High Availability, maintenance mode — HA 服务会被迁走,并在“automatically once the maintenance mode is disabled and the node is back online”时迁回。 ↩︎
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 分钟。 ↩︎Linux kernel documentation — kernel parameters —
dis_ucode_ldr:“Disable the microcode loader.” ↩︎