Gemenskapslösning

ZimaOS-arkitektur förklarad: Buildroot, Docker-appar, lagring och vad communityn har observerat

A community architecture overview that was revised after feedback to identify ZimaOS as Buildroot-based, correct the local hostname to zimaos.local, and distinguish observed implementation details from official product guarantees.

Arkitekturinlägget från oktober 2025 är användbart eftersom det försöker koppla samman maskinvara, Linux-basen, Docker, lagring, nätverk, applikationer och övervakning till en enda mental modell. Det är också ett bra exempel på varför communitybaserad reverse engineering inte bör misstas för en officiell intern specifikation.

Författaren döpte om inlägget till ”My Observation” och korrigerade flera detaljer efter att andra användare ifrågasatt dem. En sammanfattning av hög kvalitet bör bevara dessa korrigeringar och endast verifiera de centrala påståenden som stöds av IceWhales egna aktuella källor.

ZimaOS är Buildroot-baserat, inte en generell Debian-installation

Den viktigaste korrigeringen i tråden gällde basoperativsystemet. Inlägget väckte först frågor om Debian, men författaren korrigerade det senare till Buildroot. IceWhales offentliga ZimaOS-repositorium bekräftar oberoende att systemet byggs med Buildroot och är utformat kring stabila OTA-uppdateringar.

Du kan verifiera denna grund i IceWhales aktuella offentliga projektbeskrivning av ZimaOS.

Den plattform som stöds fokuserar på x86-64

Källinlägget listar Intel- och AMD-maskinvara med x86-64 och säger att det då inte fanns någon officiell ARM-version. IceWhales aktuella offentliga projekt beskriver fortfarande Zima-maskinvara och generiska x86-64-system med UEFI som plattformar som stöds.

Det gör x86-64 till ett stabilt arkitekturfaktum, men stöd för enskilda nätverkskort, grafikprocessorer, lagringskontroller och sensorer beror fortfarande på den faktiska maskinvaran och ZimaOS-versionen.

Applikationer byggs kring Docker Compose

Community-inlägget beskrev Docker som applikationslagret. Aktuella specifikationer för ZimaOS appbutik bekräftar att appdefinitioner skrivs som Docker Compose med ZimaOS-specifika x-casaos-metadata ovanpå.

Den användbara designregeln är enkel: körningsinställningar för containrar ska ligga i Docker Compose, medan ZimaOS-butiksmetadata ska ligga i x-casaos.

Appdata lagras utanför engångscontainrar

En praktisk konsekvens av containermodellen är att viktiga applikationsdata bör mappas till beständig lagring. Aktuella riktlinjer för ZimaOS rekommenderar att värdefulla appdata lagras på lagringsutrymme i stället för att fylla den mindre systemenheten.

Detta är mer användbart än att förlita sig på en fast lista över interna sökvägar från en arkitekturobservation från 2025, eftersom paketeringen i appbutiken och lagringsbeteendet kan utvecklas oberoende av varandra.

Korrigeringen av det lokala värdnamnet var zimaos.local

I tråden användes ursprungligen zima.local. En annan användare testade detta och visade att det fungerande lokala namnet var zimaos.local, vilket författaren sedan korrigerade.

Windows-terminal som visar att zima.local misslyckas medan zimaos.local kan slås upp utan problem
Detta community-test fick författaren att korrigera värdnamnet för lokal upptäckt från zima.local till zimaos.local.

Lås inte fast interntjänsternas namn som communityn har observerat

Det ursprungliga inlägget listade specifika tjänstenamn, portar, övervakningskomponenter, RAID-platser och valfria filsystemverktyg. Vissa kan ha varit korrekta i en viss version, men alla är inte stabila offentliga kontrakt.

För långlivat sökinnehåll är den säkrare arkitekturmodellen den stödda gränsen: ett Buildroot-baserat appliance-operativsystem, Docker-baserade applikationer, hanterad lagring och nätverk, OTA-uppdateringar samt ett webb- och klientbaserat hanteringslager. Betrakta djupare tjänstenamn som implementeringsdetaljer såvida inte IceWhale publicerar dem som ett API eller kompatibilitetskontrakt.

Vanliga frågor om ZimaOS-arkitekturen

Är ZimaOS Debian?

Nej. Community-författaren korrigerade det påståendet, och IceWhales offentliga projekt identifierar ZimaOS som Buildroot-baserat.

Använder ZimaOS Docker för appar?

Ja. Aktuella specifikationer för ZimaOS appbutik bygger på Docker Compose tillsammans med ZimaOS-metadata.

Är alla interna tjänstenamn i inlägget från 2025 garanterade?

Nej. Inlägget är uttryckligen en observation och korrigerades efter publiceringen. Interna komponenter kan ändras mellan versioner.

Vilket lokalt värdnamn bör jag prova?

Det korrigerade värdnamnet i tråden är zimaos.local, även om direkt åtkomst via IP-adress fortfarande är användbar när lokal upptäckt inte fungerar.