Що бачить твій клієнт, коли завантажується твоя VM

Ти продаєш віртуальні машини під власним ім’ям. Клієнт вмикає одну, і перше, що з’являється на екрані, це чужий логотип.

Це стандартна VM у Proxmox. Нічого не зламано, і Proxmox нічого поганого не роблять: це їхній продукт і їхнє ім’я, вони написали прошивку й інтерфейс, у якому воно з’являється, і мають повне право його туди поставити, так само як виробник серверів ставить свій значок на передню панель корпусу. Просто воно не твоє.

Логотип це лише початок. Ось що повідомляє стандартний гість UEFI на поточній прошивці Proxmox, pve-edk2-firmware 4.2026.08-1, прочитане зсередини гостя через dmidecode:

Де гість дивитьсяЩо він читаєЧиє ім’я
Екран завантаженнялоготип ProxmoxProxmox
Постачальник прошивки (SMBIOS тип 0)Proxmox distribution of EDK IIProxmox
Версія прошивки4.2026.08-1версія пакета Proxmox
Виробник системи (тип 1)QEMUQEMU
Назва продукту (тип 1)Standard PC (Q35 + ICH9, 2009)QEMU
Виробник корпусу (тип 3)QEMUQEMU
Системна плата (тип 2)взагалі відсутнянічиє
Вебінтерфейс керуваннялоготип Proxmox, угорі ліворучProxmox

І на прошивці логотип при завантаженні теж не зупиняється. Прошивка UEFI передає намальоване зображення операційній системі через таблицю ACPI під назвою BGRT, Boot Graphics Resource Table, яка існує, щоб сказати, що «an image was drawn on the screen during boot»1, а операційна система потім малює його знову на власному екрані завантаження. Fisher-Price OS (Windows) ставить його над своїм коліщатком, а Microsoft називає BGRT «the standard interface that Windows uses to access the logo»2. Типова тема Plymouth у Fedora робить те саме в Linux3. Тож гість на прошивці Proxmox показує логотип Proxmox двічі, ще до того, як хтось увійшов.

Нічого з цього не важко змінити. Важко зберегти зміненим. Наступний apt full-upgrade тихо поверне половину назад, а та половина, яку він не повертає, якраз та, що має тебе турбувати, і про неї здебільшого цей допис.

Де кожен елемент бренду входить у завантаженняУвімкненняQEMU будуєSMBIOS і ACPIз конфігураціїПрошивкаOVMF малює свійвбудований логотип,SeaBIOS заставкуПередачатаблиці SMBIOS,ACPI з BGRTі MSDMЕкран ОСперемальовуєлоготип прошивкиз BGRTПрацюючий гістьчитає рядки,активація читаєключ MSDMконфігурація VMфайл пакетаконфігурація VMфайл пакетаконфігурація VMживе в /etc/pve, переживає кожне оновленняживе під /usr/share, apt його замінює
Бренд потрапляє в завантаження в п’яти місцях. Три з них беруться з власної конфігурації VM і переживають будь-що, що робить apt. Два беруться з файлів, які належать пакету Proxmox, і саме їх оновлення забирає назад.

Таблиця MSDM у цій передачі зовсім не про бренд. Вона несе ліцензійний ключ, і перенесенню його у VM присвячено окремий допис: Перенесення ліцензії OEM у VM Proxmox.

Усе під /usr/share належить apt

Одне правило вирішує кожен вибір нижче. Файл, який встановив пакет, це файл пакета. Відредагуй його на місці, і наступне оновлення цього пакета мовчки перезапише твою правку, бо, з погляду dpkg, він лише кладе власний файл туди, де його залишив.

Тож кожен елемент бренду мусить жити там, чим apt не володіє. На вузлі Proxmox таких місць три, і кожне коштує чогось свого:

Де живеЯк туди потрапляєПереживає оновленняЧого це тобі коштує
Конфігурація VM у /etc/pvesmbios1, а для решти argsТак, пакети конфігурацію ніколи не чіпаютьargs лише для root і не показується в GUI
Файл, який dpkg наказано не чіпатиdpkg-divertТак, копія пакета натомість іде під ім’я .distribОновлення більше не доходять до файлу, а це важить, коли файл є прошивкою
Твій власний каталог, поза деревом пакетів/usr/local, з посиланням з argsТак, жоден пакет ним не володієЙого треба самому покласти на кожен вузол

Власний опис диверсії від Debian найясніший: «a way of forcing dpkg not to install a file into its location, but to a diverted location»4. Це покриває вебінтерфейс. Для прошивки це один із двох варіантів, і небезпечніший.

Корпус це жменька рядків і перевірка прав

SMBIOS це таблиця, якою машина описує себе: хто її зробив, яка це модель, її серійний номер, що за плата й корпус5. Її читає dmidecode, її читає кожен інструмент інвентаризації, який ти будь-коли спрямовував на мережу, її читає панель системної інформації Fisher-Price OS (Windows), і так само її читає більшість перевірок ліцензій, які вирішують, чи взагалі запуститься програма на певній машині. На VM її пише QEMU. Звідси QEMU і Standard PC у таблиці вище.

Тип 1 через smbios1

Proxmox відкриває в конфігурації VM одну структуру SMBIOS: тип 1, System Information, як smbios16. Вона приймає manufacturer, product, version, serial, sku, family і uuid.

Підступ у qemu-server, а не в документації. Кожне поле, крім uuid, мусить відповідати шаблону base64, [A-Za-z0-9+\/]+={0,2}, тож звичайне значення з пробілом відхиляється одразу. Справжні рядки кодують у base64 із встановленим base64=1, а qemu-server декодує їх назад, перш ніж зібрати командний рядок QEMU7. Редактор SMBIOS у GUI робить це при кожному збереженні, з коментарем «smbios values can be arbitrary, so encode and mark config as such»8. У командному рядку це твоя робота:

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')"

Зверни увагу, що uuid повертається назад. Це ідентичність машини гостя, а все, що ти передаєш у --smbios1, зберігається як увесь параметр цілком, тож спершу прочитай його й збережи.

Брендуй шаблон, а не кожну VM. Клон у Proxmox отримує щойно згенерований UUID і зберігає всі інші поля smbios1, тож кожен клон виходить із власною ідентичністю й твоїми рядками9, з одним винятком, про нього нижче.

Типи 0, 2, 3 і 11 через args

smbios1 закінчується на типі 1. Постачальник прошивки, системна плата, корпус і рядки OEM ідуть через args, рядок, який Proxmox передає прямо в QEMU і який його власна документація називає «for experts only»6. Параметр QEMU -smbios приймає поля для кожного типу10:

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'

Завантажений у QEMU з цими рядками, dmidecode гостя читає:

СтруктураПолеСтандартноЗ брендом
Тип 0VendorProxmox distribution of EDK IIExample Cloud Ltd
Тип 0Version4.2026.08-1EC-FW 1.0
Тип 1ManufacturerQEMUExample Cloud Ltd
Тип 1Product NameStandard PC (Q35 + ICH9, 2009)EC Compute Instance
Тип 1Familyне вказаноGeneral Purpose
Тип 2Manufacturerструктура відсутняExample Cloud Ltd
Тип 2Product Nameструктура відсутняEC Virtual Board
Тип 3ManufacturerQEMUExample Cloud Ltd
Тип 3Asset Tagне вказаноEC-ASSET-123
Тип 11String 1структура відсутняexample-cloud:instance=123

Дорогою трапилися чотири пастки. Усі чотири мовчазні.

Якщо задати тип 0, зникає «UEFI is supported». OVMF пише власний тип 0 лише тоді, коли QEMU його не надав; цикл, що обходить таблиці QEMU, встановлює NeedSmbiosType0 = FALSE, щойно зустрічає тип 011. Твій рядок постачальника замінює рядок Proxmox, у цьому й сенс. Але тип 0 від QEMU замінює ще й характеристики прошивки OVMF, і без uefi=on рядок «UEFI is supported» зникає з dmidecode. Поверни його через uefi=on. Для гостей UEFI рядку постачальника все одно є кращий дім, усередині самої прошивки, про це далі.

Тип корпусу задати не можна. Тип 3 у QEMU приймає manufacturer, version, serial, asset і sku, і більше нічого10. Він лишається Other.

Два визначення одного типу зливаються, і пізніше перемагає. qemu-server ставить свій -smbios type=1 на початку командного рядка, а твої args у самому кінці12, тож другий -smbios type=1,manufacturer=… в args не викидає перший: QEMU злив їх поле за полем, виробник прийшов з args, а UUID лишився там, куди його поставив smbios1. Це важить для четвертої пастки.

Дві половини мають різних власників. qemu-server перевіряє права параметр за параметром. smbios1 стоїть разом із параметрами обладнання й потребує VM.Config.HWType, а args падає до загального правила в самому низу, яке каже «only root can set»13. Плата, корпус, постачальник прошивки й рядки OEM належать лише тобі. Тип 1 ні. Будь-хто, кому ти дав права на обладнання, може його переписати, а в хостинговому продукті цілком можливо, що це клієнт. Якщо рядок виробника важить, задай його й в args. Пізніше визначення перемагає.

Серійний номер уже є в конфігурації

Більшість із того, що належить у тип 1, уже лежить у конфігурації VM. Ім’я стає добрим серійним номером, бо qemu-server приймає там лише ім’я DNS14: коротке, друковане, ніколи з комою, і єдине, що в VM клієнт упізнає.

Поле типу 1Береться зДля VM на 4 ядра й 16 GiB під назвою web-01, з тегами production;web
Serial Numbernameweb-01
SKU Numbercores × sockets, і memoryec-4c16g
Familyперший запис у tagsproduction
UUIDUUID smbios1, який уже єбез змін
Manufacturer, Productтвої власні сталі рядкиExample Cloud Ltd, EC Compute Instance

Дві речі лишаються осторонь. Вузол змінюється при кожній міграції, а vmgenid і має змінюватися: уся його робота в тому, щоб повідомити гостю, що його відновлено зі знімка чи збудовано із шаблону15. Жодне з них не ідентичність.

#!/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"

Типові значення взято з самого qemu-server, одне ядро, один сокет і 512 MiB16, тож конфігурація, яка їх не вказує, усе одно отримує правдивий SKU. Запущений проти конфігурації з таблиці, де qm підмінив скрипт, що її віддавав, записаний рядок пішов у QEMU декодованим так, як його декодує qemu-server, а dmidecode гостя прочитав назад web-01, ec-4c16g, production і UUID, який у нього вже був. VM без імені відхиляється, а не отримує порожній серійний номер.

Очевидний дім для цього це hookscript. І це неправильний дім. qemu-server запускає хук pre-start усередині блокування конфігурації, взятого для старту VM, і збирає командний рядок QEMU з конфігурації, яку завантажив до запуску хука17. Хук, що переписує серійний номер, змінює наступний старт, а не цей.

Тож запускай його зі своєї системи надання ресурсів, у чотирьох точках, де змінюються його вхідні дані: створення, клонування, перейменування й зміна розміру. Кусається саме клонування. Клон зберігає кожне поле smbios1, крім UUID9, тож пропусти його, і кожна VM, збудована з web-template, повідомлятиме ім’я шаблону як свій серійний номер.

Логотип завантаження живе у двох різних місцях

Який логотип показує гість, залежить від його прошивки. Дві прошивки, які постачає Proxmox, беруть його з зовсім різних місць:

SeaBIOS (bios: seabios, типово)OVMF (bios: ovmf, UEFI)
Звідки береться логотипJPEG, який QEMU передає при завантаженнірастрове зображення, вкомпільоване в прошивку
Файл Proxmox/usr/share/qemu-server/bootsplash.jpg, 640×480Logo.bmp, 400×120, 8 біт, вбудований в OVMF_CODE_4M*.fd
Пакет-власникqemu-serverpve-edk2-firmware-ovmf
Змінити для окремої VMargs: -boot splash=…args, що спрямовує VM на іншу прошивку
Змінити без жодної перезбіркитакні
Доходить до гостьової ОС через BGRTнітак

SeaBIOS: JPEG у командному рядку

qemu-server ставить той самий параметр -boot на кожну VM, яку запускає, menu=on,strict=on,reboot-timeout=1000,splash=/usr/share/qemu-server/bootsplash.jpg18. Документація QEMU каже, що зображення показується «when option splash=sp_name is given and menu=on, If firmware/BIOS supports them. Currently Seabios for X86 system support it»10. OVMF не бере звідти нічого, крім splash-time, який використовує як тайм-аут меню завантаження, і ніде в OvmfPkg немає жодного посилання на файл заставки19.

Замінити її можна одним рядком у конфігурації VM:

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

Другий -boot не воює з першим. QEMU зливає його так само, як зливає -smbios, пізніше значення перемагає, і коли було задано два файли заставки, на знімку екрана був другий. /etc/pve це правильний дім для файлу, бо це кластерна файлова система й кожен вузол бачить ту саму заставку, а її обмеження в 1 MiB на файл і близько не досягає JPEG на 640×48020.

Саме зображення має відповідати трьом умовам, і помилка в будь-якій коштує тобі логотипа або його кольорів:

УмоваЧомуЩо станеться інакше
JPEG або 24-бітний BMPQEMU перевіряє файл до старту VMsplash file … format not recognized; must be JPEG or 24 bit BMP
Baseline JPEG, кольоровість 4:2:0декодер SeaBIOS нічого іншого не обробляє21ERR_NOT_SEQUENTIAL_DCT або ERR_NOT_YCBCR_221111 і порожній екран
640×480, як у самого ProxmoxSeaBIOS просить у VGA BIOS режим рівно розміру зображеннянемає відповідного режиму, немає заставки

Більшість графічних інструментів типово пише baseline 4:2:0, тож звичайний спосіб втратити логотип це одна з опцій «зберегти для вебу», яка тихо вмикає прогресивне кодування, що виглядає однаково в кожному переглядачі зображень, який у тебе є, і лишає SeaBIOS не малювати взагалі нічого.

Пастка з кольорами

Ця коштувала півдня. Той самий JPEG, відмальований двома збірками SeaBIOS 1.17.0, виходить двох різних кольорів:

Заставка Example Cloud тричі: вихідний JPEG із синьою плиткою логотипа, SeaBIOS у тому вигляді, як його постачає Proxmox, із тим самим синім, і збірка SeaBIOS, що працює з 32 бітами на піксель, де синій став золотим

Причина в jpeg.c у SeaBIOS. Записувач для 24 бітів на піксель має гілку для little-endian, що ставить синій у перший байт кожного пікселя, а записувач для 32 бітів на піксель, PIC_32, такої гілки не має й пише туди червоний21. На кадровому буфері little-endian це міняє місцями червоний і синій. Синій виходить золотим, а помаранчевий вийшов би синім.

Який записувач працює, залежить від відеорежиму, який пропонує VGA BIOS:

ПрошивкаРежим VBE для 640×480Бітів на піксельКольори
Готова збірка SeaBIOS 1.17.0 від upstream QEMU, як її постачає pve-qemu-kvm 11.0.3-40x11116правильні, квантовані до 65 536
Власна збірка seabios 1.17.0-10 у Fedora 440x14232червоний і синій переставлено

Номери режимів узято з власної таблиці SeaBIOS22, а рядок Proxmox звірено із самими бінарними файлами в пакеті: байт у байт ідентичні готовій збірці QEMU rel-1.17.0-0-gb52ca86e094d. Тож на Proxmox твої кольори правильні, але їх лише 65 536, і тонкий градієнт піде смугами. А якщо твій логотип колись вийде не тих кольорів на якомусь іншому гіпервізорі, справа не у твоєму JPEG.

Логотип UEFI вкомпільовано в прошивку

Гості UEFI це складніша половина, і на сучасному Proxmox це більшість гостей.

Немає параметра заставки, який можна перевизначити. Логотип це растрове зображення всередині образу прошивки, і збірка Proxmox кладе його туди одним рядком у debian/rules:

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

Це копіює їхній Logo.bmp на 400×120 і 8 біт поверх логотипа TianoCore, перш ніж збирається edk223. Той самий файл задає постачальника прошивки як константу часу збірки, PcdFirmwareVendor=L"Proxmox distribution of EDK II", і саме звідти береться постачальник типу 0 у першій таблиці23.

Новий логотип, нова прошивка. Щоб отримати таку, що поводиться точнісінько як прошивка Proxmox, треба зібрати її точнісінько так, як це робить Proxmox: їхнє дерево на тегу, що відповідає пакету, який вони постачають, їхні патчі, їхні прапорці й одне замінене растрове зображення. pve-edk2-firmware 4.2026.08-1 фіксує edk2 на 2970e56, тобто на тегу 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

Прапорці взято з debian/rules у тому вигляді, у якому він є на цьому коміті. Зважай на рядок постачальника: їхній Makefile пише його в подвійних лапках, оболонка make їх знімає, і edk2 отримує його голим, тож саме так його тут і передано, а подвійне взяття в лапки дає помилку збірки. Тримай растрове зображення на 400×120 і 8 біт, як у них, і більше ніщо на екрані завантаження не зрушить.

Тобі потрібні обидва образи. qemu-server завантажує будь-яку VM Q35 з диском EFI на 4M з OVMF_CODE_4M.secboot.fd, збірки з обов’язковим SMM, а звичайний OVMF_CODE_4M.fd використовує лише для i440fx24. На поточному Proxmox образ secboot це те, на чому працює майже кожен гість UEFI.

Зібраний так, без жодних змін у дереві Proxmox, крім растрового зображення й двох рядків, образ із SMM завантажується ось так:

Екран завантаження гостя, намальований перезібраним образом OVMF, з логотипом Example Cloud там, де був би логотип Proxmox

І власний погляд гостя на свою прошивку змінюється разом із ним, без жодного параметра -smbios у командному рядку:

Прочитано всередині гостя4.2026.08-1 від ProxmoxПерезібрано з того самого дерева
Постачальник прошивкиProxmox distribution of EDK IIExample Cloud Ltd
Версія прошивки4.2026.08-14.2026.08-1+ec1
«UEFI is supported»єє
Таблиці ACPIBGRT, WSMT і рештатой самий набір

Через це постачальник, заданий під час збірки, кращий варіант для гостей UEFI. Це власний тип 0 від OVMF, тож біт UEFI лишається на місці без того, щоб хтось мусив пам’ятати про uefi=on. Шлях через args для типу 0 призначений для гостей SeaBIOS і для тих, хто прошивку взагалі не перезбирає.

Два способи віддати VM нову прошивку

qemu-server жорстко зашиває, де шукати прошивку: OVMF.pm тримає таблицю шляхів під /usr/share/pve-edk2-firmware/ з ключами за типом машини й параметрами Secure Boot, і ніде в конфігурації VM, у GUI чи в API немає параметра, що обирав би інший файл24. Лишається два шляхи.

Збірка брендованого OVMF і два способи віддати його VMДерево Proxmoxpve-edk2-firmware 4.2026.08-1Твій брендLogo.bmp + рядок постачальникаТа сама збірка, ті самі прапорціOVMF_CODE_4M.fd + .secboot.fdA: диверсія на кожному вузлікожна VM UEFI отримує,без змін конфігурації VMB: для окремої VM через argsвмикаєш по одній VM,файли Proxmox не чіпаноapt full-upgradeприходить нова прошивка Proxmox, твоя лишається староюХук Post-Invokeверсії різні, тож перезбери до наступного старту
Одна збірка, два шляхи. Так чи інакше наступне оновлення встановлює нову прошивку Proxmox поряд із твоєю і лишає твою як була, тому й існує хук унизу.

Шлях A: диверсія на кожному вузлі. Скажи dpkg, що два образи коду Proxmox тепер належать в іншому місці, і поклади свої туди, де були вони:

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

З наступного старту кожна VM UEFI на вузлі завантажує твою прошивку. Жодних змін конфігурації VM.

Шлях B: спрямуй на неї вибрані VM. Тримай образи у власному каталозі й перевизначай прошивку по одній VM. Відколи перейшов на -blockdev, qemu-server під’єднує образ коду як блочний вузол під назвою pflash0 і називає його в -machine24, а QEMU зливає другий -machine так само, як зливає -boot, тож args може додати власний вузол і спрямувати pflash0 на нього:

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

Це перевірено довгим шляхом. Прошивку secboot від Proxmox під’єднали як pflash0 рівно так, як це робить qemu-server, з увімкненим SMM, потім після неї додали цей рядок args, і гість завантажив брендований образ і з логотипом, і з рядком постачальника, звідки й узявся знімок екрана вище.

Шлях A, диверсіяШлях B, args для окремої VM
Які VM це отримуютькожна VM UEFI на вузлілише VM, де ти це задав
Файли Proxmoxперенесено в .distribне чіпано
Конфігурація VMбез змінрядок args, лише root
Тип машини має збігатисявраховано, диверсія на обох образахтвоя справа: образ secboot для Q35
Скасуванняdpkg-divert --remove --renameвидалити рядок
Міграціяна цільовому вузлі теж має бути диверсіяна цільовому вузлі має бути файл

Образ коду важить близько 3,5 MB, а обмеження pmxcfs 1 MiB на файл20. Тож у /etc/pve він не влізе, і хоч яким шляхом ти підеш, його треба покласти на кожен вузол. Перенеси VM на вузол без нього, і отримаєш один із двох результатів, залежно від шляху: за шляху A знову власну прошивку й логотип Proxmox, а за шляху B VM, яка взагалі не запуститься, бо QEMU не може відкрити файл, якого немає.

Оновлення, яке лишає тебе позаду

Диверсія це правильний інструмент для логотипа. З прошивкою інакше.

Диверсія означає, що оновлення Proxmox більше не доходять до файлу. Це рівно те, про що ти просив. Це також рівно те, що не пускає виправлення безпеки edk2 до твоїх гостей: журнал змін Proxmox для 4.2026.08-1 починається з «Besides many bug and security fixes» і далі перелічує виправлення CVE-2024-1374525, а брендована збірка з попереднього випуску не має з цього нічого. Ніщо тобі про це не скаже.

Це перевірено, а не припущено. У контейнері Debian trixie з репозиторієм Proxmox встановили pve-edk2-firmware-ovmf 4.2025.05-3, зробили диверсію обох образів коду й оновили пакет до 4.2026.08-1:

Після оновленняРезультат
dpkg-query -W pve-edk2-firmware-ovmf4.2026.08-1
Новий образ Proxmoxвстановлено як OVMF_CODE_4M.fd.distrib, хеш змінився
Брендований образбез змін, досі зібраний із 4.2025.05-3
Хоч щось у консолі про ценічого, до хука нижче

Тож додай хук. apt запускає список команд DPkg::Post-Invoke після кожного запуску dpkg26. Запиши, з якої версії Proxmox ти збирав, і порівнюй після кожного:

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

На тому самому оновленні він вивів:

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.

Він навмисно виходить з 0. apt перериває роботу, якщо команда Post-Invoke зазнає невдачі26, а перевірка бренду не привід лишати вузол напівоновленим. Гучного попередження досить.

І ще одне. Перезапуски. Гість підхоплює нову прошивку лише тоді, коли перезапускається його процес QEMU, тож перезбірка означає зупинку й запуск із Proxmox, а не перезавантаження зсередини гостя, і саме так до працюючої VM доходять і власні оновлення прошивки Proxmox. Просто вони не потребують, щоб ти спершу не забув про перезбірку.

Або залиш прошивку Proxmox у спокої

Кожен досі описаний шлях для логотипа змінює прошивку, а попередній розділ це рахунок за це. Є один, що не змінює, і для цього допису зроблено його прототип.

Пристрій PCI у QEMU може нести option ROM, будь-який файл, який ти назвеш через romfile=27, і OVMF запускає драйвер EFI, який там знайде. Збірка Proxmox запускає його, підписаний він чи ні: OVMF встановлює PcdOptionRomImageVerificationPolicy у 0x00, тобто «виконувати завжди»28. OVMF малює власний логотип пізно під час вибору пристрою завантаження29 і будує BGRT лише на ReadyToBoot, за мить до того, як передати керування завантажувачу. А драйвер BGRT в edk2 приймає замінне зображення через EDKII_BOOT_LOGO2_PROTOCOL і перебудовує таблицю на ReadyToBoot щоразу, коли зображення змінилося30.

Більше нічого й не треба. Драйвер чекає на ReadyToBoot на TPL_NOTIFY, який спрацьовує раніше за власний обробник TPL_CALLBACK драйвера BGRT, очищає екран, малює свій логотип і передає те саме зображення далі. Зібраний, це один файл на 8 KB, під’єднаний одним рядком:

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

На 8 KB він легко вміщується в обмеження pmxcfs 1 MiB20, тож, на відміну від образу прошивки на 3,5 MB, він може жити в /etc/pve і йти за VM на кожен вузол.

Його перевірено проти власної прошивки Proxmox, просто з pve-edk2-firmware-ovmf 4.2026.08-1: OVMF_CODE_4M.secboot.fd із попередньо записаними ключами Microsoft в OVMF_VARS_4M.ms.fd, на Q35 з SMM, із завантаженням через підписаний shim Fedora, щоб Secure Boot був увімкнений і діяв:

Прочитано з гостяБез ROMЗ ROM
Змінна SecureBoot11
На екранілоготип ProxmoxProxmox приблизно 250 ms, потім твій
Зображення BGRT, 400×120 у 440,340від Proxmox, SHA-256 be5afe4b…від ROM, SHA-256 6c494576…
Змінені файли прошивкижоднихжодних

Зображення, яке гість прочитав зі своєї таблиці BGRT з під’єднаним option ROM: логотип Example Cloud з підписом про те, що його намалював option ROM

Останній рядок і є суттю. Прошивку Proxmox не чіпано, тож їхній наступний випуск із виправленнями безпеки доходить до твоїх гостей із наступним перезапуском, і нічого з попереднього розділу не стосується.

Це не безкоштовно:

ЦінаЧому
Логотип Proxmox видно приблизно чверть секундиOVMF малює його раніше, ніж будь-який драйвер option ROM отримує екран; уникнути цього може лише перезбірка
Гість бачить ще один пристрій PCI, без драйвераROM мусить на чомусь їхати, а pci-testdev це пристрій QEMU, що нічого не робить
Тип 0 досі каже Proxmoxрядок постачальника вкомпільовано; задай його через args із uefi=on, як вище
Лише rootце рядок args

І знахідку під цим варто сказати прямо. Непідписаний драйвер працював у прошивці на гостю з записаними ключами Microsoft і з чинним Secure Boot, бо OVMF від Proxmox не перевіряє option ROM. Тут це корисно. Це також означає, що на цій прошивці Secure Boot перевіряє завантажувачі, а не те, що під’єднує конфігурація обладнання VM, а оскільки args пише лише root, це питання про те, хто тримає root на твоїх вузлах.

Це прототип. Він працював на QEMU 10.2.2 із прошивкою Proxmox, але ще не на вузлі Proxmox, і далі йде вихідний код, а не продукт:

github.com/damo2929/RebrandPCIRom: драйвер option ROM, конвертер логотипа й збірка в контейнері.

Вебінтерфейс це два пакети

Логотипа вгорі ліворуч у вебінтерфейсі немає в pve-manager. Workspace.js просить компонент proxmoxLogoSvg із префіксом pwt, а той живе в proxmox-widget-toolkit, спільному для Backup Server і Mail Gateway31. У pve-manager лише іконки вкладок:

ЩоФайлПакет
Логотип у заголовку, малюється на 200×35/usr/share/javascript/proxmox-widget-toolkit/images/proxmox_logo.svgproxmox-widget-toolkit
Іконка вкладки браузера/usr/share/pve-manager/images/favicon.icopve-manager
Іконка 128×128, вона ж іконка для сенсорних пристроїв/usr/share/pve-manager/images/logo-128.pngpve-manager

Усі три це звичайні файли, тож це робота для dpkg-divert, і тут ціна з попереднього розділу не діє зовсім, бо логотип не має виправлень безпеки, які можна пропустити, і нічий гість не стає менш захищеним через вузол, що досі віддає торішню favicon.

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

Перевірено в тому самому контейнері, на справжніх пакетах:

КрокРезультат
Диверсія на proxmox-widget-toolkit 5.2.9, встановлено власний SVGSVG Proxmox перейменовано на proxmox_logo.svg.distrib
Оновлення до 5.2.10власний SVG на місці, копія 5.2.10 від Proxmox у .distrib
dpkg --verify proxmox-widget-toolkitбез зауважень, dpkg знає про диверсію
apt-get install --reinstall proxmox-widget-toolkitвласний SVG на місці
dpkg-divert --remove --renameоригінал Proxmox повернувся, байт у байт

Дві речі лишаються за Proxmox. Зображення в заголовку малюється у фіксованій рамці 200×35, тож малюй свій SVG під цю форму, інакше його стисне. А текст alt каже Proxmox, і зображення веде на https://www.proxmox.com, і те, і те записано в компонент JavaScript, а не у файл, для якого можна зробити диверсію31. Змінити це означає латати мініфікований бандл, який ламається з кожним оновленням. Через текст alt воно того не варте.

Чого від тебе вимагають ліцензія й торговельна марка Proxmox

Proxmox VE ліцензовано за AGPL версії 332, і розділ 13 цієї ліцензії це мережеве положення: «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. Чи вважається заміна трьох зображень модифікацією Програми? Це питання до юриста. Дешева відповідь: виклади свої зображення й скрипт диверсії десь публічно й постав на них посилання зі сторінки входу. Це не коштує ні копійки й закриває питання.

З торговельною маркою ясніше. Медіанабір Proxmox каже: «Don’t alter the logo or incorporate the logo or symbol into your logo»34. Тож заміняй їхній логотип повністю своїм, ніколи не перефарбованою чи переробленою його версією, і не вставляй Proxmox у назву свого продукту.

Твоє ім’я на продукті означає твоє обслуговування

Брендувати VM дешево. Жменька рядків SMBIOS, JPEG, растрове зображення й три картинки у вебінтерфейсі: робота на пів дня, здебільшого на те, щоб з’ясувати, де що живе.

Зберегти бренд це і є робота. І саме цю частину пропускають.

Рядки SMBIOS і заставка дбають про себе самі, бо живуть у конфігурації, якої жоден пакет ніколи не торкнеться, а логотип вебінтерфейсу дбає про себе, бо dpkg про нього повідомлено. Прошивка ні. У той день, коли ти вклав свій логотип в образ прошивки, ти взяв на себе шматок чужого процесу випусків, а Proxmox збирають, тестують і випускають нову прошивку з виправленнями безпеки, яку їхні клієнти отримують із наступним оновленням, а твої тоді, коли ти дійдеш до перезбірки.

Такий обмін нормальний, якщо його зроблено свідомо. Хостингова компанія, чиї гості завантажують прошивку на два випуски позаду, бо логотип важив більше за журнал змін, не збудувала продукт. Вона збудувала наліпку.

Якщо твоє ім’я на екрані завантаження, то тримати актуальною прошивку за ним твоя справа, хоч би хто її написав. Ніхто не перевірить. Саме тому це й треба робити.


  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». Архівна копія; жива сторінка повертає 403 на автоматизовані запити. ↩︎

  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»; plymouth.spec у Fedora робить bgrt типовою темою. ↩︎

  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 — тип 1 System Information, тип 2 системна плата, тип 3 «the system’s mechanical enclosure(s)», тип 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 — кожне поле, крім uuid, має шаблон [A-Za-z0-9+\/]+={0,2}; значення декодуються, коли встановлено base64. ↩︎

  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», інші поля smbios1 зберігаються. ↩︎ ↩︎

  10. QEMU, System Emulation, Invocation — поля -smbios для кожного типу; -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 — OVMF додає власний тип 0 лише тоді, коли NeedSmbiosType0 усе ще встановлено після обходу таблиць QEMU. ↩︎

  12. qemu-server, src/PVE/QemuServer.pm, custom args — args розбиваються й додаються в кінець командного рядка. ↩︎

  13. qemu-server, src/PVE/API2/Qemu.pm, config permission checks — smbios1 це параметр типу обладнання, що потребує VM.Config.HWType; запасна гілка «catches args, lock, etc.» і завершується з «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 — пам’ять default => 512; cores і sockets за замовчуванням 1 у QemuServer.pm. ↩︎

  17. qemu-server, src/PVE/QemuServer.pm, vm_start — lock_config у рядку 5457, exec_hookscript($conf, $vmid, 'pre-start', 1) у 5581 і config_to_command у 5634 з тим самим $conf, без перезавантаження між ними. ↩︎

  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 — OVMF читає etc/boot-menu-wait, тобто значення splash-time, і більше нічого з -boot. ↩︎

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

  21. SeaBIOS, src/jpeg.c — PIC пише синій першим на little-endian, PIC_32 у рядку 946 пише червоний першим без гілки для порядку байтів; ERR_NOT_SEQUENTIAL_DCT і ERR_NOT_YCBCR_221111 це єдині відхилені формати. ↩︎ ↩︎

  22. SeaBIOS, vgasrc/svgamodes.c — режим 0x111 це 640×480 на 16 бітів, 0x142 це 640×480 на 32. ↩︎

  23. pve-edk2-firmware, debian/rules at 4.2026.08-1 — cp -a debian/Logo.bmp MdeModulePkg/Logo/Logo.bmp, рядок PcdFirmwareVendor і прапорці збірки OVMF. ↩︎ ↩︎ ↩︎

  24. qemu-server, src/PVE/QemuServer/OVMF.pm — жорстко зашита таблиця прошивок під /usr/share/pve-edk2-firmware/, вибір SMM і блочний вузол 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), властивість, яку має кожен пристрій PCI. ↩︎

  28. edk2-stable202608, OvmfPkg/OvmfPkgIa32X64.dsc — gEfiSecurityPkgTokenSpaceGuid.PcdOptionRomImageVerificationPolicy|0x00, файл платформи, який збирає Proxmox. ↩︎

  29. edk2-stable202608, OvmfPkg/Library/PlatformBootManagerLib/BdsPlatform.c — BootLogoEnableLogo (), що викликається з PlatformBootManagerAfterConsole. ↩︎

  30. edk2-stable202608, BootGraphicsResourceTableDxe.c — SetBootLogo2 у рядку 239 копіює зображення; обробник ReadyToBoot у 417 видаляє й знову встановлює таблицю «If BGRT data change happens». ↩︎

  31. proxmox-widget-toolkit, src/Logo.js — proxmoxLogoSvg, 200×35, alt: 'Proxmox', з посиланням на proxmox.com; використовується з pve-manager Workspace.js із 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 — повністю процитовано в тексті вище. ↩︎

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