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 olha | O que lê | De quem é o nome |
|---|---|---|
| Ecrã de arranque | o logótipo do Proxmox | Proxmox |
| Fabricante do firmware (SMBIOS tipo 0) | Proxmox distribution of EDK II | Proxmox |
| Versão do firmware | 4.2026.08-1 | a versão do pacote do Proxmox |
| Fabricante do sistema (tipo 1) | QEMU | QEMU |
| Nome do produto (tipo 1) | Standard PC (Q35 + ICH9, 2009) | QEMU |
| Fabricante do chassis (tipo 3) | QEMU | QEMU |
| Placa base (tipo 2) | nem sequer existe | ninguém |
| Interface web de gestão | o logótipo do Proxmox, em cima à esquerda | Proxmox |
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.
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 vive | Como lá chega | Sobrevive a uma atualização | O que te custa |
|---|---|---|---|
A configuração da VM em /etc/pve | smbios1, e args para tudo o resto | Sim, a configuração nunca é tocada por um pacote | args é só para root, e não aparece na GUI |
| Um ficheiro que o dpkg foi instruído a deixar em paz | dpkg-divert | Sim, a cópia do pacote vai para um nome .distrib | As 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 args | Sim, nenhum pacote é dono dele | Tens 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ê:
| Estrutura | Campo | De origem | Com a marca |
|---|---|---|---|
| Tipo 0 | Vendor | Proxmox distribution of EDK II | Example Cloud Ltd |
| Tipo 0 | Version | 4.2026.08-1 | EC-FW 1.0 |
| Tipo 1 | Manufacturer | QEMU | Example Cloud Ltd |
| Tipo 1 | Product Name | Standard PC (Q35 + ICH9, 2009) | EC Compute Instance |
| Tipo 1 | Family | não especificado | General Purpose |
| Tipo 2 | Manufacturer | estrutura ausente | Example Cloud Ltd |
| Tipo 2 | Product Name | estrutura ausente | EC Virtual Board |
| Tipo 3 | Manufacturer | QEMU | Example Cloud Ltd |
| Tipo 3 | Asset Tag | não especificado | EC-ASSET-123 |
| Tipo 11 | String 1 | estrutura ausente | example-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 1 | Tirado de | Para uma VM de 4 núcleos e 16 GiB chamada web-01, com as etiquetas production;web |
|---|---|---|
| Serial Number | name | web-01 |
| SKU Number | cores × sockets, e memory | ec-4c16g |
| Family | a primeira entrada em tags | production |
| UUID | o UUID do smbios1 que já tem | inalterado |
| Manufacturer, Product | as tuas strings fixas | Example 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ótipo | um JPEG que o QEMU entrega no arranque | um bitmap compilado dentro do firmware |
| O ficheiro do Proxmox | /usr/share/qemu-server/bootsplash.jpg, 640×480 | Logo.bmp, 400×120, 8 bits, compilado em OVMF_CODE_4M*.fd |
| Pacote dono | qemu-server | pve-edk2-firmware-ovmf |
| Mudá-lo por VM | args: -boot splash=… | args a apontar a VM para outro firmware |
| Mudá-lo sem recompilar nada | sim | não |
| Chega ao SO convidado através da BGRT | não | sim |
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ção | Porquê | O que acontece caso contrário |
|---|---|---|
| JPEG ou BMP de 24 bits | o QEMU verifica o ficheiro antes de a VM arrancar | splash file … format not recognized; must be JPEG or 24 bit BMP |
| JPEG baseline, croma 4:2:0 | o descodificador do SeaBIOS não trata mais nada21 | ERR_NOT_SEQUENTIAL_DCT ou ERR_NOT_YCBCR_221111, e um ecrã em branco |
| 640×480, como o do próprio Proxmox | o SeaBIOS pede à VGA BIOS um modo exatamente do tamanho da imagem | nenhum 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:

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:
| Firmware | Modo VBE para 640×480 | Bits por píxel | Cores |
|---|---|---|---|
O SeaBIOS 1.17.0 pré-compilado do QEMU upstream, tal como o pve-qemu-kvm 11.0.3-4 o distribui | 0x111 | 16 | certas, quantizadas para 65 536 |
A compilação própria seabios 1.17.0-10 do Fedora 44 | 0x142 | 32 | vermelho 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:

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 convidado | 4.2026.08-1 do Proxmox | Recompilado da mesma árvore |
|---|---|---|
| Fabricante do firmware | Proxmox distribution of EDK II | Example Cloud Ltd |
| Versão do firmware | 4.2026.08-1 | 4.2026.08-1+ec1 |
| «UEFI is supported» | presente | presente |
| Tabelas ACPI | BGRT, WSMT e as restantes | o 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.
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, desvio | Caminho B, args por VM | |
|---|---|---|
| Que VMs o recebem | todas as VMs UEFI do nó | só as VMs onde o definires |
| Ficheiros do Proxmox | movidos para .distrib | intactos |
| Configuração da VM | inalterada | uma linha args, só root |
| O tipo de máquina tem de corresponder | tratado, as duas imagens são desviadas | trabalho teu: imagem secboot para Q35 |
| Desfazer | dpkg-divert --remove --rename | apagar a linha |
| Migração | o nó de destino também tem de estar desviado | o 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ção | Resultado |
|---|---|
dpkg-query -W pve-edk2-firmware-ovmf | 4.2026.08-1 |
| A nova imagem do Proxmox | instalada como OVMF_CODE_4M.fd.distrib, hash alterado |
| A imagem com a marca | inalterada, ainda compilada a partir da 4.2025.05-3 |
| Alguma coisa na consola sobre isso | nada, 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 convidado | Sem a ROM | Com a ROM |
|---|---|---|
Variável SecureBoot | 1 | 1 |
| No ecrã | o logótipo do Proxmox | o do Proxmox durante cerca de 250 ms, depois o teu |
| Imagem BGRT, 400×120 em 440,340 | a do Proxmox, SHA-256 be5afe4b… | a da ROM, SHA-256 6c494576… |
| Ficheiros de firmware alterados | nenhum | nenhum |

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:
| Custo | Porquê |
|---|---|
| O logótipo do Proxmox aparece durante cerca de um quarto de segundo | o 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 controlador | a ROM tem de ir num dispositivo, e o pci-testdev é o do QEMU que não faz nada |
| O tipo 0 continua a dizer Proxmox | a 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ê | Ficheiro | Pacote |
|---|---|---|
| Logótipo do cabeçalho, desenhado a 200×35 | /usr/share/javascript/proxmox-widget-toolkit/images/proxmox_logo.svg | proxmox-widget-toolkit |
| Ícone do separador do navegador | /usr/share/pve-manager/images/favicon.ico | pve-manager |
| Ícone de 128×128, também o ícone tátil | /usr/share/pve-manager/images/logo-128.png | pve-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:
| Passo | Resultado |
|---|---|
Desvio no proxmox-widget-toolkit 5.2.9, instalar o SVG próprio | o SVG do Proxmox renomeado para proxmox_logo.svg.distrib |
| Atualizar para a 5.2.10 | o SVG próprio continua no lugar, a cópia 5.2.10 do Proxmox em .distrib |
dpkg --verify proxmox-widget-toolkit | sem queixas, o dpkg sabe do desvio |
apt-get install --reinstall proxmox-widget-toolkit | o SVG próprio continua no lugar |
dpkg-divert --remove --rename | o 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.
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. ↩︎
Microsoft Learn, Boot screen components — «This is the standard interface that Windows uses to access the logo.» ↩︎
Fedora Project, Changes/FlickerFreeBoot — «a new plymouth theme which incorporates the firmware’s bootsplash image»; o plymouth.spec do Fedora torna o
bgrto tema por omissão. ↩︎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.» ↩︎
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». ↩︎
Proxmox VE, qm.conf(5) —
smbios1: «Specify SMBIOS type 1 fields»;args: «Arbitrary arguments passed to kvm … this option is for experts only.» ↩︎ ↩︎qemu-server,
src/PVE/QemuServer.pm, thesmbios1format and command-line builder — todos os campos excetouuidtêm o padrão[A-Za-z0-9+\/]+={0,2}; os valores são descodificados quandobase64está definido. ↩︎pve-manager,
www/manager6/Parser.js,printQemuSmbios1— «smbios values can be arbitrary, so encode and mark config as such». ↩︎qemu-server,
src/PVE/API2/Qemu.pm, clone — «auto generate a new uuid», os outros campos dosmbios1são mantidos. ↩︎ ↩︎QEMU, System Emulation, Invocation — campos do
-smbiospor tipo;-acpitable«For file=, take whole ACPI table from the specified files, including all ACPI headers»;-boot«Currently Seabios for X86 system support it.» ↩︎ ↩︎ ↩︎edk2-stable202608,
OvmfPkg/SmbiosPlatformDxe/SmbiosPlatformDxe.c— o OVMF acrescenta o seu próprio tipo 0 só quandoNeedSmbiosType0ainda está definido depois de percorrer as tabelas do QEMU. ↩︎qemu-server,
src/PVE/QemuServer.pm, custom args — osargssão divididos e acrescentados ao fim da linha de comandos. ↩︎qemu-server,
src/PVE/API2/Qemu.pm, config permission checks — osmbios1é uma opção do tipo hardware que precisa deVM.Config.HWType; o caso genérico «catches args, lock, etc.» e termina com «only root can set». ↩︎qemu-server,
src/PVE/QemuServer.pm, thenameoption —format => 'dns-name'. ↩︎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)». ↩︎qemu-server,
src/PVE/QemuServer/Memory.pm— memóriadefault => 512;coresesocketstêm 1 por omissão noQemuServer.pm. ↩︎qemu-server,
src/PVE/QemuServer.pm,vm_start—lock_configna linha 5457,exec_hookscript($conf, $vmid, 'pre-start', 1)na 5581, econfig_to_commandna 5634 com o mesmo$conf, sem ser recarregado pelo meio. ↩︎qemu-server,
src/PVE/QemuServer.pm,-boot—menu=on,strict=on,reboot-timeout=1000,splash=/usr/share/qemu-server/bootsplash.jpg. ↩︎edk2-stable202608,
OvmfPkg/Library/QemuBootOrderLib/QemuBootOrderLib.c— o OVMF lêetc/boot-menu-wait, o valor dosplash-time, e mais nada do-boot. ↩︎pve-cluster,
src/pmxcfs/memdb.h—#define MEMDB_MAX_FILE_SIZE (1024 * 1024) // 1 MiB. ↩︎ ↩︎ ↩︎SeaBIOS,
src/jpeg.c— oPICescreve primeiro o azul em little-endian, oPIC_32na linha 946 escreve primeiro o vermelho sem ramo de endianness;ERR_NOT_SEQUENTIAL_DCTeERR_NOT_YCBCR_221111são os únicos formatos recusados. ↩︎ ↩︎SeaBIOS,
vgasrc/svgamodes.c— o modo0x111é 640×480 a 16 bits, o0x142é 640×480 a 32. ↩︎pve-edk2-firmware,
debian/rulesat 4.2026.08-1 —cp -a debian/Logo.bmp MdeModulePkg/Logo/Logo.bmp, a stringPcdFirmwareVendore as flags de compilação do OVMF. ↩︎ ↩︎ ↩︎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 blocopflash0. ↩︎ ↩︎ ↩︎pve-edk2-firmware,
debian/changelog— 4.2026.08-1: «Besides many bug and security fixes … fix CVE-2024-13745». ↩︎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.» ↩︎ ↩︎
QEMU v11.0.3,
hw/pci/pci.c—DEFINE_PROP_STRING("romfile", PCIDevice, romfile), uma propriedade que todos os dispositivos PCI têm. ↩︎edk2-stable202608,
OvmfPkg/OvmfPkgIa32X64.dsc—gEfiSecurityPkgTokenSpaceGuid.PcdOptionRomImageVerificationPolicy|0x00, o ficheiro de plataforma que o Proxmox compila. ↩︎edk2-stable202608,
OvmfPkg/Library/PlatformBootManagerLib/BdsPlatform.c—BootLogoEnableLogo (), chamado a partir dePlatformBootManagerAfterConsole. ↩︎edk2-stable202608,
BootGraphicsResourceTableDxe.c— oSetBootLogo2na linha 239 copia a imagem; o handler do ReadyToBoot na 417 desinstala e reinstala a tabela «If BGRT data change happens». ↩︎proxmox-widget-toolkit,
src/Logo.js—proxmoxLogoSvg, 200×35,alt: 'Proxmox', com ligação para proxmox.com; usado a partir doWorkspace.jsdo pve-manager comprefix: 'pwt'. ↩︎ ↩︎Proxmox VE wiki, FAQ — «Proxmox VE code is licensed under the GNU Affero General Public License, version 3.» ↩︎
GNU Affero General Public License v3, §13 Remote Network Interaction — citada na íntegra no texto acima. ↩︎
Proxmox, Media kit — «Don’t alter the logo or incorporate the logo or symbol into your logo.» ↩︎