LiberNT Update

LiberNT Update je podepsaný aktualizátor pro operační systém LiberNT: vydavatel sestavení v Pythonu a klient pro Win32 v C++17, který vymění jen změněné soubory, při restartu i za běhu, a umí aktualizaci vrátit.

LiberNT Update: vydavatel publikuje dvě podepsaná vydání ukázkového stromu, verify je ověří a po poškození jednoho souboru ohlásí rozbitý feed

LiberNT Update je podepsaný aktualizátor pro LiberNT, volný operační systém kompatibilní s Windows NT. Bez něj se na novější sestavení přechází novou instalací z obrazu disku. LiberNT Update porovná nainstalovaný systém s novým sestavením soubor po souboru, stáhne jen soubory, které se liší, a před výměnou uloží zálohu, ze které jde aktualizaci vrátit.

Co je naše a co patří projektu LiberNT

Operační systém LiberNT není náš. Vyvíjí ho samostatný projekt LiberNT pod licencí GPL 3.0 a jeho repozitář vychází z ReactOS. Podle vlastního README míří na kompatibilitu s Windows 11 pro amd64, arm64 a riscv64; vydání jsou zatím ladicí předběžná sestavení na zkoušení ve virtuálu.

Naše jsou dvě věci. První je repozitář libernt-update: vydavatel sestavení v Pythonu a klient pro Win32 v C++17, celý pod licencí MIT. Druhá je veřejný fork nks-hub/LiberNT. Jeho větev nks nese naše záplaty systému a GitHub Actions do ní každý den ve 3:17 UTC sloučí upstreamovou větev main-nt10. Konflikt při sloučení založí issue a čeká na ruční vyřešení. Záplaty ve forku jsou pod GPL 3.0 jako zbytek systému.

K 6. listopadu 2026 má fork 11 záplat, každou ve vlastní větvi nks-feat/… nebo nks-fix/…, aby šla upstreamu nabídnout samostatně. Tři potřebuje aktualizátor: SMSS spouští nativní příkazy ve fázi UpdateExecute až po inicializaci registru, zápis registru uloží všechny bloky hivu, přes které vede změněná buňka, a ovladače startující při bootu dostanou vlastní klíč služby. Ostatní řeší kompatibilitu: sas.dll s funkcí SendSAS, funkce balíčků ovladačů tiskáren ve winspoolu, přepínač /Z v xcopy, rozložení struktury AFD_POLL_INFO podle Windows, vynulování struktury z NtUserEnumDisplayDevices, připojení procesů SYSTEM mimo relaci 0 k WinSta0, další úrovně konfigurace služeb a GetModuleHandleEx podle adresy.

Stahuje se jen to, co se na disku liší

Klient počítá SHA-256 skutečného obsahu souborů, velikosti a času změny nevěří. Nezáleží proto na tom, z jakého sestavení počítač vyšel. Jádro a HAL si drží variantu, kterou zvolil instalátor; na víceprocesorovém stroji je ntoskrnl.exe kopie ntkrnlmp.exe. Vydání pokrývá soubory pod Windows a Program Files a zavaděče z bootovacího oddílu, hivy registru, logy, cache a unattend.inf nechává být.

Vydavatel nepublikuje soubory, které se od minulého vydání liší jen metadaty sestavení (časová razítka PE, kontrolní součet, ladicí identifikátory, značka sestavení). Sloučení 30 upstreamových commitů tak místo 1520 změněných souborů neslo 516.

Podpis místo HTTPS

Seznam vydání feed.json je podepsaný klíčem Ed25519 a klient zná jen veřejný klíč, který má zakompilovaný. Manifest vydání ověří podle SHA-256 ze seznamu a každý stažený soubor podle SHA-256 z manifestu. Na server proto stačí obyčejné HTTP a libovolný statický web; v repozitáři je kontejner s nginx. Datová složka klienta nesmí být zapisovatelná pro běžné uživatele.

Výměna při restartu a cesta zpět

Když žádný měněný soubor neběží, klient je vymění rovnou, ověří hash a při chybě vrátí zálohu. Jinak připraví plán a soubory při dalším startu vymění nativní program luupboot.exe dřív, než naběhne Win32. Potom restartuje ještě jednou, takže žádná část systému neběží na směsi starých a nových souborů.

  • Služba LiberNTUpdate po restartu zkontroluje každý vyměněný soubor; když některý nesedí, vrátí aktualizaci a obnoví jen soubory, které se opravdu změnily.
  • Když dva starty po aktualizaci nedojdou ke službě, luupboot.exe obnoví předchozí soubory při třetím.
  • V nabídce zavaděče přibude položka „LiberNT (undo the last update)“, která spustí předchozí jádro a HAL a aktualizaci vrátí.
  • Vydání, které na stroji selhalo nebo se vracelo, se automaticky znovu neinstaluje.

Výchozí hodnoty registru přicházejí jako podepsané snímky z čistého sestavení. Klient porovná staré výchozí hodnoty, nové výchozí hodnoty a to, co je v systému, a místní nastavení nepřepíše.

Okno, ikona v oznamovací oblasti a příkazová řádka

Služba se ve výchozím nastavení dívá na nová vydání každých 6 hodin, nainstaluje je a čekající aktualizaci dokončí restartem ve 3:00. Klient se aktualizuje sám: když nová verze nevydrží běžet 30 sekund, předchozí ji vrátí. Okno mluví česky na českém systému, jinde anglicky. Stejnou práci dělají přepínače /check, /install, /rollback, /cancel a /history; každý krok jde do update.log.

Okno LiberNT Update v0.2.8 na českém LiberNT: je k dispozici aktualizace jednoho souboru
Okno klienta v LiberNT amd64 ve virtuálu. Snímek je z dokumentace repozitáře.

Snímek nahoře je z ukázkového běhu vydavatele 6. listopadu 2026. Ze stromu devíti souborů publikoval šest, hive registru, log a soubor z uživatelské složky vynechal. Po změně disk.sys přidalo druhé vydání jediný nový objekt. Kontrola verify pak prošla, a když se jeden uložený soubor poškodil, ohlásila rozbitý feed a skončila kódem 1.

Stav a omezení

Poslední verze klienta je 0.3.1 z 5. listopadu 2026, projekt je ve vývoji. Cílem je LiberNT amd64 sestavený z větve nks forku od commitu 5fccfb5; starší instalace je lepší přeinstalovat. Obnova po pádu ovladače startujícího při bootu prošla ve virtuálu s UEFI (OVMF), na fyzickém UEFI hardwaru testovaná není. Sestavení LiberNT mají nepodepsané zavaděče EFI, takže se zapnutým Secure Boot je firmware nespustí. Když ovladač spadne dřív, než naběhne SMSS, nebo nový zavaděč nenastartuje, je potřeba obnova z druhé instalace LiberNT přepínačem /recover-offline.

CI při každém pushi spouští testy vydavatele, vestavěný test klienta a zkoušku HTTP. Lokální běh 6. listopadu 2026 prošel ve vydavateli i ve všech 116 kontrolách klienta; testy startu a ikony na LiberNT tím nahrazené nejsou.

Jak začít

Na sestavovacím stroji je potřeba Python 3.12 s PyNaCl, 7-Zip a připravený strom sestavení LiberNT. Klíč vznikne jednou:

python3 server/luup.py keygen --key /opt/luup/signing.key

Veřejný klíč se zapíše do client/src/pubkey.h a klient se sestaví ve Visual Studiu 2022 příkazem client\build.cmd. LiberNTUpdate.exe a luupboot.exe patří do C:\Program Files\LiberNT Update\ a přepínač /register zapne automatické aktualizace. Skript server/build-release.sh se systemd časovačem pak každý den ve 4:30 UTC stáhne větev nks, sestaví obraz a vydá ho, když přibyl nový commit nebo verze klienta. Hotové binárky se SHA256SUMS jsou ve vydáních na GitHubu.

Zdrojový kód

Aktualizátor je v repozitáři nks-hub/libernt-update pod licencí MIT; přibalené knihovny Monocypher a nlohmann/json si nechávají své licence. Záplatovaný systém je ve forku nks-hub/LiberNT pod GPL 3.0, původní projekt v repozitáři LiberNT/LiberNT.

← Všechny reference