Duas definições que fizeste uma vez e esqueceste

O Proxmox VE 9 faz duas coisas úteis por ti sem que lhe peças. Dá a um convidado Fisher-Price OS (Windows) as funcionalidades paravirtuais de que precisa para correr bem no KVM, e carrega microcódigo de CPU atual no arranque.

Ambas são automáticas. Ambas dependem também de uma decisão que tomaste uma vez, possivelmente há anos, e para a qual não voltaste a olhar.

A primeira depende do OS Type que escolheste quando a VM foi criada. Escolhe uma das entradas Microsoft Windows e o Proxmox acrescenta os enlightenments Hyper-V em cada arranque. Deixa-o em Other, o que é fácil de fazer quando estás a importar um disco ou a clonar algo antigo, e o convidado não recebe nenhum. Arranca, corre, é mais lento, e nada te avisa.

A segunda depende de como o host chegou à versão 9. O instalador da 9.0 ativa o componente de firmware do Debian e instala o pacote de microcódigo para o teu CPU. Um host atualizado a partir da 8.x mantém os repositórios que tinha, e na maioria deles isso significa nenhum pacote de microcódigo. Num host AMD Zen 5 com o kernel 6.17.9 ou mais recente, essa não é uma falha teórica: os convidados que usam os tipos de CPU EPYC deixam de arrancar.

Duas predefinições, duas escolhas esquecidasUma VM: decidido pelo seu OS TypeOS Type, definido uma vezMicrosoft WindowsOther ou Linuxflags hv_ acrescentadasem cada arranquenenhumae nenhum avisoUm host: decidido por como chegou à 9host Proxmox VE 9instalador 9.xatualizado da 8.xpacote de microcódigoinstaladosem pacotepve8to9 só avisa
Ambas as predefinições dependem de uma escolha feita muito antes de alguma coisa correr mal. Em cada caso, o caminho da direita é aquele sobre o qual nada te avisa.

O resto deste artigo trata de cada uma por sua vez: o que é, a regra exata que o Proxmox aplica, como a ligar onde falta e como provar que pegou. As regras vêm do código do qemu-server e do pve-manager num host 9.2 em funcionamento, não da memória, porque duas delas não são o que a maioria das pessoas adivinharia.

O que é realmente um enlightenment

Um sistema operativo convidado escrito para hardware real gasta muito esforço em coisas que são desperdício dentro de uma VM. Programa temporizadores através de chips emulados, fica a rodar em locks detidos por um vCPU que nem sequer está agendado, e dispara watchdogs quando o host rouba uns milissegundos.

A paravirtualização resolve isso deixando o convidado saber que é um convidado e falar diretamente com o hipervisor. O Linux faz isto com as interfaces próprias do KVM. O Fisher-Price OS (Windows) só fala um dialeto paravirtual, o do Hyper-V, por isso o KVM implementa esse dialeto e diz ao convidado que está a correr num hipervisor compatível com Hyper-V. Cada peça dele chama-se um enlightenment.

Nada disto está ligado a menos que algo o peça. A documentação do QEMU é clara: «No Hyper-V enlightenments are enabled by default by either KVM or QEMU»1. No Proxmox, quem pede é o qemu-server, e só pede quando o tipo de SO é uma das entradas Microsoft Windows.

Podes ver a diferença em qualquer host. Esta é uma VM Linux no meu nó 9.2, ostype: l26, tipo de CPU host:

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

Duas flags KVM para o tratamento paravirtual de interrupções e spinlocks do próprio Linux, e nenhuma flag hv_. Correto para Linux. Errado para um convidado que só entende Hyper-V.

O que cada enlightenment faz, segundo as descrições do QEMU1:

FlagO que o convidado recebeO que poupa
hv_timerelógio de referência Hyper-V e página TSCleituras de timestamp sem saída
hv_relaxedindicação para desativar os timeouts do watchdogtimeouts falsos quando um vCPU é desagendado
hv_vapicpágina de assistência VP para o APICfim de interrupção sem saída
hv_spinlocksspinlocks paravirtuais, número de tentativas antes de avisar o hostrodar num lock cujo detentor não está a correr
hv_vpindexo seu próprio índice de processador virtualpré-requisito para os quatro seguintes
hv_runtimequanto tempo cada vCPU correu realmenteuma visão honesta do tempo roubado
hv_synic, hv_stimercontrolador de interrupções e temporizadores sintéticoshardware de temporização emulado
hv_ipienviar IPIs a muitos vCPUs numa só hiperchamadauma saída APIC por CPU de destino
hv_resetreinício através do hipervisor
hv_evmcsVMCS enlightened, só Intelvirtualização aninhada mais rápida
hv_tlbflushinvalidação de TLB paravirtualesperar por vCPUs que não estão a correr

O tipo de SO é o interruptor

A regra vive numa única função, get_hyperv_enlightenments, no CPUConfig.pm do qemu-server2. Primeiro, o tipo de SO é convertido num número de versão: win11 passa a 11, win10 passa a 10, w2k8 e wvista passam ambos a 6, e os tipos XP e 2003 passam a 5. Linux, Other e tudo o resto passam a 0.

Depois as barreiras correm por ordem.

Que flags hv_ o qemu-server acrescenta, barreira a barreiraDo tipo de SO às flags hv_, pela ordem em que o código correVersão do tipo de SO abaixo de 6?simpara: nada acrescentadoFirmware OVMF e versão abaixo de 8?simpara: nada acrescentadomáquina 2.3, depois 2.6 ou posterioracrescentaspinlocks vapic time reset vpindex runtimeversão 7 ou superioracrescentarelaxed synic stimer ipihost Intel, versão 11, máquina 11.0+pve2acrescentaevmcs
A ordem pela qual o qemu-server as aplica. Uma versão abaixo de 6 para na primeira barreira, e um convidado UEFI mais antigo do que o tipo 8.x para na segunda, sem nada acrescentado.

Ler uma regra é uma coisa. Executá-la é melhor. Por isso carreguei o CPUConfig.pm instalado em dois hosts 9.2, o meu nó AMD Ryzen para as linhas AMD e um nó Intel Celeron N5100 para as Intel, e chamei essa função com cada combinação:

Tipo de SOFirmwareVersão de máquinaHostEnlightenments acrescentados
l26 ou otherqualquerqualquerqualquernenhum
wxp (5)SeaBIOS11.0qualquernenhum
w2k8 (Vista/2008)SeaBIOS11.0qualquerspinlocks, vapic, time, reset, vpindex, runtime
win7SeaBIOS11.0qualqueros seis acima mais relaxed, synic, stimer, ipi
win7OVMF11.0qualquernenhum
win10OVMF11.0+pve2Intelos dez completos, sem evmcs
win11OVMF11.0+pve1Intelos dez completos, sem evmcs
win11OVMF11.0+pve2Intelos dez completos mais evmcs
win11SeaBIOS11.0+pve2AMDos dez completos, sem evmcs

Há três coisas aí que vale a pena saber antes de chegares perto da GUI.

Um convidado UEFI com um tipo de SO anterior ao 8.x não recebe nada. O código retorna cedo quando o firmware é OVMF e a versão está abaixo de 8. Um convidado 7/2008r2 que passaste para UEFI perdeu silenciosamente todos os enlightenments que tinha.

O hv_evmcs quer três coisas ao mesmo tempo. Um host Intel, o tipo de SO 11/2022/2025 e a versão de máquina 11.0+pve2 ou posterior. Um convidado 10/2016/2019 nunca o recebe por predefinição, por mais nova que seja a sua versão de máquina.

O fabricante do host é lido quando a VM arranca. A verificação chama read_cpuinfo no nó que faz o arranque, não onde quer que a VM tenha sido criada. Num cluster misto Intel e AMD, a mesma VM recebe hv_evmcs num nó e não no outro, decidido de novo em cada arranque a frio.

As barreiras de versão de máquina mais antigas (2.3, 2.6, 2.12, 3.1) só importam para VMs fixadas em máquinas do passado distante do QEMU. Tudo o que criarias hoje passa por elas.

Por isso escolhe o tipo de SO mais próximo do convidado, não o mais novo da lista. Um convidado 10/2016/2019 pertence ao 10/2016/2019. A documentação do Proxmox dá uma segunda razão pela qual o tipo importa para além destas flags: também define coisas como se o RTC virtual corre na hora local3.

Porque é que as tuas VMs mais antigas ficam sem a correção de julho

O hv_evmcs por predefinição é novo. Chegou no qemu-server 9.2.0 a 15 de julho de 2026, para «mitigate guest freezes and 100% CPU usage seen on certain Intel CPUs with Windows guests that use Virtualization-Based Security (VBS)»4, e está ligado à versão de máquina 11.0+pve2.

Essa ligação é o problema, porque o Proxmox fixa a versão de máquina de cada VM com um tipo de SO Microsoft Windows no momento em que é criada. A documentação dá a razão: «Windows is sensitive to changes in the virtual hardware - even between cold boots»3. É uma decisão sensata. Também significa que uma VM criada em junho de 2026 está em 11.0+pve1 ou mais antiga, e vai ficar lá até alguém a mudar.

Alguém a vai mudar por ti? Não. A nova predefinição aplica-se às VMs novas e às VMs que atualizas deliberadamente, e a mais nada.

Se tens hosts Intel a correr convidados 11/2022/2025 com VBS ligado, e algum deles congelou a 100% de CPU, esta é a primeira coisa a verificar:

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

Um ostype: win11 com uma linha machine: abaixo de pc-q35-11.0+pve2 precisa de subir para receber a correção. Subi-la muda o hardware virtual que o convidado vê, que é precisamente aquilo contra o qual a fixação protege. Por isso faz isto numa janela de manutenção, com uma cópia de segurança ou um snapshot feito antes, através de Hardware → Machine → Edit, marca Advanced e escolhe a versão.

Se a linha começar por pc-i440fx-, a versão é o problema menor: esse convidado nem devia estar em i440fx, pelas razões em Always Use Q35, Not i440fx, e Defini-lo, e provar que pegou, mais abaixo, trata disso.

Duas predefinições relacionadas chegaram nos mesmos poucos meses e vale a pena conhecê-las enquanto estás nisso. O qemu-server 9.1.12 desligou as flags cet-ibt e cet-ss para o tipo 11/2022/2025, porque com o QEMU 11.0 e os kernels 7.x a expô-las, os convidados com VBS não arrancavam4. E o 9.1.14 expôs a propriedade level do CPU, que a documentação descreve como «a known workaround for Hyper-V boot failures of Windows guests on recent Intel hosts when the CPU type is host or max»3.

O lado do QEMU, versão a versão

O qemu-server constrói a linha de comandos. O pve-qemu-kvm é o QEMU que a executa, e a correção de julho precisa de ambos.

A versão de máquina 11.0+pve2 só pode ser escolhida quando está instalado um binário QEMU 11.0, porque o qemu-server recusa qualquer versão de máquina mais nova do que o QEMU que encontra no host5. O +pve2 é o contador de revisão do próprio qemu-server, não do QEMU, por isso qualquer compilação 11.0 o satisfaz. No dia em que a 9.2.0 saiu, o par era este:

PacoteVersãoLançadoO que traz
qemu-server9.2.015 de julho de 2026a predefinição hv-evmcs e a máquina 11.0+pve2
pve-qemu-kvm11.0.2-11 de julho de 2026QEMU 11.0.2, o atual nesse dia
pve-qemu-kvm, mínimo11.0.0-15 de maio de 2026a primeira compilação do QEMU 11.0

O apt garante que tens ambos? Não. O qemu-server 9.2.0 não declara nada mais forte do que pve-qemu-kvm (>= 7.1~)6, por isso um nó com o QEMU retido na 10.x aceita o novo qemu-server sem um pio e depois não consegue oferecer a versão de máquina de que a correção depende. Verifica ambos, em cada nó. Este é o meu host 9.2 hoje, bem para lá dos dois:

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

Cada versão do QEMU desde que o Proxmox VE 9.0 saiu com a 10.0.27 trouxe correções próprias para convidados Fisher-Price OS (Windows). Estas são as que tocam no convidado, segundo o changelog do pacote do Proxmox8 e os changelogs upstream do QEMU9:

QEMUCompilação ProxmoxO que corrigiu para o convidado
10.010.0.2-1, 17 de junho de 2025o bug «PCI Label Id», inofensivo em inglês mas capaz de bloquear instalações localizadas
10.110.1.2-3, 17 de novembro de 2025uma regressão da área de transferência VNC que estragava o ponteiro do rato
10.110.1.2-5, 22 de dezembro de 2025cópias de segurança de uma VM com disco TPM a ficarem presas, uma correção do io_uring
11.011.0.0-1, 5 de maio de 2026uma regressão no export FUSE que o swtpm usa para o estado do TPM
11.011.0.2-1, 1 de julho de 2026enlightenments Hyper-V reconhecidos como flags CPUID, para que um modelo de CPU personalizado os possa levar

O QEMU 11.0 também estragou uma coisa: começou a expor cet-ibt e cet-ss, que foi o que impediu os convidados VBS de arrancar e levou o qemu-server 9.1.12 a desligá-las, como vimos acima.

As correções do agente convidado nas mesmas versões são outra história. O QEMU 10.1, 10.2 e 11.0 corrigiram cada um partes do tratamento de VSS e de congelamento do sistema de ficheiros do agente convidado, incluindo o «Access denied Event ID 8194» que a 11.0 curou9. Nada disso chega com o pve-qemu-kvm. O agente para esse convidado vem na ISO de drivers virtio-win10, por isso só muda quando atualizas o agente dentro da VM.

As duas flags que podes definir à mão

O Proxmox não te deixa acrescentar flags de CPU arbitrárias a uma VM. Hardware → Processors → Edit, marca Advanced, e Extra CPU Flags oferece uma lista fixa, definida em CPUFlags.pm11. Duas entradas dessa lista são enlightenments, e são as duas que o Proxmox não define por predefinição, ou não definia até julho.

FlagA descrição do próprio ProxmoxQuando a definir
hv-tlbflush«Improve performance in overcommitted Windows guests. May lead to guest bluescreens on old CPUs.»Opcional. Experimenta primeiro numa VM e vigia-a.
hv-evmcs«Improve performance for nested virtualization. Only supported on Intel CPUs.»Hyper-V aninhado, WSL2 ou VBS dentro do convidado, em Intel. Já ligada para 11/2022/2025 em 11.0+pve2.

Ambas passaram a opcionais no qemu-server 6.0-6, a 23 de julho de 2019, descritas no changelog como «sometimes problematic»4. O hv-tlbflush ficou assim durante sete anos. É uma boa pista sobre quantos testes merece antes de o espalhares por um cluster.

A nota do próprio QEMU sobre o hv-evmcs é que é só Intel, e que «some virtualization features (e.g. Posted Interrupts) are disabled when hv-evmcs is enabled»1. Ligá-lo à mão num convidado que não está a fazer virtualização aninhada não te dá nada e custa-te isso.

Defini-lo, e provar que pegou

Para uma VM nova: Create VM → OS, define Type como Microsoft Windows e Version como a correspondência mais próxima.

Para uma existente: Options → OS Type → Edit, escolhe a versão, OK. O Proxmox fixa a versão de máquina quando mudas uma VM existente para um tipo Microsoft Windows, tal como faz na criação4, por isso conta que a linha machine: da configuração também mude.

E põe-na em q35. Um convidado com enlightenments não tem nada que fazer em pc-i440fx. É o chipset sem barramento PCIe, e as razões vão muito além do passthrough; estão todas em Always Use Q35, Not i440fx.

O assistente não te impede, e para a maioria dos tipos Microsoft Windows é lá que te põe. A própria documentação do Proxmox chama ao Intel 440FX «the default»3, e as predefinições de SO da GUI sobrepõem-se a isso para exatamente uma entrada: o 11/2022/2025 recebe machine: 'q35' e bios: 'ovmf'12. Todos os outros tipos Microsoft Windows herdam as predefinições genéricas, que não definem máquina nenhuma. Por isso um convidado 10/2016/2019 criado a carregar em Next aterra em i440fx, com enlightenments e no chipset errado ao mesmo tempo.

Tipo de SO escolhido no assistenteMáquina que recebeFirmware que recebe
11/2022/2025q35OVMF
10/2016/2019 e todos os tipos Microsoft Windows mais antigosi440fxSeaBIOS
Other, Linuxi440fxSeaBIOS

Muda-o no separador System antes de terminares o assistente. Para uma VM que já existe, mudar de chipset é uma alteração maior ao hardware virtual do que subir a versão de máquina, por isso aplicam-se as mesmas regras de janela de manutenção e cópia de segurança, e o artigo sobre o q35 explica o que o convidado faz em relação a isso.

Depois para-a como deve ser. Os enlightenments são argumentos na linha de comandos do QEMU, e essa linha só é construída quando o processo QEMU arranca. Um reinício a partir de dentro do convidado mantém o mesmo processo, por isso mantém as flags antigas. Desliga, espera por stopped, depois Start.

Prova-o a partir do host, porque é lá que está a resposta:

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

Isto mostra o que o qemu-server vai entregar ao QEMU no próximo arranque. Um convidado 11/2022/2025 em 11.0+pve2 num Intel deve listar onze: hv_evmcs, hv_ipi, hv_relaxed, hv_reset, hv_runtime, hv_spinlocks=0x1fff, hv_stimer, hv_synic, hv_time, hv_vapic e hv_vpindex. O mesmo convidado em AMD lista dez. Um resultado vazio significa que o tipo de SO não é um Microsoft Windows, ou que é um tipo anterior ao 8.x em UEFI.

Se um convidado não arrancar depois da alteração, volta a pôr o tipo de SO em Other durante um arranque para confirmar ou excluir os enlightenments. Corre sem eles. Só corre pior.

Microcódigo: o que corrige e de onde vem

A segunda predefinição fica por baixo do hipervisor, não por cima.

O microcódigo de CPU é o firmware do fabricante para o próprio processador. As atualizações corrigem vulnerabilidades de segurança e bugs graves do CPU, e o guia de administração do Proxmox sublinha o ponto que importa para quem se preocupa com o custo em velocidade: «a patched microcode is usually still more performant than an unpatched microcode where the kernel itself has to do mitigations»13.

Há três sítios de onde pode vir, e são independentes.

OrigemAplicadoQuem o distribuiNo meu host 9.2 hoje
Atualização da BIOS/UEFI da placaem cada arranque, persistenteo fabricante da placa ou do servidoro que a última BIOS trouxe
Debian non-free-firmwarecedo no arranque, a partir do initramfsDebianintel-microcode 3.20251111.1~deb13u1, amd64-microcode 3.20250311.1
Repositório do Proxmox VEcedo no arranque, a partir do initramfsProxmoxamd64-microcode 3.20251202.1~bpo13+1, sem pacote Intel

A via da BIOS é a que o Proxmox chama recomendada13. A via do carregamento antecipado é a rede de segurança para quando o fabricante da placa deixou de lançar atualizações da BIOS, o que em qualquer coisa com alguns anos costuma ter acontecido.

Aquela terceira linha surpreendeu-me. O Proxmox tem no seu próprio repositório um amd64-microcode mais novo do que o Debian tem no trixie14, com a mesma prioridade de pin, por isso o apt escolhe o do Proxmox. Num host AMD com o repositório do Proxmox configurado, é essa a versão que vais acabar a correr, e como mostra a secção seguinte, é a versão que importa.

Onde o microcódigo é aplicado durante um arranqueUm arranque, da esquerda para a direitaLigarmicrocódigo da BIOSGestor de arranquecarrega o initramfsKernel arrancaatualização antecipadaHost a correrconvidados arrancamCarregamento tardiobloqueadopersistente,fabricante da placado initramfs,Debian ou Proxmoxblacklist em/etc/modprobe.d
O carregamento antecipado acontece antes de o kernel ter iniciado qualquer outra coisa. O carregamento tardio num sistema em execução é a via que o Debian bloqueia, e continua bloqueada.

O carregamento antecipado é o que este artigo configura. O microcódigo vai para o initramfs e o kernel aplica-o logo no início do arranque, antes de qualquer outra coisa estar a correr.

O carregamento tardio aplica-o a um sistema em execução. A documentação do próprio kernel tem uma secção intitulada «Why is late loading dangerous?» e desde a 5.19 não está ativado por predefinição15. O Debian também o bloqueia. Este é o ficheiro no meu host, tal e qual:

# 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

Deixa-o estar. O host acima tem-no no sítio e mesmo assim mostra uma atualização antecipada bem-sucedida, por isso não está a atrapalhar nada.

Qualquer das vias precisa de um reinício. Não há volta a dar a isso.

E é só x86. O guia do Proxmox diz claramente que «There is no equivalent operating-system-level microcode package for arm64»13.

Porque é que um host atualizado não tem nenhum

O «non-free» em non-free-firmware tem a ver com a licença, não com dinheiro nem com uma subscrição do Proxmox. A wiki do Debian explica: o lado do kernel é software livre, mas os dados de atualização do fabricante são «opaque», «and its contents are unknown to Debian»16. É por isso que vivem num componente próprio, e é por isso que um sistema Debian não os recebe a menos que o componente esteja ligado.

O instalador do Proxmox VE 9.0 liga-o. As notas de versão dizem que a ISO vai «Install the microcode package matching the current platform», e que «installations now have the non-free-firmware repository enabled»7. Um upgrade não faz nenhuma das duas coisas, porque mantém as linhas de repositório que tinhas na 8.x.

Instalação nova 9.xAtualizado a partir da 8.x
non-free-firmwareativado pelo instaladoro que a 8.x tinha, muitas vezes ausente
Pacote de microcódigoinstalado para o CPU detetadonenhum, até acrescentares o componente
O que te avisanada necessáriopve8to9, como FAIL e WARN, e só se o correres
Atualizações posterioresapt full-upgrade e um reinícioo mesmo, depois de o pacote estar instalado

O verificador assinala-o, mais alto do que eu esperava. Aqui está ele no meu nó Intel, que veio da 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

O FAIL é um efeito secundário: a consulta de versão regista uma falha para qualquer pacote que não esteja instalado, antes de a verificação do microcódigo chegar ao seu próprio aviso17. De qualquer forma, o pve8to9 é um verificador, não uma barreira. Não executa o upgrade nem o consegue impedir, por isso o upgrade passa-lhe ao lado.

Isso importa na prática? Aqui ficam dois casos em que importa, e o primeiro é meu.

Esse nó Intel é um Celeron N5100. A sua lista de fontes já tinha non-free-firmware, por isso o pacote estava a um comando de distância, e até 27 de outubro de 2026 ninguém o tinha corrido. O kernel reparou, mesmo que mais ninguém tenha reparado:

# 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

O kernel mantém «a table of released microcode», e um CPU que arrancou com algo mais antigo «will say ‘Vulnerable’»18. Quão antigo é antigo? As notas de versão da Intel respondem para este chip19:

RevisãoVersão IntelNeste host
0x1dmicrocode-20210608o que o firmware da placa carrega hoje
0x2400001fmicrocode-20220207
0x24000023microcode-20220510saiu seis meses antes de a BIOS desta placa ser compilada
0x24000024microcode-20230214
0x24000026microcode-20240312no intel-microcode 3.20251111.1~deb13u1 do Debian

A BIOS é a versão 5.19, datada de 8 de novembro de 2022, e ainda carrega o primeiro microcódigo que a Intel lançou para a peça, com dois mais novos já disponíveis quando foi compilada. Esse é exatamente o caso para o qual existe a via do carregamento antecipado: quatro atualizações paradas num pacote que o host já conseguia ver. Instalei-o enquanto escrevia isto, e o que isso fez está em Ligá-lo, porque mostra uma armadilha.

O segundo caso é da AMD. As peças Zen 5 têm um bug na instrução RDSEED20. As notas da versão 9.1 do Proxmox registam o que acontece a seguir: os kernels a partir da 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. A correção é o amd64-microcode 3.20251202.1~bpo13+1 ou mais recente, que é a versão do repositório do Proxmox e não a do Debian.

Há uma segunda armadilha dentro dessa. Em placas Zen 5 cuja BIOS é anterior à correção da vulnerabilidade Entrysign da AMD, o kernel recusa o novo microcódigo e regista No sha256 digest for patch ID, e o conselho do Proxmox é uma atualização da BIOS21. Por isso, nesse hardware, a via do SO só funciona depois de o fabricante da placa ter feito a sua parte.

Ligá-lo

Regista primeiro onde estás. No host, como 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 o dpkg já mostra o pacote correspondente como ii, o host está pronto e podes saltar para a verificação do resultado.

Ativa o componente. O apt do trixie prefere o formato deb822 .sources, e o guia de upgrade do Proxmox aponta para apt modernize-sources para converter os antigos ficheiros de uma linha, guardando os originais como .bak22. Depois acrescenta non-free-firmware à linha Components: tanto da estrofe principal como da de segurança em /etc/apt/sources.list.d/debian.sources. Este é o ficheiro no meu host, que veio do instalador:

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

As duas estrofes, porque o Debian distribui microcódigo para a stable pelas duas vias. O arquivo de segurança tem o intel-microcode 3.20250812.1~deb13u1 enquanto o arquivo principal já passou para o 3.20251111.1~deb13u123, e queres o que for mais novo.

Instala o que corresponde ao CPU.

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

Só o do teu fabricante. A partir daí, o microcódigo novo chega com as execuções normais de apt full-upgrade, e cada versão nova precisa de um reinício como a primeira.

Instalá-lo reconstrói o initramfs, porque é lá que o microcódigo antecipado tem de viver. O kernel lê-o de um arquivo não comprimido no início do initrd, como kernel/x86/microcode/GenuineIntel.bin ou AuthenticAMD.bin15, e o script de instalação do pacote dispara o trigger do initramfs para o pôr lá24. Este é o meu nó Intel a receber o pacote enquanto este artigo estava a ser escrito:

# 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..

O zz-proxmox-boot é o hook do Proxmox. Num host cujas partições EFI são mantidas pelo proxmox-boot-tool, copia a nova imagem para lá; este não tem nenhuma para sincronizar.

Agora olha para a imagem que gerou. Sem nenhum kernel indicado, o update-initramfs -u reconstrói só o mais novo: «The default is the latest kernel version»25. O mesmo nó, logo a seguir:

# 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

Uma imagem em sete tem o microcódigo, e não é a que o host está a correr.

Próximo arranqueO initramfs tem o microcódigoRevisão em que o CPU acaba
7.0.14-24, a entrada predefinidasima 0x24000026 do pacote
7.0.14-23, fixada ou a entrada de recursonãoa 0x1d da BIOS
qualquer coisa mais antiganãoa 0x1d da BIOS

Por isso reconstrói todas as imagens depois de instalar, e de novo depois de cada atualização de microcódigo, porque cada uma dispara a mesma reconstrução só do mais novo. Depois corre outra vez o ciclo acima para o provar:

update-initramfs -u -k all

Reinicia e verifica. Este é o meu host AMD 9.2 depois de o pacote do repositório do Proxmox ter sido instalado:

# 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 é a linha que o prova. O próprio guia de administração do Proxmox ainda mostra a formulação mais antiga, microcode updated early to revision13; o kernel atual imprime as duas linhas acima26. Qualquer das formas significa que funcionou.

A ausência dessa linha não é, por si só, uma avaria. Só aparece quando o pacote tem algo mais novo do que a revisão embutida no CPU e do que a que a BIOS carregou. Um pacote cobre muitíssimos modelos de CPU, e o guia tem razão quando diz que a data nele não te diz quando o teu modelo recebeu alguma coisa pela última vez13.

Espalhá-lo por um cluster

A alteração do repositório e a instalação podem ir para todos os nós ao mesmo tempo. Nada muda até um reinício. Os reinícios vão um nó de cada vez, e cada nó está saudável antes de o seguinte ir abaixo.

Um reinício faseado de microcódigo, um nó por passagemPor nó, depois o seguinteVerificarquórum, Ceph OKManutençãoconvidados saemnooutopcionalReiniciarver o dmesgEsperarOSDs up e inLibertarunset, devolvernó seguinte, mesmos passos
Um nó por passagem. Os dois passos Ceph só se aplicam a clusters hiperconvergentes, e o par noout é opcional.
PassoComandoFeito quando
Cluster saudávelpvecm status, ceph -scom quórum, HEALTH_OK
Esvaziar o nóha-manager crm-command node-maintenance enable <node>, migrar os convidados não-HA à mãonenhum convidado lá
Opcional, Cephceph osd set nooutflag visível em ceph -s
Reiniciar, verificardmesg | grep -i microcodenova revisão visível
Ceph recuperadoceph -stodos os OSDs up e in, HEALTH_OK
Libertarnode-maintenance disable <node>, ceph osd unset nooutconvidados HA de volta

O modo de manutenção HA regista de onde veio cada convidado HA e devolve-o quando o nó sai da manutenção27. Os convidados não-HA são contigo.

Sobre o noout, as opiniões dividem-se e ambos os lados têm razão. O Ceph marca rapidamente como down um OSD silencioso, mas só o marca como out depois de mon_osd_down_out_interval, que por predefinição são dez minutos28, e é o out que desencadeia o rebalanceamento. Um reinício normal volta bem dentro desse prazo. Um servidor com um POST longo, uma pergunta do firmware ou uma controladora RAID lenta pode não voltar. Definir noout impede que um reinício lento se transforme num rebalanceamento. O preço é lembrares-te de o retirar, e um noout esquecido esconde mais tarde uma avaria real.

Faz o cluster inteiro numa só janela. Nós a correr revisões de microcódigo diferentes é exatamente a situação em que um convidado com o tipo de CPU host, que vê diretamente as funcionalidades do CPU físico, pode migrar a quente para um nó que reporta um conjunto diferente.

Quando uma atualização de microcódigo corre mal

É raro, mas acontece, e o guia do Proxmox trata disso como deve ser13.

SituaçãoFaz istoPorquê
Suspeitas do novo microcódigoarranca uma vez com dis_ucode_ldrdesativa o carregador só nesse arranque29
Revisão antiga boa, nova nãoinstala a versão anterior e retém-nauma purga pode deixar a correr uma revisão da BIOS ainda mais antiga
Algumas semanas depoisapt-mark unhold, depois full-upgradeuma correção noutro sítio pode resolvê-lo com a mesma versão de microcódigo

Para o arranque pontual: menu do GRUB (mantém o Shift carregado se estiver escondido), E na entrada do Proxmox, acrescenta dis_ucode_ldr à linha que começa por linux, depois Ctrl+X. Um host com systemd-boot em vez de GRUB está coberto no capítulo do gestor de arranque do guia de administração.

A reversão, em 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

Troca por amd64-microcode em AMD. Reverte, nunca purgues.

Uma predefinição é uma promessa a quem seguiu o caminho esperado

Nenhuma destas coisas é um bug. O Proxmox fez a coisa sensata das duas vezes: ligar a funcionalidade onde é seguro, deixá-la desligada onde pode não ser, e fixar o hardware virtual com que o convidado é esquisito. O instalador foi corrigido, o verificador de upgrade assinala-o, o changelog diz o que mudou e quando. O Proxmox fez a sua parte.

Mas uma predefinição é uma promessa feita a quem fez as coisas como o fabricante esperava. Instalação nova, tipo de SO correto, VM criada depois de julho. Qualquer pessoa cujo parque tenha história, e isso é toda a gente que corre alguma coisa a sério, está em parte fora dessa promessa, e a falha não se anuncia. Aparece como um convidado que está um bocado lento, um congelamento VBS que ninguém liga a uma versão de máquina, ou um nó Zen 5 onde os convidados EPYC não arrancam depois de uma atualização do kernel.

As notas de versão descrevem o que uma instalação nova recebe. Não dizem nada sobre o que os teus hosts estão realmente a correr, e essas são perguntas diferentes. A única maneira de responder à segunda é ir ver: qm showcmd nos convidados, dmesg nos hosts, a linha da máquina na configuração. Nada disso leva mais de um minuto por máquina.

Esse minuto é o trabalho. O Proxmox dá-te as ferramentas para verificar, e por isso a distância entre o que presumiste e o que está a correr é tua para fechar, não deles.


  1. QEMU documentation — Hyper-V Enlightenments — «No Hyper-V enlightenments are enabled by default by either KVM or QEMU»; descrições flag a 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: as barreiras de OVMF e de versão, as guardas de versão de máquina e a verificação GenuineIntel para hv_evmcs. Executado aqui a partir do 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»; a propriedade level e as predefinições cet-ibt/cet-ss para esses convidados. ↩︎ ↩︎ ↩︎ ↩︎

  4. Proxmox qemu-server — Debian changelog — a 9.2.0 (15 de julho de 2026) ativa hv-evmcs para convidados 11/2022/2025 em Intel a partir da máquina 11.0+pve2; a 9.1.14 expõe level; a 9.1.12 desativa cet-ibt e cet-ss; fixação ao mudar para um tipo de SO Microsoft Windows (janeiro de 2025); a 6.0-6 (23 de julho de 2019) «Make sometimes problematic ‘hv-tlbflush’ and ‘hv-evmcs’ CPU flags optional». ↩︎ ↩︎ ↩︎ ↩︎

  5. Proxmox qemu-server — Machine.pm — can_run_pve_machine_version devolve falso quando o major.minor do QEMU da máquina é mais novo do que o binário instalado; as revisões +pveN estão listadas no mesmo ficheiro. ↩︎

  6. Proxmox qemu-server 9.2.0 — debian/control — no commit «bump version to 9.2.0» de 15 de julho de 2026, a dependência de execução é 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.»; a mesma versão lista «QEMU 10.0.2» ↩︎ ↩︎

  8. Proxmox pve-qemu — Debian changelog — 10.0.2-1 (17 de junho de 2025) «update QEMU and downstream patches for 10.0.2 release», que traz a correção upstream da 10.0 abaixo; 10.1.2-3 «a regression with VNC clipboard breaking mouse pointer in Windows guests»; 10.1.2-5 a correção do io_uring para «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 para as correções de VSS e de congelamento do agente convidado, incluindo «Fix guest-fs-freeze cause “Access denied Event ID 8194” in Event Viewer». ↩︎ ↩︎

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

  11. Proxmox qemu-server — CPUFlags.pm — a lista de flags por VM, com as descrições de hv-tlbflush e hv-evmcs citadas acima. ↩︎

  12. Proxmox pve-manager — OSDefaults.js — a entrada win11 define machine: 'q35' e bios: 'ovmf'; as outras entradas Microsoft Windows herdam generic, que não define máquina. ↩︎

  13. Proxmox VE admin guide — CPU Microcode Updates — atualizações antecipadas pelo SO, a via BIOS/UEFI como recomendada, o arm64 sem pacote de SO, o procedimento dis_ucode_ldr e a reversão em vez da purga. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  14. Proxmox VE pve-no-subscription repository for trixie — tem amd64-microcode 3.20251202.1~bpo13+1 e nenhum intel-microcode, lido a 27 de outubro de 2026. ↩︎

  15. Linux kernel documentation — The Linux Microcode Loader — «Since kernel 5.19, late loading is not enabled by default», e a secção «Why is late loading dangerous?». ↩︎ ↩︎

  16. Debian Wiki — Microcode — os dados de atualização «opaque» fornecidos pelo fabricante do CPU «is non-free, and its contents are unknown to Debian». ↩︎

  17. Proxmox pve-manager — pve8to9.pm — check_cpu_microcode_package regista o aviso; a consulta $get_pkg que chama primeiro regista «unable to determine installed $pkg version.» como falha para qualquer pacote que não esteja instalado. ↩︎

  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’.» (aspas interiores mudadas de duplas para simples) ↩︎

  19. Intel — Linux Processor Microcode Data Files, release notes — as linhas JSL para 06-9c-00/01, «Celeron N4500/N4505/N5100/N5105», nas versões 20210608 a 20240312; 0x24000026 lido do cabeçalho de 06-9c-00 no pacote do Debian. ↩︎

  20. AMD security bulletin AMD-SB-7055 — o problema do RDSEED nos processadores Zen 5. ↩︎

  21. Proxmox VE Roadmap — 9.1 known issues, AMD Zen5 CPU issue with RDSEED — a falha de arranque dos convidados, a versão do pacote corrigido e a mensagem No sha256 digest em placas sem a correção Entrysign da BIOS. ↩︎ ↩︎

  22. Proxmox VE wiki — Upgrade from 8 to 9 — apt modernize-sources converte para deb822 e guarda os ficheiros antigos com o sufixo .bak. ↩︎

  23. Debian packages — intel-microcode in trixie — as versões stable e de segurança, confirmadas com apt-cache policy no host. ↩︎

  24. Debian sources — intel-microcode.postinst — dpkg-trigger --no-await update-initramfs, depois «microcode will be updated at next boot»; o amd64-microcode faz o mesmo. ↩︎

  25. Debian manual — update-initramfs(8) — para -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 — imprime «Current revision: 0x%08x» e «Updated early from: 0x%08x». ↩︎

  27. Proxmox VE admin guide — High Availability, maintenance mode — os serviços HA são retirados e devolvidos «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», predefinição de 10 minutos. ↩︎

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