Що бачить твій клієнт, коли завантажується твоя VM
Ти продаєш віртуальні машини під власним ім’ям. Клієнт вмикає одну, і перше, що з’являється на екрані, це чужий логотип.
Це стандартна VM у Proxmox. Нічого не зламано, і Proxmox нічого поганого не роблять: це їхній продукт і їхнє ім’я, вони написали прошивку й інтерфейс, у якому воно з’являється, і мають повне право його туди поставити, так само як виробник серверів ставить свій значок на передню панель корпусу. Просто воно не твоє.
Логотип це лише початок.
Ось що повідомляє стандартний гість UEFI на поточній прошивці Proxmox, pve-edk2-firmware 4.2026.08-1, прочитане зсередини гостя через dmidecode:
| Де гість дивиться | Що він читає | Чиє ім’я |
|---|---|---|
| Екран завантаження | логотип Proxmox | Proxmox |
| Постачальник прошивки (SMBIOS тип 0) | Proxmox distribution of EDK II | Proxmox |
| Версія прошивки | 4.2026.08-1 | версія пакета Proxmox |
| Виробник системи (тип 1) | QEMU | QEMU |
| Назва продукту (тип 1) | Standard PC (Q35 + ICH9, 2009) | QEMU |
| Виробник корпусу (тип 3) | QEMU | QEMU |
| Системна плата (тип 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 тихо поверне половину назад, а та половина, яку він не повертає, якраз та, що має тебе турбувати, і про неї здебільшого цей допис.
Таблиця MSDM у цій передачі зовсім не про бренд. Вона несе ліцензійний ключ, і перенесенню його у VM присвячено окремий допис: Перенесення ліцензії OEM у VM Proxmox.
Усе під /usr/share належить apt
Одне правило вирішує кожен вибір нижче. Файл, який встановив пакет, це файл пакета. Відредагуй його на місці, і наступне оновлення цього пакета мовчки перезапише твою правку, бо, з погляду dpkg, він лише кладе власний файл туди, де його залишив.
Тож кожен елемент бренду мусить жити там, чим apt не володіє. На вузлі Proxmox таких місць три, і кожне коштує чогось свого:
| Де живе | Як туди потрапляє | Переживає оновлення | Чого це тобі коштує |
|---|---|---|---|
Конфігурація VM у /etc/pve | smbios1, а для решти 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 гостя читає:
| Структура | Поле | Стандартно | З брендом |
|---|---|---|---|
| Тип 0 | Vendor | Proxmox distribution of EDK II | Example Cloud Ltd |
| Тип 0 | Version | 4.2026.08-1 | EC-FW 1.0 |
| Тип 1 | Manufacturer | QEMU | Example Cloud Ltd |
| Тип 1 | Product Name | Standard PC (Q35 + ICH9, 2009) | EC Compute Instance |
| Тип 1 | Family | не вказано | General Purpose |
| Тип 2 | Manufacturer | структура відсутня | Example Cloud Ltd |
| Тип 2 | Product Name | структура відсутня | EC Virtual Board |
| Тип 3 | Manufacturer | QEMU | Example Cloud Ltd |
| Тип 3 | Asset Tag | не вказано | EC-ASSET-123 |
| Тип 11 | String 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 Number | name | web-01 |
| SKU Number | cores × sockets, і memory | ec-4c16g |
| Family | перший запис у tags | production |
| UUID | UUID 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×480 | Logo.bmp, 400×120, 8 біт, вбудований в OVMF_CODE_4M*.fd |
| Пакет-власник | qemu-server | pve-edk2-firmware-ovmf |
| Змінити для окремої VM | args: -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-бітний BMP | QEMU перевіряє файл до старту VM | splash file … format not recognized; must be JPEG or 24 bit BMP |
| Baseline JPEG, кольоровість 4:2:0 | декодер SeaBIOS нічого іншого не обробляє21 | ERR_NOT_SEQUENTIAL_DCT або ERR_NOT_YCBCR_221111 і порожній екран |
| 640×480, як у самого Proxmox | SeaBIOS просить у VGA BIOS режим рівно розміру зображення | немає відповідного режиму, немає заставки |
Більшість графічних інструментів типово пише baseline 4:2:0, тож звичайний спосіб втратити логотип це одна з опцій «зберегти для вебу», яка тихо вмикає прогресивне кодування, що виглядає однаково в кожному переглядачі зображень, який у тебе є, і лишає SeaBIOS не малювати взагалі нічого.
Пастка з кольорами
Ця коштувала півдня. Той самий JPEG, відмальований двома збірками SeaBIOS 1.17.0, виходить двох різних кольорів:

Причина в 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-4 | 0x111 | 16 | правильні, квантовані до 65 536 |
Власна збірка seabios 1.17.0-10 у Fedora 44 | 0x142 | 32 | червоний і синій переставлено |
Номери режимів узято з власної таблиці 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 завантажується ось так:

І власний погляд гостя на свою прошивку змінюється разом із ним, без жодного параметра -smbios у командному рядку:
| Прочитано всередині гостя | 4.2026.08-1 від Proxmox | Перезібрано з того самого дерева |
|---|---|---|
| Постачальник прошивки | Proxmox distribution of EDK II | Example Cloud Ltd |
| Версія прошивки | 4.2026.08-1 | 4.2026.08-1+ec1 |
| «UEFI is supported» | є | є |
| Таблиці ACPI | BGRT, 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.
Лишається два шляхи.
Шлях 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-ovmf | 4.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 |
|---|---|---|
Змінна SecureBoot | 1 | 1 |
| На екрані | логотип Proxmox | Proxmox приблизно 250 ms, потім твій |
| Зображення BGRT, 400×120 у 440,340 | від Proxmox, SHA-256 be5afe4b… | від ROM, SHA-256 6c494576… |
| Змінені файли прошивки | жодних | жодних |

Останній рядок і є суттю. Прошивку 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.svg | proxmox-widget-toolkit |
| Іконка вкладки браузера | /usr/share/pve-manager/images/favicon.ico | pve-manager |
| Іконка 128×128, вона ж іконка для сенсорних пристроїв | /usr/share/pve-manager/images/logo-128.png | pve-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, встановлено власний SVG | SVG 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 збирають, тестують і випускають нову прошивку з виправленнями безпеки, яку їхні клієнти отримують із наступним оновленням, а твої тоді, коли ти дійдеш до перезбірки.
Такий обмін нормальний, якщо його зроблено свідомо. Хостингова компанія, чиї гості завантажують прошивку на два випуски позаду, бо логотип важив більше за журнал змін, не збудувала продукт. Вона збудувала наліпку.
Якщо твоє ім’я на екрані завантаження, то тримати актуальною прошивку за ним твоя справа, хоч би хто її написав. Ніхто не перевірить. Саме тому це й треба робити.
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 на автоматизовані запити. ↩︎
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»; plymouth.spec у Fedora робить
bgrtтиповою темою. ↩︎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 — тип 1 System Information, тип 2 системна плата, тип 3 «the system’s mechanical enclosure(s)», тип 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 — кожне поле, крімuuid, має шаблон[A-Za-z0-9+\/]+={0,2}; значення декодуються, коли встановленоbase64. ↩︎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», інші поляsmbios1зберігаються. ↩︎ ↩︎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.» ↩︎ ↩︎ ↩︎edk2-stable202608,
OvmfPkg/SmbiosPlatformDxe/SmbiosPlatformDxe.c— OVMF додає власний тип 0 лише тоді, колиNeedSmbiosType0усе ще встановлено після обходу таблиць QEMU. ↩︎qemu-server,
src/PVE/QemuServer.pm, custom args —argsрозбиваються й додаються в кінець командного рядка. ↩︎qemu-server,
src/PVE/API2/Qemu.pm, config permission checks —smbios1це параметр типу обладнання, що потребуєVM.Config.HWType; запасна гілка «catches args, lock, etc.» і завершується з «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— пам’ятьdefault => 512;coresіsocketsза замовчуванням 1 уQemuServer.pm. ↩︎qemu-server,
src/PVE/QemuServer.pm,vm_start—lock_configу рядку 5457,exec_hookscript($conf, $vmid, 'pre-start', 1)у 5581 іconfig_to_commandу 5634 з тим самим$conf, без перезавантаження між ними. ↩︎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— OVMF читаєetc/boot-menu-wait, тобто значенняsplash-time, і більше нічого з-boot. ↩︎pve-cluster,
src/pmxcfs/memdb.h—#define MEMDB_MAX_FILE_SIZE (1024 * 1024) // 1 MiB. ↩︎ ↩︎ ↩︎SeaBIOS,
src/jpeg.c—PICпише синій першим на little-endian,PIC_32у рядку 946 пише червоний першим без гілки для порядку байтів;ERR_NOT_SEQUENTIAL_DCTіERR_NOT_YCBCR_221111це єдині відхилені формати. ↩︎ ↩︎SeaBIOS,
vgasrc/svgamodes.c— режим0x111це 640×480 на 16 бітів,0x142це 640×480 на 32. ↩︎pve-edk2-firmware,
debian/rulesat 4.2026.08-1 —cp -a debian/Logo.bmp MdeModulePkg/Logo/Logo.bmp, рядокPcdFirmwareVendorі прапорці збірки OVMF. ↩︎ ↩︎ ↩︎qemu-server,
src/PVE/QemuServer/OVMF.pm— жорстко зашита таблиця прошивок під/usr/share/pve-edk2-firmware/, вибір SMM і блочний вузолpflash0. ↩︎ ↩︎ ↩︎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), властивість, яку має кожен пристрій PCI. ↩︎edk2-stable202608,
OvmfPkg/OvmfPkgIa32X64.dsc—gEfiSecurityPkgTokenSpaceGuid.PcdOptionRomImageVerificationPolicy|0x00, файл платформи, який збирає Proxmox. ↩︎edk2-stable202608,
OvmfPkg/Library/PlatformBootManagerLib/BdsPlatform.c—BootLogoEnableLogo (), що викликається зPlatformBootManagerAfterConsole. ↩︎edk2-stable202608,
BootGraphicsResourceTableDxe.c—SetBootLogo2у рядку 239 копіює зображення; обробник ReadyToBoot у 417 видаляє й знову встановлює таблицю «If BGRT data change happens». ↩︎proxmox-widget-toolkit,
src/Logo.js—proxmoxLogoSvg, 200×35,alt: 'Proxmox', з посиланням на proxmox.com; використовується з pve-managerWorkspace.jsізprefix: '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 — повністю процитовано в тексті вище. ↩︎
Proxmox, Media kit — «Don’t alter the logo or incorporate the logo or symbol into your logo.» ↩︎