O que o teu cliente vê quando a tua VM arranca

Vendes máquinas virtuais com o teu próprio nome. Um cliente liga uma, e a primeira coisa no ecrã é o logótipo de outra pessoa.

Isso é uma VM Proxmox de origem. Nada está avariado, e o Proxmox não está a fazer nada de errado: o produto é deles e o nome é deles, escreveram o firmware e a interface em que aparece, e têm todo o direito de o pôr lá, da mesma forma que um fabricante de servidores põe o seu emblema na frente da caixa. Só que não é teu.

O logótipo é só o começo. Isto é o que um convidado UEFI de origem reporta com o firmware atual do Proxmox, pve-edk2-firmware 4.2026.08-1, lido de dentro do convidado com o dmidecode:

Onde o convidado olhaO que lêDe quem é o nome
Ecrã de arranqueo logótipo do ProxmoxProxmox
Fabricante do firmware (SMBIOS tipo 0)Proxmox distribution of EDK IIProxmox
Versão do firmware4.2026.08-1a versão do pacote do Proxmox
Fabricante do sistema (tipo 1)QEMUQEMU
Nome do produto (tipo 1)Standard PC (Q35 + ICH9, 2009)QEMU
Fabricante do chassis (tipo 3)QEMUQEMU
Placa base (tipo 2)nem sequer existeninguém
Interface web de gestãoo logótipo do Proxmox, em cima à esquerdaProxmox

E o logótipo de arranque também não fica pelo firmware. O firmware UEFI entrega a imagem que desenhou ao sistema operativo através de uma tabela ACPI chamada BGRT, a Boot Graphics Resource Table, que existe para dizer «an image was drawn on the screen during boot»1, e o sistema operativo desenha-a outra vez no seu próprio ecrã de arranque. O Fisher-Price OS (Windows) põe-na por cima da sua roda giratória, e a Microsoft chama à BGRT «the standard interface that Windows uses to access the logo»2. O tema Plymouth por omissão do Fedora faz o mesmo em Linux3. Portanto, um convidado com o firmware do Proxmox mostra o logótipo do Proxmox duas vezes antes de alguém ter iniciado sessão.

Nada disto é difícil de mudar. Mantê-lo mudado é que é. O próximo apt full-upgrade vai repor discretamente metade, e a metade que não repõe é a que te devia preocupar, que é aquilo de que trata a maior parte deste artigo.

Onde cada peça da marca entra no arranqueLigarO QEMU montaSMBIOS e ACPIa partir da configFirmwareO OVMF desenha ologótipo embutido,o SeaBIOS um splashEntregatabelas SMBIOS,ACPI com BGRTe MSDMArranque do SOredesenha ologótipo do firmwarea partir da BGRTConvidado ativolê as strings,a ativação lêa chave MSDMconfig da VMficheiro de pacoteconfig da VMficheiro de pacoteconfig da VMvive em /etc/pve, sobrevive a todas as atualizaçõesvive em /usr/share, o apt substitui-o
A marca entra no arranque em cinco sítios. Três saem da própria configuração da VM e sobrevivem a tudo o que o apt faça. Dois vêm de ficheiros que pertencem a um pacote do Proxmox, e são esses que uma atualização leva de volta.

A tabela MSDM nessa passagem não é marca nenhuma. Transporta uma chave de licença, e passar uma para dentro de uma VM tem o seu próprio artigo: Passar uma licença OEM para uma VM Proxmox.

Tudo o que está em /usr/share pertence ao apt

Há uma regra que decide todas as escolhas abaixo. Um ficheiro que um pacote instalou é ficheiro do pacote. Edita-o no sítio e a próxima atualização desse pacote reescreve a tua edição sem dizer nada, porque, no que toca ao dpkg, está só a pôr o seu próprio ficheiro de volta onde o deixou.

Por isso cada peça da marca tem de viver num sítio que não pertença ao apt. Um nó Proxmox tem três sítios desses, e cada um custa uma coisa diferente:

Onde viveComo lá chegaSobrevive a uma atualizaçãoO que te custa
A configuração da VM em /etc/pvesmbios1, e args para tudo o restoSim, a configuração nunca é tocada por um pacoteargs é só para root, e não aparece na GUI
Um ficheiro que o dpkg foi instruído a deixar em pazdpkg-divertSim, a cópia do pacote vai para um nome .distribAs atualizações deixam de chegar ao ficheiro, o que importa quando o ficheiro é firmware
O teu próprio diretório, fora da árvore dos pacotes/usr/local, referido a partir de argsSim, nenhum pacote é dono deleTens de o pôr em cada nó tu próprio

A descrição que a própria Debian faz de um desvio é a mais clara: «a way of forcing dpkg not to install a file into its location, but to a diverted location»4. Isso resolve a interface web. Para o firmware é uma de duas opções, e a mais perigosa.

O chassis é meia dúzia de strings e uma verificação de permissões

O SMBIOS é a tabela que uma máquina usa para se descrever: quem a fez, que modelo é, o seu número de série, como são a placa e a caixa5. O dmidecode lê-a, todas as ferramentas de inventário de ativos que alguma vez apontaste a uma rede leem-na, o painel de informações do sistema do Fisher-Price OS (Windows) lê-a, e a maior parte das verificações de licença que decidem se um programa vai sequer correr numa determinada máquina também. Numa VM, quem a escreve é o QEMU. Daí o QEMU e o Standard PC na tabela acima.

O tipo 1 através do smbios1

O Proxmox expõe uma estrutura SMBIOS na configuração da VM: o tipo 1, System Information, como smbios16. Aceita manufacturer, product, version, serial, sku, family e uuid.

O senão está no qemu-server, não na documentação. Todos os campos exceto uuid têm de corresponder a um padrão base64, [A-Za-z0-9+\/]+={0,2}, por isso um valor simples com um espaço lá dentro é recusado logo à partida. As strings reais são codificadas em base64 com base64=1 definido, e o qemu-server descodifica-as outra vez antes de construir a linha de comandos do QEMU7. O editor de SMBIOS da GUI faz isto a cada gravação, com o comentário «smbios values can be arbitrary, so encode and mark config as such»8. Na linha de comandos, o trabalho é teu:

b() { printf %s "$1" | base64 -w0; }
qm set 9000 --smbios1 "uuid=$(qm config 9000 | sed -n 's/.*uuid=\([0-9a-f-]*\).*/\1/p'),base64=1,\
manufacturer=$(b 'Example Cloud Ltd'),product=$(b 'EC Compute Instance'),\
version=$(b '2026.10'),family=$(b 'General Purpose'),sku=$(b 'ec-gp-4c16g')"

Repara no uuid a voltar a entrar. É a identidade de máquina do convidado, e o que passares ao --smbios1 é guardado como a opção inteira, por isso lê-o primeiro e mantém-no.

Põe a marca no modelo, não em cada VM. Um clone Proxmox recebe um UUID gerado de novo e mantém todos os outros campos do smbios1, por isso cada clone sai com a sua própria identidade e as tuas strings9, com uma exceção, mais abaixo.

Os tipos 0, 2, 3 e 11 através de args

O smbios1 fica pelo tipo 1. O fabricante do firmware, a placa base, o chassis e as strings OEM passam todos por args, a linha que o Proxmox passa diretamente ao QEMU, e que a sua própria documentação diz ser «for experts only»6. A opção -smbios do QEMU aceita os campos de cada tipo10:

args: -smbios 'type=0,vendor=Example Cloud Ltd,version=EC-FW 1.0,date=10/04/2026,uefi=on' -smbios 'type=2,manufacturer=Example Cloud Ltd,product=EC Virtual Board,version=1.0' -smbios 'type=3,manufacturer=Example Cloud Ltd,version=1.0,asset=EC-ASSET-123,sku=ec-gp' -smbios 'type=11,value=example-cloud:instance=123'

Arrancado no QEMU com essas linhas, o dmidecode do convidado lê:

EstruturaCampoDe origemCom a marca
Tipo 0VendorProxmox distribution of EDK IIExample Cloud Ltd
Tipo 0Version4.2026.08-1EC-FW 1.0
Tipo 1ManufacturerQEMUExample Cloud Ltd
Tipo 1Product NameStandard PC (Q35 + ICH9, 2009)EC Compute Instance
Tipo 1Familynão especificadoGeneral Purpose
Tipo 2Manufacturerestrutura ausenteExample Cloud Ltd
Tipo 2Product Nameestrutura ausenteEC Virtual Board
Tipo 3ManufacturerQEMUExample Cloud Ltd
Tipo 3Asset Tagnão especificadoEC-ASSET-123
Tipo 11String 1estrutura ausenteexample-cloud:instance=123

Apareceram quatro armadilhas pelo caminho. As quatro são silenciosas.

Fornecer o tipo 0 faz desaparecer o «UEFI is supported». O OVMF escreve o seu próprio tipo 0 só quando o QEMU não forneceu nenhum; o ciclo que percorre as tabelas do QEMU define NeedSmbiosType0 = FALSE no momento em que encontra um tipo 011. A tua string de fabricante substitui a do Proxmox, que é o objetivo. Mas o tipo 0 do QEMU substitui também as características de firmware do OVMF, e sem uefi=on a linha «UEFI is supported» desaparece do dmidecode. Repõe-na com uefi=on. Para convidados UEFI há de qualquer forma uma casa melhor para a string do fabricante, dentro do próprio firmware, mais abaixo.

O tipo de chassis não pode ser definido. O tipo 3 do QEMU aceita manufacturer, version, serial, asset e sku, e mais nada10. Fica Other.

Duas definições do mesmo tipo fundem-se, e a última ganha. O qemu-server põe o seu -smbios type=1 cedo na linha de comandos e os teus args mesmo no fim12, por isso um segundo -smbios type=1,manufacturer=… em args não deita fora o primeiro: o QEMU fundiu-os campo a campo, o fabricante veio de args, e o UUID ficou onde o smbios1 o pôs. Isso importa para a quarta armadilha.

As duas metades têm donos diferentes. O qemu-server verifica permissões opção a opção. O smbios1 está com as opções de hardware e precisa de VM.Config.HWType, enquanto o args cai no caso genérico lá no fundo, que diz «only root can set»13. A placa, o chassis, o fabricante do firmware e as strings OEM são só teus. O tipo 1 não é. Qualquer pessoa a quem tenhas dado direitos de hardware pode reescrevê-lo, e num produto alojado essa pessoa pode muito bem ser o cliente. Se a string do fabricante importa, define-a também em args. A definição posterior ganha.

O número de série já está na configuração

A maior parte do que pertence ao tipo 1 já está na configuração da VM. O nome dá um bom número de série, porque o qemu-server só aceita aí um nome DNS14: curto, imprimível, nunca com uma vírgula, e a única coisa da VM que um cliente vai reconhecer.

Campo do tipo 1Tirado dePara uma VM de 4 núcleos e 16 GiB chamada web-01, com as etiquetas production;web
Serial Numbernameweb-01
SKU Numbercores × sockets, e memoryec-4c16g
Familya primeira entrada em tagsproduction
UUIDo UUID do smbios1 que já teminalterado
Manufacturer, Productas tuas strings fixasExample Cloud Ltd, EC Compute Instance

Há duas coisas que ficam de fora. O nó muda a cada migração, e o vmgenid é suposto mudar: todo o seu trabalho é dizer ao convidado que foi restaurado de um snapshot ou construído a partir de um modelo15. Nenhum dos dois é uma identidade.

#!/bin/bash
# /usr/local/sbin/ec-smbios VMID: rebuild smbios1 from the VM's own config.
set -euo pipefail
id=$1
cfg=$(qm config "$id" --current)
get() { sed -n "s/^$1: //p" <<<"$cfg"; }
b() { printf %s "$1" | base64 -w0; }

name=$(get name)
[ -n "$name" ] || { echo "VM $id has no name to use as a serial" >&2; exit 1; }
cores=$(get cores); sockets=$(get sockets); vcpu=$(( ${cores:-1} * ${sockets:-1} ))
mem=$(get memory); mem=${mem#current=}; mem=${mem%%,*}; mem=${mem:-512}
(( mem % 1024 )) && size="${mem}m" || size="$(( mem / 1024 ))g"
tag=$(get tags); tag=${tag%%;*}
uuid=$(get smbios1 | grep -o 'uuid=[0-9a-fA-F-]*' | cut -d= -f2 || true)
uuid=${uuid:-$(cat /proc/sys/kernel/random/uuid)}

s="uuid=$uuid,base64=1,manufacturer=$(b 'Example Cloud Ltd'),product=$(b 'EC Compute Instance')"
s+=",serial=$(b "$name"),sku=$(b "ec-${vcpu}c${size}")"
[ -n "$tag" ] && s+=",family=$(b "$tag")"
qm set "$id" --smbios1 "$s"

Os valores por omissão são os do próprio qemu-server, um núcleo, um socket e 512 MiB16, por isso uma configuração que os omita recebe na mesma um SKU verdadeiro. Corrido contra a configuração da tabela, com o qm substituído por um script que a servia, a linha que escreveu chegou ao QEMU descodificada da forma como o qemu-server a descodifica, e o dmidecode do convidado leu de volta web-01, ec-4c16g, production e o UUID que já tinha. Uma VM sem nome é recusada em vez de receber um número de série vazio.

O sítio óbvio para isto é um hookscript. É o errado. O qemu-server corre o hook pre-start dentro do bloqueio de configuração que tomou para arrancar a VM, e constrói a linha de comandos do QEMU a partir da configuração que carregou antes de o hook correr17. Um hook que reescreva o número de série muda o próximo arranque, não este.

Por isso corre-o a partir do teu aprovisionamento, nos quatro momentos em que os seus dados de entrada mudam: criar, clonar, mudar o nome e redimensionar. Clonar é o que morde. Um clone mantém todos os campos do smbios1 menos o UUID9, por isso salta esse passo e todas as VMs construídas a partir de web-template reportam o nome do modelo como número de série.

O logótipo de arranque vive em dois sítios diferentes

O logótipo que um convidado mostra depende do seu firmware. Os dois firmwares que o Proxmox distribui vão buscá-lo a sítios completamente diferentes:

SeaBIOS (bios: seabios, o valor por omissão)OVMF (bios: ovmf, UEFI)
De onde vem o logótipoum JPEG que o QEMU entrega no arranqueum bitmap compilado dentro do firmware
O ficheiro do Proxmox/usr/share/qemu-server/bootsplash.jpg, 640×480Logo.bmp, 400×120, 8 bits, compilado em OVMF_CODE_4M*.fd
Pacote donoqemu-serverpve-edk2-firmware-ovmf
Mudá-lo por VMargs: -boot splash=…args a apontar a VM para outro firmware
Mudá-lo sem recompilar nadasimnão
Chega ao SO convidado através da BGRTnãosim

SeaBIOS: um JPEG na linha de comandos

O qemu-server põe a mesma opção -boot em todas as VMs que arranca, menu=on,strict=on,reboot-timeout=1000,splash=/usr/share/qemu-server/bootsplash.jpg18. A documentação do QEMU diz que a imagem é mostrada «when option splash=sp_name is given and menu=on, If firmware/BIOS supports them. Currently Seabios for X86 system support it»10. O OVMF não tira dali nada além do splash-time, que usa como tempo de espera do menu de arranque, e não há referência nenhuma ao ficheiro do ecrã inicial em todo o OvmfPkg19.

Substituí-lo é uma linha na configuração da VM:

args: -boot splash=/etc/pve/branding/splash.jpg

Um segundo -boot não entra em conflito com o primeiro. O QEMU funde-o da mesma maneira que funde o -smbios, o valor posterior ganha, e com dois ficheiros de ecrã inicial indicados a captura de ecrã mostrou o segundo. O /etc/pve é a casa certa para o ficheiro, porque é o sistema de ficheiros do cluster e todos os nós veem o mesmo ecrã inicial, e o seu limite de 1 MiB por ficheiro está muito longe de um JPEG de 640×48020.

A imagem em si tem de cumprir três condições, e falhar qualquer uma delas custa-te o logótipo ou as suas cores:

CondiçãoPorquêO que acontece caso contrário
JPEG ou BMP de 24 bitso QEMU verifica o ficheiro antes de a VM arrancarsplash file … format not recognized; must be JPEG or 24 bit BMP
JPEG baseline, croma 4:2:0o descodificador do SeaBIOS não trata mais nada21ERR_NOT_SEQUENTIAL_DCT ou ERR_NOT_YCBCR_221111, e um ecrã em branco
640×480, como o do próprio Proxmoxo SeaBIOS pede à VGA BIOS um modo exatamente do tamanho da imagemnenhum modo correspondente, nenhum ecrã inicial

A maior parte das ferramentas de imagem escreve baseline 4:2:0 por omissão, por isso a forma habitual de perder o logótipo é uma daquelas opções de «guardar para a web» que liga discretamente a codificação progressiva, que parece idêntica em todos os visualizadores de imagens que tens e deixa o SeaBIOS sem desenhar coisa nenhuma.

A armadilha das cores

Esta custou uma tarde. O mesmo JPEG, desenhado por duas compilações do SeaBIOS 1.17.0, sai em duas cores diferentes:

Um ecrã inicial da Example Cloud três vezes: o JPEG de origem com um mosaico de logótipo azul, o SeaBIOS tal como o Proxmox o distribui com o mesmo azul, e uma compilação do SeaBIOS a correr a 32 bits por píxel com o azul transformado em dourado

Está no jpeg.c do SeaBIOS. O escritor de 24 bits por píxel tem um ramo little-endian que põe o azul no primeiro byte de cada píxel, e o escritor de 32 bits por píxel, PIC_32, não tem esse ramo e escreve lá o vermelho21. Num framebuffer little-endian isso troca o vermelho e o azul. O azul sai dourado, e o laranja sairia azul.

O escritor que corre depende do modo de vídeo que a VGA BIOS oferece:

FirmwareModo VBE para 640×480Bits por píxelCores
O SeaBIOS 1.17.0 pré-compilado do QEMU upstream, tal como o pve-qemu-kvm 11.0.3-4 o distribui0x11116certas, quantizadas para 65 536
A compilação própria seabios 1.17.0-10 do Fedora 440x14232vermelho e azul trocados

Os números de modo são da própria tabela do SeaBIOS22, e a linha do Proxmox foi verificada contra os próprios blobs do pacote: idênticos byte a byte ao rel-1.17.0-0-gb52ca86e094d pré-compilado do QEMU. Portanto, no Proxmox as tuas cores estão certas, mas são só 65 536, e um gradiente subtil vai ficar às faixas. E se o teu logótipo alguma vez aparecer com as cores erradas noutro hipervisor qualquer, não é o teu JPEG.

O logótipo UEFI está compilado dentro do firmware

Os convidados UEFI são a metade mais difícil, e num Proxmox moderno são a maioria dos convidados.

Não há opção de ecrã inicial para substituir. O logótipo é um bitmap dentro da imagem do firmware, e a compilação do Proxmox põe-no lá com uma linha em debian/rules:

debian/setup-build-stamp:
	cp -a debian/Logo.bmp MdeModulePkg/Logo/Logo.bmp

Isso copia o Logo.bmp deles, de 400×120 e 8 bits, por cima do do TianoCore antes de o edk2 ser compilado23. O mesmo ficheiro define o fabricante do firmware como uma constante de compilação, PcdFirmwareVendor=L"Proxmox distribution of EDK II", que é de onde vem o fabricante do tipo 0 na primeira tabela23.

Logótipo novo, firmware novo. A forma de obter um que se comporte exatamente como o do Proxmox é compilá-lo exatamente como o Proxmox o faz: a árvore deles na etiqueta que corresponde ao pacote que distribuem, os patches deles, as flags deles, e um bitmap trocado. O pve-edk2-firmware 4.2026.08-1 fixa o edk2 em 2970e56, que é a etiqueta upstream edk2-stable20260823.

git clone https://git.proxmox.com/git/pve-edk2-firmware.git
cd pve-edk2-firmware
git checkout f37039e52d228a7844a90aa2aaf1e161ebd04fcd   # 4.2026.08-1
git submodule update --init --recursive
cd edk2
QUILT_PATCHES=../debian/patches quilt push -a
cp /path/to/your/Logo.bmp MdeModulePkg/Logo/Logo.bmp
. ./edksetup.sh && make -C BaseTools

F="-DNETWORK_HTTP_BOOT_ENABLE=TRUE -DNETWORK_IP6_ENABLE=TRUE -DNETWORK_TLS_ENABLE
   -DSECURE_BOOT_ENABLE=TRUE -DPVSCSI_ENABLE=TRUE -DTPM2_ENABLE=TRUE
   --pcd PcdUninstallMemAttrProtocol=TRUE -DFD_SIZE_4MB"
P=(--pcd "PcdFirmwareVendor=LExample Cloud Ltd\\0"
   --pcd "PcdFirmwareVersionString=L4.2026.08-1+ec1\\0")

build -a IA32 -a X64 -t GCC -p OvmfPkg/OvmfPkgIa32X64.dsc $F "${P[@]}" -b RELEASE
cp Build/Ovmf3264/RELEASE_GCC/FV/OVMF_CODE.fd OVMF_CODE_4M.fd
rm -rf Build/Ovmf3264
build -a IA32 -a X64 -t GCC -p OvmfPkg/OvmfPkgIa32X64.dsc $F -DSMM_REQUIRE=TRUE "${P[@]}" -b RELEASE
cp Build/Ovmf3264/RELEASE_GCC/FV/OVMF_CODE.fd OVMF_CODE_4M.secboot.fd

As flags foram tiradas do debian/rules tal como está nesse commit. Atenção à string do fabricante: o Makefile deles escreve-a entre aspas, a shell do make tira-as, e o edk2 recebe-a sem elas, por isso é assim que é passada aqui, e pô-la entre aspas uma segunda vez dá um erro de compilação. Mantém o bitmap em 400×120 e 8 bits como o deles e mais nada no ecrã de arranque se mexe.

Precisas das duas imagens. O qemu-server arranca qualquer VM Q35 com um disco EFI de 4M com OVMF_CODE_4M.secboot.fd, a compilação com SMM obrigatório, e só usa o OVMF_CODE_4M.fd simples para i440fx24. Num Proxmox atual, a secboot é a que quase todos os convidados UEFI correm.

Compilada dessa forma, sem nada mudado na árvore do Proxmox além do bitmap e de duas strings, a imagem SMM arranca assim:

O ecrã de arranque de um convidado desenhado pela imagem OVMF recompilada, a mostrar um logótipo da Example Cloud onde estaria o do Proxmox

E a visão que o próprio convidado tem do seu firmware muda com ela, sem uma única opção -smbios na linha de comandos:

Lido dentro do convidado4.2026.08-1 do ProxmoxRecompilado da mesma árvore
Fabricante do firmwareProxmox distribution of EDK IIExample Cloud Ltd
Versão do firmware4.2026.08-14.2026.08-1+ec1
«UEFI is supported»presentepresente
Tabelas ACPIBGRT, WSMT e as restanteso mesmo conjunto

Isso faz do fabricante definido na compilação a melhor resposta para convidados UEFI. É o próprio tipo 0 do OVMF, por isso o bit UEFI fica no lugar sem ninguém ter de se lembrar do uefi=on. O caminho do args para o tipo 0 é para convidados SeaBIOS, e para quem não recompila firmware nenhum.

Duas formas de entregar o firmware novo a uma VM

O qemu-server tem fixo no código onde procura o firmware: o OVMF.pm tem uma tabela de caminhos em /usr/share/pve-edk2-firmware/, indexada por tipo de máquina e opções de Secure Boot, e não há opção nenhuma na configuração da VM, na GUI ou na API que escolha outro ficheiro24. Sobram dois caminhos.

Compilar o OVMF com a marca e as duas formas de o entregar a uma VMA árvore do Proxmoxpve-edk2-firmware 4.2026.08-1A tua marcaLogo.bmp + string do fabricanteMesma compilação, mesmas flagsOVMF_CODE_4M.fd + .secboot.fdA: desvio em cada nótodas as VMs UEFI o recebem,config das VMs inalteradaB: por VM através de argsescolhe VM a VM,ficheiros do Proxmox intactosapt full-upgradechega o firmware novo, o teu fica antigohook Post-Invokeversões diferentes: recompila antes de arrancar
Uma compilação, duas formas de entrar. Em qualquer delas, a próxima atualização instala o novo firmware do Proxmox ao lado do teu e deixa o teu como estava, e é por isso que existe o hook lá em baixo.

Caminho A: desviá-lo em cada nó. Diz ao dpkg que as duas imagens de código do Proxmox pertencem agora a outro sítio, e põe as tuas onde elas estavam:

D=/usr/share/pve-edk2-firmware
for f in OVMF_CODE_4M.fd OVMF_CODE_4M.secboot.fd; do
  dpkg-divert --package example-branding --add --rename --divert "$D/$f.distrib" "$D/$f"
  install -m 0644 "/root/branding/$f" "$D/$f"
done

A partir do próximo arranque, todas as VMs UEFI do nó arrancam com o teu firmware. Nenhuma alteração na configuração das VMs.

Caminho B: apontar VMs escolhidas para ele. Guarda as imagens no teu próprio diretório e substitui o firmware uma VM de cada vez. Desde que passou para -blockdev, o qemu-server liga a imagem de código como um nó de bloco chamado pflash0 e nomeia-o em -machine24, e o QEMU funde um segundo -machine da mesma maneira que funde o -boot, por isso o args pode acrescentar um nó seu e apontar o pflash0 para ele:

args: -blockdev driver=raw,node-name=brandcode,read-only=on,file.driver=file,file.filename=/usr/local/share/example-branding/OVMF_CODE_4M.secboot.fd -machine pflash0=brandcode

Isto foi testado pelo caminho mais longo. O firmware secboot do Proxmox foi ligado como pflash0 exatamente da forma como o qemu-server o faz, com SMM ligado, e depois essa linha args foi acrescentada a seguir, e o convidado arrancou a imagem com a marca, com o logótipo e a string do fabricante, que é de onde veio a captura de ecrã acima.

Caminho A, desvioCaminho B, args por VM
Que VMs o recebemtodas as VMs UEFI do nósó as VMs onde o definires
Ficheiros do Proxmoxmovidos para .distribintactos
Configuração da VMinalteradauma linha args, só root
O tipo de máquina tem de correspondertratado, as duas imagens são desviadastrabalho teu: imagem secboot para Q35
Desfazerdpkg-divert --remove --renameapagar a linha
Migraçãoo nó de destino também tem de estar desviadoo nó de destino tem de ter o ficheiro

A imagem de código tem cerca de 3,5 MB, contra um limite de 1 MiB por ficheiro no pmxcfs20. Como tal, não pode ir para /etc/pve, e seja qual for o caminho que escolhas, tem de ser posta em cada nó. Migra uma VM para um nó sem ela e tens um de dois resultados, consoante o caminho: o firmware e o logótipo do próprio Proxmox de volta no caminho A, ou no caminho B uma VM que nem sequer arranca porque o QEMU não consegue abrir um ficheiro que não está lá.

A atualização que te deixa para trás

Um desvio é a ferramenta certa para um logótipo. O firmware é diferente.

Um desvio significa que as atualizações do Proxmox deixam de chegar ao ficheiro. Foi exatamente isso que pediste. É também exatamente o que impede as correções de segurança do edk2 de chegarem aos teus convidados: o changelog do Proxmox para a 4.2026.08-1 abre com «Besides many bug and security fixes» e continua a listar uma correção para a CVE-2024-1374525, e uma compilação com a tua marca a partir da versão anterior não tem nada disso. Nada te avisa.

Isto foi testado, não presumido. Num contentor Debian trixie com o repositório do Proxmox, foi instalado o pve-edk2-firmware-ovmf 4.2025.05-3, as duas imagens de código foram desviadas, e o pacote foi atualizado para a 4.2026.08-1:

Depois da atualizaçãoResultado
dpkg-query -W pve-edk2-firmware-ovmf4.2026.08-1
A nova imagem do Proxmoxinstalada como OVMF_CODE_4M.fd.distrib, hash alterado
A imagem com a marcainalterada, ainda compilada a partir da 4.2025.05-3
Alguma coisa na consola sobre issonada, até ao hook abaixo

Por isso acrescenta um hook. O apt corre uma lista de comandos DPkg::Post-Invoke depois de cada execução do dpkg26. Regista a versão do Proxmox a partir da qual compilaste, e compara depois de cada uma:

cat > /usr/local/sbin/example-branding-check <<'EOF'
#!/bin/sh
built=$(cat /usr/local/share/example-branding/ovmf.built-from 2>/dev/null)
now=$(dpkg-query -W -f '${Version}' pve-edk2-firmware-ovmf 2>/dev/null)
[ "$built" = "$now" ] && exit 0
echo "W: branded OVMF was built from pve-edk2-firmware-ovmf $built, Proxmox now ships $now." >&2
echo "W: guests still boot the old firmware. Rebuild before the next VM restart." >&2
exit 0
EOF
chmod +x /usr/local/sbin/example-branding-check
echo 'DPkg::Post-Invoke { "/usr/local/sbin/example-branding-check"; };' \
  > /etc/apt/apt.conf.d/80example-branding

Nessa mesma atualização imprimiu:

W: branded OVMF was built from pve-edk2-firmware-ovmf 4.2025.05-3, Proxmox now ships 4.2026.08-1.
W: guests still boot the old firmware. Rebuild before the next VM restart.

Sai com 0 de propósito. O apt aborta se um comando Post-Invoke falhar26, e uma verificação de marca não é razão para deixar um nó meio atualizado. Um aviso bem alto chega.

Mais uma coisa. Os reinícios. Um convidado só apanha firmware novo quando o seu processo QEMU reinicia, por isso uma recompilação significa um parar e arrancar a partir do Proxmox em vez de um reinício de dentro do convidado, que é exatamente a forma como as próprias atualizações de firmware do Proxmox chegam também a uma VM em execução. Só que essas não precisam que te lembres de recompilar primeiro.

Ou deixa o firmware do Proxmox em paz

Todos os caminhos para o logótipo até aqui mudam o firmware, e a última secção é a fatura disso. Há um que não muda, e foi prototipado para este artigo.

Um dispositivo PCI no QEMU pode levar uma ROM opcional, qualquer ficheiro que indiques com romfile=27, e o OVMF corre o controlador EFI que lá encontrar. A compilação do Proxmox corre-o esteja assinado ou não: o OVMF define PcdOptionRomImageVerificationPolicy como 0x00, executar sempre28. O OVMF desenha o seu próprio logótipo tarde na seleção do dispositivo de arranque29 e só constrói a BGRT no ReadyToBoot, o momento antes de passar o controlo a um carregador de arranque. E o controlador BGRT do edk2 aceita uma imagem de substituição através do EDKII_BOOT_LOGO2_PROTOCOL, reconstruindo a tabela no ReadyToBoot sempre que a imagem mudou30.

É tudo o que precisa. O controlador espera pelo ReadyToBoot em TPL_NOTIFY, que corre antes do handler TPL_CALLBACK do próprio controlador BGRT, limpa o ecrã, desenha o seu logótipo e entrega a mesma imagem. Compilado, é um único ficheiro de 8 KB, ligado com uma linha:

args: -device pci-testdev,romfile=/etc/pve/branding/brandrom.rom

Com 8 KB fica bem dentro do limite de 1 MiB do pmxcfs20, por isso, ao contrário de uma imagem de firmware de 3,5 MB, pode viver em /etc/pve e seguir a VM para todos os nós.

Foi testado contra o próprio firmware do Proxmox, tirado diretamente do pve-edk2-firmware-ovmf 4.2026.08-1: OVMF_CODE_4M.secboot.fd com as chaves da Microsoft pré-inscritas em OVMF_VARS_4M.ms.fd, em Q35 com SMM, e arrancado através do shim assinado do Fedora para que o Secure Boot estivesse ligado e a ser imposto:

Lido a partir do convidadoSem a ROMCom a ROM
Variável SecureBoot11
No ecrão logótipo do Proxmoxo do Proxmox durante cerca de 250 ms, depois o teu
Imagem BGRT, 400×120 em 440,340a do Proxmox, SHA-256 be5afe4b…a da ROM, SHA-256 6c494576…
Ficheiros de firmware alteradosnenhumnenhum

A imagem que um convidado leu de volta da sua tabela BGRT com a ROM opcional ligada: um logótipo da Example Cloud, com a legenda drawn by an option ROM

A última linha é o ponto. O firmware do Proxmox fica intacto, por isso a próxima versão de segurança deles chega aos teus convidados no próximo reinício, e nada da secção anterior se aplica.

Não é de graça:

CustoPorquê
O logótipo do Proxmox aparece durante cerca de um quarto de segundoo OVMF desenha-o antes de qualquer controlador de ROM opcional chegar ao ecrã; só uma recompilação evita isso
O convidado vê mais um dispositivo PCI, sem controladora ROM tem de ir num dispositivo, e o pci-testdev é o do QEMU que não faz nada
O tipo 0 continua a dizer Proxmoxa string do fabricante está compilada; define-a através de args com uefi=on, como acima
Só rooté uma linha args

E a descoberta por baixo disto tem de ser dita sem rodeios. Um controlador não assinado correu em firmware num convidado com as chaves da Microsoft inscritas e o Secure Boot a ser imposto, porque o OVMF do Proxmox não verifica ROMs opcionais. Aqui, isso é útil. Também significa que, neste firmware, o Secure Boot verifica carregadores de arranque, não o que quer que a configuração de hardware da VM ligue, e como só o root escreve args, isso é uma questão de quem tem root nos teus nós.

É um protótipo. Correu no QEMU 10.2.2 com o firmware do Proxmox, ainda não num nó Proxmox, e o que se segue é código-fonte, não um produto:

github.com/damo2929/RebrandPCIRom: o controlador em ROM opcional, o conversor de logótipos e a compilação em contentor.

A interface web são dois pacotes

O logótipo em cima à esquerda da interface web não está no pve-manager. O Workspace.js pede um componente proxmoxLogoSvg com o prefixo pwt, e esse vive no proxmox-widget-toolkit, que o Backup Server e o Mail Gateway partilham31. Só os ícones do separador estão no pve-manager:

O quêFicheiroPacote
Logótipo do cabeçalho, desenhado a 200×35/usr/share/javascript/proxmox-widget-toolkit/images/proxmox_logo.svgproxmox-widget-toolkit
Ícone do separador do navegador/usr/share/pve-manager/images/favicon.icopve-manager
Ícone de 128×128, também o ícone tátil/usr/share/pve-manager/images/logo-128.pngpve-manager

Os três são ficheiros simples, por isso isto é trabalho para o dpkg-divert, e aqui o custo da última secção não se aplica de todo, porque um logótipo não tem correções de segurança para perder e o convidado de ninguém fica menos seguro por um nó ainda servir o favicon do mês passado.

divert() {
  dpkg-divert --package example-branding --add --rename --divert "$1.distrib" "$1"
  install -m 0644 "$2" "$1"
}
divert /usr/share/javascript/proxmox-widget-toolkit/images/proxmox_logo.svg /root/branding/logo.svg
divert /usr/share/pve-manager/images/favicon.ico   /root/branding/favicon.ico
divert /usr/share/pve-manager/images/logo-128.png  /root/branding/logo-128.png

Testado no mesmo contentor, contra pacotes reais:

PassoResultado
Desvio no proxmox-widget-toolkit 5.2.9, instalar o SVG próprioo SVG do Proxmox renomeado para proxmox_logo.svg.distrib
Atualizar para a 5.2.10o SVG próprio continua no lugar, a cópia 5.2.10 do Proxmox em .distrib
dpkg --verify proxmox-widget-toolkitsem queixas, o dpkg sabe do desvio
apt-get install --reinstall proxmox-widget-toolkito SVG próprio continua no lugar
dpkg-divert --remove --renameo original do Proxmox de volta, byte a byte

Há duas coisas que continuam a ser do Proxmox. A imagem do cabeçalho é desenhada numa caixa fixa de 200×35, por isso desenha o teu SVG nesse formato ou fica espremido. E o texto alt diz Proxmox e a imagem leva a https://www.proxmox.com, ambos escritos no componente JavaScript em vez de num ficheiro que possas desviar31. Mudar isso significa remendar um bundle minificado que se parte a cada atualização. Não vale a pena por causa de um texto alternativo.

O que a licença e a marca registada do Proxmox te pedem

O Proxmox VE está licenciado sob a AGPL versão 332, e a secção 13 dessa licença é a cláusula de rede: «if you modify the Program, your modified version must prominently offer all users interacting with it remotely through a computer network … an opportunity to receive the Corresponding Source of your version»33. Trocar três imagens conta como modificar o Programa? Isso é para um advogado. A resposta barata é pôr as tuas imagens e o script de desvio num sítio público e ligá-lo a partir da página de início de sessão. Não custa nada e arruma a questão.

O lado da marca registada é mais claro. O kit de imprensa do Proxmox diz «Don’t alter the logo or incorporate the logo or symbol into your logo»34. Por isso substitui o deles por inteiro pelo teu, nunca uma versão recolorida ou retrabalhada do deles, e mantém o Proxmox fora do nome do teu produto.

O teu nome nele significa a tua manutenção

Pôr a tua marca numa VM é barato. Meia dúzia de strings SMBIOS, um JPEG, um bitmap e três imagens numa interface web: uma tarde de trabalho, a maior parte dela a descobrir onde as coisas vivem.

Mantê-la é que é o trabalho. E é também a parte que se salta.

As strings SMBIOS e o ecrã inicial tomam conta de si próprios, porque vivem em configuração em que nenhum pacote vai alguma vez tocar, e o logótipo da interface web toma conta de si próprio porque o dpkg foi avisado dele. O firmware não. No dia em que pões o teu logótipo numa imagem de firmware, ficaste com um pedaço do processo de lançamento de outra pessoa, e o Proxmox compila, testa e distribui firmware novo com correções de segurança que os clientes deles recebem na próxima atualização, e os teus recebem quando te lembrares de recompilar.

Essa troca está bem feita conscientemente. Uma empresa de alojamento cujos convidados arrancam com firmware duas versões atrás porque o logótipo importou mais do que o changelog não construiu um produto. Construiu um autocolante.

Se o teu nome está no ecrã de arranque, o firmware por trás dele é teu para manter atualizado, seja quem for que o escreveu. Ninguém vai verificar. É exatamente por isso que tem de ser feito.


  1. UEFI Forum, ACPI Specification 6.6, §5.2.23 Boot Graphics Resource Table — «The Boot Graphics Resource Table (BGRT) is an optional table that provides a mechanism to indicate that an image was drawn on the screen during boot». Cópia arquivada; a página ativa devolve 403 a pedidos automáticos. ↩︎

  2. Microsoft Learn, Boot screen components — «This is the standard interface that Windows uses to access the logo.» ↩︎

  3. Fedora Project, Changes/FlickerFreeBoot — «a new plymouth theme which incorporates the firmware’s bootsplash image»; o plymouth.spec do Fedora torna o bgrt o tema por omissão. ↩︎

  4. Debian, dpkg-divert(1), trixie — «File diversions are a way of forcing dpkg(1) not to install a file into its location, but to a diverted location.» ↩︎

  5. DMTF, DSP0134 System Management BIOS Reference Specification 3.10.0 — tipo 1 System Information, tipo 2 placa base, tipo 3 «the system’s mechanical enclosure(s)», tipo 11 «free-form strings defined by the OEM». ↩︎

  6. Proxmox VE, qm.conf(5) — smbios1: «Specify SMBIOS type 1 fields»; args: «Arbitrary arguments passed to kvm … this option is for experts only.» ↩︎ ↩︎

  7. qemu-server, src/PVE/QemuServer.pm, the smbios1 format and command-line builder — todos os campos exceto uuid têm o padrão [A-Za-z0-9+\/]+={0,2}; os valores são descodificados quando base64 está definido. ↩︎

  8. pve-manager, www/manager6/Parser.js, printQemuSmbios1 — «smbios values can be arbitrary, so encode and mark config as such». ↩︎

  9. qemu-server, src/PVE/API2/Qemu.pm, clone — «auto generate a new uuid», os outros campos do smbios1 são mantidos. ↩︎ ↩︎

  10. QEMU, System Emulation, Invocation — campos do -smbios por tipo; -acpitable «For file=, take whole ACPI table from the specified files, including all ACPI headers»; -boot «Currently Seabios for X86 system support it.» ↩︎ ↩︎ ↩︎

  11. edk2-stable202608, OvmfPkg/SmbiosPlatformDxe/SmbiosPlatformDxe.c — o OVMF acrescenta o seu próprio tipo 0 só quando NeedSmbiosType0 ainda está definido depois de percorrer as tabelas do QEMU. ↩︎

  12. qemu-server, src/PVE/QemuServer.pm, custom args — os args são divididos e acrescentados ao fim da linha de comandos. ↩︎

  13. qemu-server, src/PVE/API2/Qemu.pm, config permission checks — o smbios1 é uma opção do tipo hardware que precisa de VM.Config.HWType; o caso genérico «catches args, lock, etc.» e termina com «only root can set». ↩︎

  14. qemu-server, src/PVE/QemuServer.pm, the name option — format => 'dns-name'. ↩︎

  15. qemu-server, src/PVE/QemuServer.pm, vmgenid — «notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template)». ↩︎

  16. qemu-server, src/PVE/QemuServer/Memory.pm — memória default => 512; cores e sockets têm 1 por omissão no QemuServer.pm. ↩︎

  17. qemu-server, src/PVE/QemuServer.pm, vm_start — lock_config na linha 5457, exec_hookscript($conf, $vmid, 'pre-start', 1) na 5581, e config_to_command na 5634 com o mesmo $conf, sem ser recarregado pelo meio. ↩︎

  18. qemu-server, src/PVE/QemuServer.pm, -boot — menu=on,strict=on,reboot-timeout=1000,splash=/usr/share/qemu-server/bootsplash.jpg. ↩︎

  19. edk2-stable202608, OvmfPkg/Library/QemuBootOrderLib/QemuBootOrderLib.c — o OVMF lê etc/boot-menu-wait, o valor do splash-time, e mais nada do -boot. ↩︎

  20. pve-cluster, src/pmxcfs/memdb.h — #define MEMDB_MAX_FILE_SIZE (1024 * 1024) // 1 MiB. ↩︎ ↩︎ ↩︎

  21. SeaBIOS, src/jpeg.c — o PIC escreve primeiro o azul em little-endian, o PIC_32 na linha 946 escreve primeiro o vermelho sem ramo de endianness; ERR_NOT_SEQUENTIAL_DCT e ERR_NOT_YCBCR_221111 são os únicos formatos recusados. ↩︎ ↩︎

  22. SeaBIOS, vgasrc/svgamodes.c — o modo 0x111 é 640×480 a 16 bits, o 0x142 é 640×480 a 32. ↩︎

  23. pve-edk2-firmware, debian/rules at 4.2026.08-1 — cp -a debian/Logo.bmp MdeModulePkg/Logo/Logo.bmp, a string PcdFirmwareVendor e as flags de compilação do OVMF. ↩︎ ↩︎ ↩︎

  24. qemu-server, src/PVE/QemuServer/OVMF.pm — a tabela de firmware fixa no código em /usr/share/pve-edk2-firmware/, a escolha do SMM, e o nó de bloco pflash0. ↩︎ ↩︎ ↩︎

  25. pve-edk2-firmware, debian/changelog — 4.2026.08-1: «Besides many bug and security fixes … fix CVE-2024-13745». ↩︎

  26. Debian, apt.conf(5), trixie — «Pre-Invoke, Post-Invoke: This is a list of shell commands to run before/after invoking dpkg(1) … should any fail APT will abort.» ↩︎ ↩︎

  27. QEMU v11.0.3, hw/pci/pci.c — DEFINE_PROP_STRING("romfile", PCIDevice, romfile), uma propriedade que todos os dispositivos PCI têm. ↩︎

  28. edk2-stable202608, OvmfPkg/OvmfPkgIa32X64.dsc — gEfiSecurityPkgTokenSpaceGuid.PcdOptionRomImageVerificationPolicy|0x00, o ficheiro de plataforma que o Proxmox compila. ↩︎

  29. edk2-stable202608, OvmfPkg/Library/PlatformBootManagerLib/BdsPlatform.c — BootLogoEnableLogo (), chamado a partir de PlatformBootManagerAfterConsole. ↩︎

  30. edk2-stable202608, BootGraphicsResourceTableDxe.c — o SetBootLogo2 na linha 239 copia a imagem; o handler do ReadyToBoot na 417 desinstala e reinstala a tabela «If BGRT data change happens». ↩︎

  31. proxmox-widget-toolkit, src/Logo.js — proxmoxLogoSvg, 200×35, alt: 'Proxmox', com ligação para proxmox.com; usado a partir do Workspace.js do pve-manager com prefix: 'pwt'. ↩︎ ↩︎

  32. Proxmox VE wiki, FAQ — «Proxmox VE code is licensed under the GNU Affero General Public License, version 3.» ↩︎

  33. GNU Affero General Public License v3, §13 Remote Network Interaction — citada na íntegra no texto acima. ↩︎

  34. Proxmox, Media kit — «Don’t alter the logo or incorporate the logo or symbol into your logo.» ↩︎