Due impostazioni che hai scelto una volta e poi dimenticato

Proxmox VE 9 fa due cose utili per te senza che tu lo chieda. Dà a un guest Fisher-Price OS (Windows) le funzioni paravirtuali di cui ha bisogno per girare come si deve su KVM, e carica microcode della CPU aggiornato all’avvio.

Tutte e due sono automatiche. Tutte e due dipendono anche da una decisione che hai preso una volta, magari anni fa, e che da allora non hai più guardato.

La prima dipende dal tipo di OS che hai scelto quando la VM è stata creata. Scegli una delle voci Microsoft Windows e Proxmox aggiunge gli enlightenment Hyper-V a ogni avvio. Lasciala su Other, cosa facile da fare quando importi un disco o cloni qualcosa di vecchio, e il guest non ne riceve nessuno. Si avvia, gira, è più lento, e niente te lo dice.

La seconda dipende da come l’host è arrivato alla versione 9. L’installer della 9.0 abilita il componente firmware di Debian e installa il pacchetto di microcode per la tua CPU. Un host aggiornato dalla 8.x tiene i repository che aveva, e sulla maggior parte di essi questo significa nessun pacchetto di microcode. Su un host AMD Zen 5 con kernel 6.17.9 o più recente non è una lacuna teorica: i guest che usano i tipi di CPU EPYC smettono di avviarsi.

Due default, due scelte dimenticateUna VM: decide il tipo di OSTipo di OS, scelto una voltaMicrosoft WindowsOther o Linuxflag hv_ aggiuntia ogni avvionessunoe nessun avvisoUn host: decide come è arrivato alla 9host Proxmox VE 9installer 9.xaggiornato dalla 8.xpacchetto microcodeinstallatonessun pacchettopve8to9 avvisa soltanto
Entrambi i default dipendono da una scelta fatta molto prima che qualcosa vada storto. In ciascun caso il percorso di destra è quello di cui niente ti avverte.

Il resto di questo post li prende uno alla volta: cos’è, la regola esatta che applica Proxmox, come attivarlo dove manca e come dimostrare che ha preso. Le regole vengono dal codice di qemu-server e pve-manager su un host 9.2 in produzione, non dalla memoria, perché due di esse non sono quelle che la maggior parte della gente immaginerebbe.

Cos’è davvero un enlightenment

Un sistema operativo guest scritto per hardware reale spende un sacco di fatica in cose che dentro una VM sono uno spreco. Programma i timer attraverso chip emulati, gira a vuoto su lock tenuti da una vCPU che non è nemmeno schedulata, e fa scattare i watchdog quando l’host gli ruba qualche millisecondo.

La paravirtualizzazione risolve il problema facendo sapere al guest che è un guest e lasciandolo parlare direttamente con l’hypervisor. Linux lo fa con le interfacce proprie di KVM. Il Fisher-Price OS (Windows) parla un solo dialetto paravirtuale, quello di Hyper-V, quindi KVM implementa quel dialetto e dice al guest che sta girando su un hypervisor compatibile con Hyper-V. Ogni pezzo di quel dialetto si chiama enlightenment.

Niente di tutto ciò è attivo se qualcosa non lo chiede. La documentazione di QEMU è chiara: «No Hyper-V enlightenments are enabled by default by either KVM or QEMU»1. Su Proxmox, chi lo chiede è qemu-server, e lo chiede solo quando il tipo di OS è una delle voci Microsoft Windows.

Puoi vedere la differenza su qualsiasi host. Questa è una VM Linux sul mio nodo 9.2, ostype: l26, tipo di CPU host:

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

Due flag KVM per la gestione paravirtuale di interrupt e spinlock propria di Linux, e nessun flag hv_. Giusto per Linux. Sbagliato per un guest che capisce solo Hyper-V.

Cosa fa ogni enlightenment, dalle descrizioni di QEMU1:

FlagCosa riceve il guestCosa risparmia
hv_timeclock di riferimento Hyper-V e pagina TSCletture del timestamp senza exit
hv_relaxedl’indicazione di disattivare i timeout del watchdogfalsi timeout quando una vCPU viene deschedulata
hv_vapicpagina VP assist per l’APICend-of-interrupt senza exit
hv_spinlocksspinlock paravirtuali, numero di tentativi prima di avvisare l’hostgirare a vuoto su un lock il cui detentore non sta girando
hv_vpindexil proprio indice di processore virtualeprerequisito per i quattro successivi
hv_runtimequanto ha girato davvero ogni vCPUuna visione onesta del tempo rubato
hv_synic, hv_stimercontroller di interrupt e timer sinteticihardware timer emulato
hv_ipiinvio di IPI a molte vCPU con una sola hypercallun exit APIC per ogni CPU destinataria
hv_resetreset attraverso l’hypervisor
hv_evmcsVMCS enlightened, solo Intelvirtualizzazione annidata più veloce
hv_tlbflushshoot-down paravirtuale del TLBattendere vCPU che non stanno girando

Il tipo di OS è l’interruttore

La regola vive in una sola funzione, get_hyperv_enlightenments in CPUConfig.pm di qemu-server2. Prima il tipo di OS viene trasformato in un numero di versione: win11 diventa 11, win10 diventa 10, w2k8 e wvista diventano entrambi 6, e i tipi XP e 2003 diventano 5. Linux, Other e tutto il resto diventano 0.

Poi i cancelli vengono applicati in ordine.

Quali flag hv_ aggiunge qemu-server, cancello per cancelloDal tipo di OS ai flag hv_, nell'ordine in cui gira il codiceVersione del tipo di OS sotto 6?sìstop: niente aggiuntoFirmware OVMF e versione sotto 8?sìstop: niente aggiuntomacchina 2.3, poi 2.6 o successivaaggiungespinlocks vapic time reset vpindex runtimeversione 7 o superioreaggiungerelaxed synic stimer ipihost Intel, versione 11, macchina 11.0+pve2aggiungeevmcs
L’ordine in cui qemu-server li applica. Una versione sotto 6 si ferma al primo cancello, e un guest UEFI più vecchio del tipo 8.x si ferma al secondo, senza che venga aggiunto niente.

Leggere una regola è una cosa. Eseguirla è meglio. Così ho caricato il CPUConfig.pm installato su due host 9.2, il mio nodo AMD Ryzen per le righe AMD e un nodo Intel Celeron N5100 per quelle Intel, e ho chiamato quella funzione con ogni combinazione:

Tipo di OSFirmwareVersione macchinaHostEnlightenment aggiunti
l26 o otherqualsiasiqualsiasiqualsiasinessuno
wxp (5)SeaBIOS11.0qualsiasinessuno
w2k8 (Vista/2008)SeaBIOS11.0qualsiasispinlocks, vapic, time, reset, vpindex, runtime
win7SeaBIOS11.0qualsiasii sei sopra più relaxed, synic, stimer, ipi
win7OVMF11.0qualsiasinessuno
win10OVMF11.0+pve2Inteltutti e dieci, senza evmcs
win11OVMF11.0+pve1Inteltutti e dieci, senza evmcs
win11OVMF11.0+pve2Inteltutti e dieci più evmcs
win11SeaBIOS11.0+pve2AMDtutti e dieci, senza evmcs

Tre cose lì dentro vale la pena saperle prima di avvicinarti alla GUI.

Un guest UEFI con un tipo di OS più vecchio di 8.x non riceve niente. Il codice esce subito quando il firmware è OVMF e la versione è sotto 8. Un guest 7/2008r2 che hai spostato su UEFI ha perso in silenzio tutti gli enlightenment che aveva.

hv_evmcs vuole tre cose insieme. Un host Intel, il tipo di OS 11/2022/2025, e la versione macchina 11.0+pve2 o successiva. Un guest 10/2016/2019 non lo riceve mai di default, per quanto nuova sia la sua versione macchina.

Il vendor dell’host viene letto quando la VM si avvia. Il controllo chiama read_cpuinfo sul nodo che fa l’avvio, non su quello dove la VM è stata creata. In un cluster misto Intel e AMD la stessa VM riceve hv_evmcs su un nodo e non sull’altro, deciso da capo a ogni avvio a freddo.

I cancelli più vecchi sulla versione macchina (2.3, 2.6, 2.12, 3.1) contano solo per VM fissate su macchine del lontano passato di QEMU. Tutto ciò che creeresti oggi li supera.

Quindi scegli il tipo di OS più vicino al guest, non il più nuovo della lista. Un guest 10/2016/2019 va su 10/2016/2019. La documentazione di Proxmox dà un secondo motivo per cui il tipo conta oltre a questi flag: imposta anche cose come se l’RTC virtuale gira sull’ora locale3.

Perché le tue VM più vecchie perdono il fix di luglio

hv_evmcs di default è una novità. È arrivato in qemu-server 9.2.0 il 15 luglio 2026, per «mitigate guest freezes and 100% CPU usage seen on certain Intel CPUs with Windows guests that use Virtualization-Based Security (VBS)»4, ed è legato alla versione macchina 11.0+pve2.

Quel legame è la fregatura, perché Proxmox fissa la versione macchina di ogni VM con un tipo di OS Microsoft Windows nel momento in cui viene creata. La documentazione ne dà il motivo: «Windows is sensitive to changes in the virtual hardware - even between cold boots»3. È una decisione sensata. Significa anche che una VM creata a giugno 2026 sta su 11.0+pve1 o più vecchia, e ci resterà finché qualcuno non la sposta.

Qualcuno la sposterà per te? No. Il nuovo default si applica alle VM nuove e a quelle che aggiorni di proposito, e a nient’altro.

Se hai host Intel con guest 11/2022/2025 con VBS attivo, e qualcuno di questi si è bloccato al 100% di CPU, questa è la prima cosa da controllare:

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

Un ostype: win11 con una riga machine: sotto pc-q35-11.0+pve2 va portato su per ricevere il fix. Spostarlo cambia l’hardware virtuale che il guest vede, che è proprio ciò da cui il pinning protegge. Quindi fallo in una finestra di manutenzione, dopo aver fatto un backup o uno snapshot, da Hardware → Machine → Edit, spunta Advanced, e scegli la versione.

Se invece la riga inizia con pc-i440fx-, la versione è il problema minore: quel guest non dovrebbe stare su i440fx, per i motivi in Usa sempre Q35, non i440fx, e Impostarlo, e dimostrare che ha preso qui sotto se ne occupa.

Due default collegati sono arrivati negli stessi mesi e vale la pena conoscerli mentre ci sei. qemu-server 9.1.12 ha disattivato i flag cet-ibt e cet-ss per il tipo 11/2022/2025, perché con QEMU 11.0 e i kernel 7.x che li esponevano, i guest con VBS non si avviavano4. E la 9.1.14 ha esposto la proprietà level della CPU, che la documentazione descrive come «a known workaround for Hyper-V boot failures of Windows guests on recent Intel hosts when the CPU type is host or max»3.

Il lato QEMU, rilascio per rilascio

qemu-server costruisce la riga di comando. pve-qemu-kvm è il QEMU che la esegue, e il fix di luglio ha bisogno di tutti e due.

La versione macchina 11.0+pve2 si può scegliere solo quando è installato un binario QEMU 11.0, perché qemu-server rifiuta qualsiasi versione macchina più nuova del QEMU che trova sull’host5. Il +pve2 è il contatore di revisione di qemu-server, non di QEMU, quindi qualsiasi build 11.0 lo soddisfa. Il giorno in cui è uscita la 9.2.0, la coppia era questa:

PacchettoVersioneRilasciatoCosa porta
qemu-server9.2.015 luglio 2026il default hv-evmcs e la macchina 11.0+pve2
pve-qemu-kvm11.0.2-11º luglio 2026QEMU 11.0.2, l’attuale quel giorno
pve-qemu-kvm, minimo11.0.0-15 maggio 2026la prima build di QEMU 11.0

apt si assicurerà che tu li abbia entrambi? No. qemu-server 9.2.0 non dichiara niente di più forte di pve-qemu-kvm (>= 7.1~)6, quindi un nodo con QEMU fermo alla 10.x prende il nuovo qemu-server senza fiatare e poi non può offrire la versione macchina da cui dipende il fix. Controllali entrambi, su ogni nodo. Questo è il mio host 9.2 oggi, ben oltre tutti e due:

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

Ogni rilascio di QEMU da quando Proxmox VE 9.0 è uscito con la 10.0.27 ha portato correzioni proprie per i guest Fisher-Price OS (Windows). Queste sono quelle che toccano il guest, dal changelog del pacchetto Proxmox8 e dai changelog upstream di QEMU9:

QEMUBuild ProxmoxCosa ha corretto per il guest
10.010.0.2-1, 17 giugno 2025il bug del «PCI Label Id», innocuo in inglese ma capace di bloccare le installazioni localizzate
10.110.1.2-3, 17 novembre 2025una regressione degli appunti VNC che rompeva il puntatore del mouse
10.110.1.2-5, 22 dicembre 2025backup di una VM con disco TPM che si bloccavano, un fix di io_uring
11.011.0.0-1, 5 maggio 2026una regressione nell’export FUSE che swtpm usa per lo stato del TPM
11.011.0.2-1, 1º luglio 2026enlightenment Hyper-V riconosciuti come flag CPUID, così un modello di CPU personalizzato può portarli

QEMU 11.0 ha anche rotto qualcosa: ha cominciato a esporre cet-ibt e cet-ss, ed è questo che ha impedito l’avvio ai guest con VBS e ha spinto qemu-server 9.1.12 a disattivarli, come visto sopra.

Le correzioni al guest agent negli stessi rilasci sono un’altra faccenda. QEMU 10.1, 10.2 e 11.0 hanno corretto ciascuno parti della gestione VSS e del freeze del filesystem del guest agent, compreso l’«Access denied Event ID 8194» che la 11.0 ha curato9. Niente di questo arriva con pve-qemu-kvm. L’agent per quel guest viene distribuito sulla ISO dei driver virtio-win10, quindi cambia solo quando aggiorni l’agent dentro la VM.

I due flag che puoi impostare a mano

Proxmox non ti lascia aggiungere flag di CPU arbitrari a una VM. Hardware → Processors → Edit, spunta Advanced, e Extra CPU Flags offre una lista fissa, definita in CPUFlags.pm11. Due voci di quella lista sono enlightenment, e sono le due che Proxmox non imposta di default, o non impostava fino a luglio.

FlagLa descrizione di ProxmoxQuando impostarlo
hv-tlbflush«Improve performance in overcommitted Windows guests. May lead to guest bluescreens on old CPUs.»Facoltativo. Prova prima su una VM e tienila d’occhio.
hv-evmcs«Improve performance for nested virtualization. Only supported on Intel CPUs.»Hyper-V annidato, WSL2 o VBS dentro il guest, su Intel. Già attivo per 11/2022/2025 su 11.0+pve2.

Sono stati resi entrambi opzionali in qemu-server 6.0-6 il 23 luglio 2019, descritti nel changelog come «sometimes problematic»4. hv-tlbflush è rimasto così per sette anni. È un indizio onesto di quanti test vuole prima che tu lo distribuisca su un cluster.

La nota di QEMU stesso su hv-evmcs è che è solo Intel, e che «some virtualization features (e.g. Posted Interrupts) are disabled when hv-evmcs is enabled»1. Attivarlo a mano su un guest che non fa virtualizzazione annidata non ti compra niente e ti costa quello.

Impostarlo, e dimostrare che ha preso

Per una VM nuova: Create VM → OS, imposta Type su Microsoft Windows e Version sulla corrispondenza più vicina.

Per una esistente: Options → OS Type → Edit, scegli la versione, OK. Proxmox fissa la versione macchina quando passi una VM esistente a un tipo Microsoft Windows, come fa alla creazione4, quindi aspettati che cambi anche la riga machine: nella configurazione.

E mettila su q35. Un guest enlightened non ha niente da fare su pc-i440fx. È il chipset senza bus PCIe, e i motivi vanno ben oltre il passthrough; sono tutti in Usa sempre Q35, non i440fx.

Il wizard non ti fermerà, e per la maggior parte dei tipi Microsoft Windows ti ci metterà lui. La documentazione di Proxmox chiama l’Intel 440FX «the default»3, e i default per OS della GUI lo sovrascrivono per una sola voce: 11/2022/2025 riceve machine: 'q35' e bios: 'ovmf'12. Ogni altro tipo Microsoft Windows eredita i default generici, che non impostano nessuna macchina. Così un guest 10/2016/2019 creato cliccando Next finisce su i440fx, enlightened e sul chipset sbagliato allo stesso tempo.

Tipo di OS scelto nel wizardMacchina che riceveFirmware che riceve
11/2022/2025q35OVMF
10/2016/2019 e ogni tipo Microsoft Windows più vecchioi440fxSeaBIOS
Other, Linuxi440fxSeaBIOS

Cambialo nella scheda System prima di finire il wizard. Per una VM che esiste già, cambiare chipset è un cambiamento all’hardware virtuale più grosso di un aggiornamento della versione macchina, quindi valgono le stesse regole di finestra di manutenzione e backup, e il post su q35 spiega cosa ne fa il guest.

Poi fermala come si deve. Gli enlightenment sono argomenti sulla riga di comando di QEMU, e quella riga viene costruita solo quando parte il processo QEMU. Un riavvio da dentro il guest tiene lo stesso processo, quindi tiene i vecchi flag. Spegni, aspetta stopped, poi Start.

Dimostralo dall’host, perché è lì che sta la risposta:

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

Questo stampa ciò che qemu-server passerà a QEMU al prossimo avvio. Un guest 11/2022/2025 su 11.0+pve2 su Intel dovrebbe elencarne undici: hv_evmcs, hv_ipi, hv_relaxed, hv_reset, hv_runtime, hv_spinlocks=0x1fff, hv_stimer, hv_synic, hv_time, hv_vapic e hv_vpindex. Lo stesso guest su AMD ne elenca dieci. Un risultato vuoto significa che il tipo di OS non è un Microsoft Windows, oppure che è un tipo precedente a 8.x su UEFI.

Se un guest non si avvia dopo la modifica, rimetti il tipo di OS su Other per un avvio, per includere o escludere gli enlightenment come causa. Gira senza. Gira solo peggio.

Microcode: cosa corregge e da dove arriva

Il secondo default sta sotto l’hypervisor, non sopra.

Il microcode della CPU è il firmware del vendor per il processore stesso. Gli aggiornamenti correggono vulnerabilità di sicurezza e bug gravi della CPU, e la guida di amministrazione di Proxmox fa il punto che conta per chiunque si preoccupi del costo in velocità: «a patched microcode is usually still more performant than an unpatched microcode where the kernel itself has to do mitigations»13.

Ci sono tre posti da cui può arrivare, e sono indipendenti.

FonteApplicatoChi lo distribuisceSul mio host 9.2 oggi
Aggiornamento BIOS/UEFI della schedaa ogni accensione, persistenteil vendor della scheda o del serverquello che portava l’ultimo BIOS
Debian non-free-firmwareall’inizio del boot, dall’initramfsDebianintel-microcode 3.20251111.1~deb13u1, amd64-microcode 3.20250311.1
Repository di Proxmox VEall’inizio del boot, dall’initramfsProxmoxamd64-microcode 3.20251202.1~bpo13+1, nessun pacchetto Intel

La strada del BIOS è quella che Proxmox chiama raccomandata13. La strada del caricamento precoce è la rete di sicurezza per quando il vendor della scheda ha smesso di distribuire aggiornamenti del BIOS, cosa che su qualsiasi macchina di qualche anno di solito ha già fatto.

Quella terza riga mi ha sorpreso. Proxmox porta nel proprio repository un amd64-microcode più nuovo di quello che Debian ha in trixie14, con la stessa priorità di pin, quindi apt sceglie quello di Proxmox. Su un host AMD con il repository di Proxmox configurato, è quella la versione che finirai per eseguire, e come mostra la sezione successiva, è la versione che conta.

Dove viene applicato il microcode durante un bootUn boot, da sinistra a destraAccensionemicrocode del BIOSBootloadercarica l'initramfsAvvio kernelagg. precoceHost attivopartono i guestCar. tardivobloccatopersistente,vendor schedadall'initramfs,Debian o Proxmoxblacklist in/etc/modprobe.d
Il caricamento precoce avviene prima che il kernel abbia avviato qualsiasi altra cosa. Il caricamento tardivo su un sistema in funzione è la strada che Debian blocca, e resta bloccata.

Il caricamento precoce è ciò che questo post configura. Il microcode va nell’initramfs e il kernel lo applica all’inizio del boot, prima che giri qualsiasi altra cosa.

Il caricamento tardivo lo applica a un sistema in funzione. La documentazione del kernel ha una sezione intitolata «Why is late loading dangerous?» e dalla 5.19 non è abilitato di default15. Anche Debian lo blocca. Questo è il file sul mio host, alla lettera:

# 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

Lascialo stare. L’host qui sopra ce l’ha al suo posto e mostra comunque un aggiornamento precoce riuscito, quindi non è d’intralcio a niente.

Entrambe le strade richiedono un riavvio. Non c’è modo di evitarlo.

Ed è solo x86. La guida di Proxmox dice chiaramente che «There is no equivalent operating-system-level microcode package for arm64»13.

Perché un host aggiornato non ne ha

«Non-free» in non-free-firmware riguarda la licenza, non i soldi né un abbonamento Proxmox. Il wiki di Debian lo spiega: la parte del kernel è software libero, ma i dati di aggiornamento del vendor sono «opaque», «and its contents are unknown to Debian»16. Ecco perché vive in un componente a sé, e perché un sistema Debian non lo riceve se il componente non è attivato.

L’installer di Proxmox VE 9.0 lo attiva. Le note di rilascio dicono che la ISO «Install the microcode package matching the current platform», e che «installations now have the non-free-firmware repository enabled»7. Un aggiornamento non fa né l’una né l’altra cosa, perché tiene le righe di repository che avevi sulla 8.x.

Installazione 9.x pulitaAggiornato dalla 8.x
non-free-firmwareabilitato dall’installerquello che aveva la 8.x, spesso assente
Pacchetto di microcodeinstallato per la CPU rilevatanessuno, finché non aggiungi il componente
Cosa te lo dicenon serve nientepve8to9, come FAIL e WARN, e solo se lo lanci
Aggiornamenti successiviapt full-upgrade e un riavviolo stesso, una volta installato il pacchetto

Il checker lo segnala, e più forte di quanto mi aspettassi. Eccolo sul mio nodo Intel, che è arrivato dalla 8.x:

# 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

Il FAIL è un effetto collaterale: la ricerca della versione registra un fallimento per qualsiasi pacchetto non installato, prima che il controllo del microcode arrivi al proprio avviso17. In ogni caso, pve8to9 è un checker, non un cancello. Non esegue l’aggiornamento e non può fermarne uno, quindi l’aggiornamento gli passa dritto accanto.

Conta nella pratica? Ecco due casi in cui sì, e il primo è il mio.

Quel nodo Intel è un Celeron N5100. La sua lista di sorgenti conteneva già non-free-firmware, quindi il pacchetto era a un comando di distanza, e fino al 27 ottobre 2026 nessuno l’aveva lanciato. Il kernel se n’era accorto anche se nessun altro lo aveva fatto:

# 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

Il kernel tiene «a table of released microcode», e una CPU che si è avviata con qualcosa di più vecchio «will say ‘Vulnerable’»18. Quanto è vecchio, vecchio? Le note di rilascio di Intel rispondono per questo chip19:

RevisioneRilascio IntelSu questo host
0x1dmicrocode-20210608ciò che carica oggi il firmware della scheda
0x2400001fmicrocode-20220207
0x24000023microcode-20220510uscito sei mesi prima che venisse compilato il BIOS di questa scheda
0x24000024microcode-20230214
0x24000026microcode-20240312in intel-microcode 3.20251111.1~deb13u1 di Debian

Il BIOS è la versione 5.19, datata 8 novembre 2022, e carica ancora il primo microcode che Intel abbia mai rilasciato per quel componente, con due più nuovi già usciti quando è stato compilato. È esattamente il caso per cui esiste la strada del caricamento precoce: quattro aggiornamenti fermi in un pacchetto che l’host vedeva già. L’ho installato mentre scrivevo questo, e cosa ha fatto è sotto Attivarlo, perché mostra un tranello.

Il secondo caso è di AMD. I componenti Zen 5 hanno un bug nell’istruzione RDSEED20. Le note di rilascio della 9.1 di Proxmox registrano cosa succede dopo: i kernel dalla 6.17.9 in poi, «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. Il fix è amd64-microcode 3.20251202.1~bpo13+1 o più recente, che è la versione del repository di Proxmox e non di Debian.

C’è un secondo tranello dentro quello. Sulle schede Zen 5 il cui BIOS precede il fix per la vulnerabilità Entrysign di AMD, il kernel rifiuta il nuovo microcode e registra No sha256 digest for patch ID, e il consiglio di Proxmox è un aggiornamento del BIOS21. Quindi su quell’hardware la strada del sistema operativo funziona solo dopo che il vendor della scheda ha fatto la sua parte.

Attivarlo

Prima annota dove sei. Sull’host, come 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

Se dpkg mostra già il pacchetto giusto come ii, l’host è a posto e puoi saltare al controllo del risultato.

Abilita il componente. L’apt di trixie preferisce il formato deb822 .sources, e la guida di aggiornamento di Proxmox indica apt modernize-sources per convertire i vecchi file a una riga, tenendo gli originali come .bak22. Poi aggiungi non-free-firmware alla riga Components: sia della stanza principale sia di quella di sicurezza in /etc/apt/sources.list.d/debian.sources. Questo è il file sul mio host, che viene dall’installer:

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

Entrambe le stanze, perché Debian distribuisce il microcode a stable per tutte e due le strade. L’archivio di sicurezza ha intel-microcode 3.20250812.1~deb13u1 mentre l’archivio principale è passato a 3.20251111.1~deb13u123, e tu vuoi il più nuovo dei due.

Installa quello che corrisponde alla CPU.

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

Solo quello del tuo vendor. Da lì in poi il nuovo microcode arriva con i normali apt full-upgrade, e ogni nuova versione richiede un riavvio come la prima.

Installarlo ricostruisce l’initramfs, perché è lì che il microcode precoce deve stare. Il kernel lo legge da un archivio non compresso all’inizio dell’initrd, come kernel/x86/microcode/GenuineIntel.bin o AuthenticAMD.bin15, e lo script di installazione del pacchetto fa scattare il trigger dell’initramfs per metterlo lì24. Questo è il mio nodo Intel che prende il pacchetto mentre scrivevo questo post:

# 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 è l’hook di Proxmox. Su un host le cui partizioni EFI sono gestite da proxmox-boot-tool copia la nuova immagine; questo non ne ha da sincronizzare.

Ora guarda quale immagine ha generato. Senza un kernel indicato, update-initramfs -u ricostruisce solo la più recente: «The default is the latest kernel version»25. Lo stesso nodo, subito dopo:

# 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

Un’immagine su sette contiene il microcode, e non è quella con cui l’host sta girando.

Prossimo avvioL’initramfs ha il microcodeRevisione su cui finisce la CPU
7.0.14-24, la voce predefinitasì0x24000026 del pacchetto
7.0.14-23, fissata o voce di riservano0x1d del BIOS
qualsiasi più vecchiano0x1d del BIOS

Quindi ricostruisci ogni immagine dopo l’installazione, e di nuovo dopo ogni aggiornamento del microcode, perché ognuno fa scattare la stessa ricostruzione della sola più recente. Poi rilancia il ciclo di sopra per dimostrarlo:

update-initramfs -u -k all

Riavvia e controlla. Questo è il mio host AMD 9.2 dopo che è stato installato il pacchetto del repository di 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 è la riga che lo dimostra. La guida di amministrazione di Proxmox mostra ancora la dicitura più vecchia, microcode updated early to revision13; il kernel attuale stampa le due righe sopra26. Qualunque delle due forme significa che ha funzionato.

L’assenza di quella riga non è di per sé un guasto. Compare solo quando il pacchetto contiene qualcosa di più nuovo sia della revisione integrata nella CPU sia di quella caricata dal BIOS. Un pacchetto copre moltissimi modelli di CPU, e la guida ha ragione a dire che la sua data non ti dice quando il tuo modello ha ricevuto qualcosa l’ultima volta13.

Distribuirlo su un cluster

La modifica dei repository e l’installazione possono andare su tutti i nodi insieme. Non cambia niente fino a un riavvio. I riavvii vanno un nodo alla volta, e ogni nodo è sano prima che il successivo venga spento.

Un riavvio a rotazione per il microcode, un nodo per passataPer nodo, poi il successivoControlloquorum, Ceph OKManutenzioneguest spostatinooutfacoltativoRiavviocontrolla dmesgAttesaOSD up e inRilasciounset, ritornonodo successivo, stessi passi
Un nodo per passata. I due passi Ceph valgono solo per i cluster iperconvergenti, e la coppia noout è facoltativa.
PassoComandoFatto quando
Cluster sanopvecm status, ceph -squorum presente, HEALTH_OK
Svuota il nodoha-manager crm-command node-maintenance enable <node>, migra a mano i guest non HAnessun guest rimasto
Facoltativo, Cephceph osd set nooutflag visibile in ceph -s
Riavvia, verificadmesg | grep -i microcodenuova revisione visibile
Ceph ripresoceph -stutti gli OSD up e in, HEALTH_OK
Rilascianode-maintenance disable <node>, ceph osd unset nooutguest HA tornati indietro

La modalità di manutenzione HA registra da dove veniva ogni guest HA e ce lo riporta quando il nodo esce dalla manutenzione27. I guest non HA sono affar tuo.

Su noout le opinioni divergono, ed entrambe le parti hanno un punto. Ceph segna rapidamente down un OSD che tace, ma lo segna out solo dopo mon_osd_down_out_interval, che di default è dieci minuti28, ed è l’out che fa partire il ribilanciamento. Un riavvio normale torna ben prima. Un server con un POST lungo, un prompt del firmware o un controller RAID lento potrebbe non farcela. Impostare noout impedisce che un riavvio lento si trasformi in un ribilanciamento. Il prezzo è ricordarsi di toglierlo, e un noout dimenticato nasconde un guasto vero più avanti.

Fai tutto il cluster in un’unica finestra. Nodi con revisioni di microcode diverse sono esattamente la situazione in cui un guest con tipo di CPU host, che vede direttamente le funzioni della CPU fisica, può migrare live su un nodo che riporta un insieme diverso.

Quando un aggiornamento del microcode va storto

Raro, ma succede, e la guida di Proxmox lo tratta come si deve13.

SituazioneFai cosìPerché
Sospetti il nuovo microcodeavvia una volta con dis_ucode_ldrdisattiva il loader solo per quell’avvio29
La vecchia revisione va, la nuova noinstalla la versione precedente e bloccalaun purge può lasciare in funzione una revisione del BIOS ancora più vecchia
Qualche settimana dopoapt-mark unhold, poi full-upgradeuna correzione altrove può risolverlo con la stessa versione di microcode

Per l’avvio singolo: menu di GRUB (tieni premuto Shift se è nascosto), E sulla voce Proxmox, aggiungi dis_ucode_ldr alla riga che inizia con linux, poi Ctrl+X. Un host su systemd-boot invece di GRUB è trattato nel capitolo sul bootloader della guida di amministrazione.

Il downgrade, su 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

Su AMD metti amd64-microcode. Downgrade, mai purge.

Un default è una promessa a chi ha preso la strada prevista

Nessuno dei due è un bug. Proxmox ha fatto la cosa sensata entrambe le volte: attivare la funzione dove è sicuro, lasciarla spenta dove potrebbe non esserlo, e fissare l’hardware virtuale su cui il guest è schizzinoso. L’installer è stato corretto, il checker dell’aggiornamento lo segnala, il changelog dice cosa è cambiato e quando. Proxmox ha fatto la sua parte.

Ma un default è una promessa fatta a chi ha fatto le cose nel modo che il vendor si aspettava. Installazione pulita, tipo di OS corretto, VM creata dopo luglio. Chiunque abbia un parco macchine con una storia, cioè chiunque faccia girare qualcosa di serio, sta in parte fuori da quella promessa, e la lacuna non si annuncia. Si presenta come un guest un po’ lento, un blocco VBS che nessuno collega a una versione macchina, o un nodo Zen 5 dove i guest EPYC non partono dopo un aggiornamento del kernel.

Le note di rilascio descrivono cosa riceve una nuova installazione. Non dicono niente di cosa stanno davvero eseguendo i tuoi host, e sono domande diverse. L’unico modo per rispondere alla seconda è andare a guardare: qm showcmd sui guest, dmesg sugli host, la riga della macchina nella configurazione. Niente di tutto ciò richiede più di un minuto per macchina.

Quel minuto è il lavoro. Proxmox ti dà gli strumenti per controllare, e per questo la distanza tra ciò che davi per scontato e ciò che sta girando tocca a te colmarla, non a loro.


  1. QEMU documentation — Hyper-V Enlightenments — «No Hyper-V enlightenments are enabled by default by either KVM or QEMU»; descrizioni per ogni flag; hv-evmcs «The feature is Intel-only» e «some virtualization features (e.g. Posted Interrupts) are disabled when hv-evmcs is enabled». ↩︎ ↩︎ ↩︎

  2. Proxmox qemu-server — CPUConfig.pm — get_hyperv_enlightenments: i cancelli su OVMF e versione, le protezioni sulla versione macchina, e il controllo GenuineIntel per hv_evmcs. Eseguito qui da 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» e «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»; la proprietà level e i default cet-ibt/cet-ss per quei guest. ↩︎ ↩︎ ↩︎ ↩︎

  4. Proxmox qemu-server — Debian changelog — la 9.2.0 (15 luglio 2026) abilita hv-evmcs per i guest 11/2022/2025 su Intel dalla macchina 11.0+pve2; la 9.1.14 espone level; la 9.1.12 disattiva cet-ibt e cet-ss; pinning al passaggio a un tipo di OS Microsoft Windows (gennaio 2025); la 6.0-6 (23 luglio 2019) «Make sometimes problematic ‘hv-tlbflush’ and ‘hv-evmcs’ CPU flags optional». ↩︎ ↩︎ ↩︎ ↩︎

  5. Proxmox qemu-server — Machine.pm — can_run_pve_machine_version restituisce falso quando il major.minor QEMU della macchina è più nuovo del binario installato; le revisioni +pveN sono elencate nello stesso file. ↩︎

  6. Proxmox qemu-server 9.2.0 — debian/control — al commit «bump version to 9.2.0» del 15 luglio 2026, la dipendenza di runtime è 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.»; lo stesso rilascio elenca «QEMU 10.0.2» ↩︎ ↩︎

  8. Proxmox pve-qemu — Debian changelog — 10.0.2-1 (17 giugno 2025) «update QEMU and downstream patches for 10.0.2 release», che porta la correzione upstream della 10.0 qui sotto; 10.1.2-3 «a regression with VNC clipboard breaking mouse pointer in Windows guests»; 10.1.2-5 il fix di io_uring per «backup with TPM disk potentially getting stuck»; 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»; 10.1, 10.2 e 11.0 per le correzioni VSS e freeze del guest agent, compresa «Fix guest-fs-freeze cause “Access denied Event ID 8194” in Event Viewer». ↩︎ ↩︎

  10. Proxmox VE wiki — Qemu-guest-agent — per quel guest, «First you have to download the virtio-win driver iso». ↩︎

  11. Proxmox qemu-server — CPUFlags.pm — la lista dei flag per VM, con le descrizioni di hv-tlbflush e hv-evmcs citate sopra. ↩︎

  12. Proxmox pve-manager — OSDefaults.js — la voce win11 imposta machine: 'q35' e bios: 'ovmf'; le altre voci Microsoft Windows ereditano generic, che non imposta nessuna macchina. ↩︎

  13. Proxmox VE admin guide — CPU Microcode Updates — aggiornamenti precoci dal sistema operativo, la strada BIOS/UEFI come raccomandata, arm64 senza pacchetto per il sistema operativo, la procedura dis_ucode_ldr, e downgrade invece di purge. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  14. Proxmox VE pve-no-subscription repository for trixie — contiene amd64-microcode 3.20251202.1~bpo13+1 e nessun intel-microcode, letto il 27 ottobre 2026. ↩︎

  15. Linux kernel documentation — The Linux Microcode Loader — «Since kernel 5.19, late loading is not enabled by default», e la sezione «Why is late loading dangerous?». ↩︎ ↩︎

  16. Debian Wiki — Microcode — i dati di aggiornamento forniti dal vendor della CPU, «opaque», «is non-free, and its contents are unknown to Debian». ↩︎

  17. Proxmox pve-manager — pve8to9.pm — check_cpu_microcode_package registra l’avviso; la ricerca $get_pkg che chiama prima registra «unable to determine installed $pkg version.» come fallimento per qualsiasi pacchetto non installato. ↩︎

  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’.» (virgolette interne cambiate da doppie a singole) ↩︎

  19. Intel — Linux Processor Microcode Data Files, release notes — le righe JSL per 06-9c-00/01, «Celeron N4500/N4505/N5100/N5105», nei rilasci dal 20210608 al 20240312; 0x24000026 letto dall’intestazione di 06-9c-00 nel pacchetto di Debian. ↩︎

  20. AMD security bulletin AMD-SB-7055 — il problema RDSEED sui processori Zen 5. ↩︎

  21. Proxmox VE Roadmap — 9.1 known issues, AMD Zen5 CPU issue with RDSEED — il fallimento all’avvio dei guest, la versione del pacchetto corretta, e il messaggio No sha256 digest sulle schede senza il fix BIOS per Entrysign. ↩︎ ↩︎

  22. Proxmox VE wiki — Upgrade from 8 to 9 — apt modernize-sources converte in deb822 e tiene i vecchi file con il suffisso .bak. ↩︎

  23. Debian packages — intel-microcode in trixie — le versioni stable e security, verificate con apt-cache policy sull’host. ↩︎

  24. Debian sources — intel-microcode.postinst — dpkg-trigger --no-await update-initramfs, poi «microcode will be updated at next boot»; amd64-microcode fa lo stesso. ↩︎

  25. Debian manual — update-initramfs(8) — per -k, «The default is the latest kernel version», e «all» opera «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 — stampa «Current revision: 0x%08x» e «Updated early from: 0x%08x». ↩︎

  27. Proxmox VE admin guide — High Availability, maintenance mode — i servizi HA vengono spostati altrove, e riportati indietro «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», default 10 minuti. ↩︎

  29. Linux kernel documentation — kernel parameters — dis_ucode_ldr: «Disable the microcode loader.» ↩︎