Gemenskapslösning

ZimaOS diagnostikskript för ögonblicksbild: system, RAID, SMART, Docker, nätverk och integritetsgranskning

A November 2025 community Bash script that generates a readable troubleshooting report covering system information, CPU/RAM, temperatures, disk usage, RAID, SMART, Docker, AppData usage, network routes, and top processes. Zima-Giorgio praised the work and suggested storing output under /DATA, but the script remains community code.

”ZimaOS Premium Snapshot Script” är inte en ZimaOS-ögonblicksbild i filsystems-/VM-bemärkelse. Det skapar inte en Btrfs-ögonblicksbild eller en säkerhetskopia. Det är ett community-skript i Bash som samlar in en diagnosrapport: systemversion, resursanvändning, temperaturer, filsystem, RAID-status, SMART-hälsa, Docker-containrar, AppData-storlek, nätverkskonfiguration och processerna med högst användning.

Det gör det potentiellt användbart för support, men innebär också att den genererade texten kan innehålla miljödetaljer som du kanske inte vill publicera offentligt. Zima-Giorgio berömde idén och föreslog att iterativa rapportfiler skulle sparas under /DATA eftersom den platsen är lättare att komma åt från Filer. IceWhale antog eller certifierade inte skriptet som ett inbyggt diagnostikverktyg i den här tråden.

Skriptet skapar en enda lättläst systemrapport

Källskriptet samlar in:

  • ZimaOS-version, variant, byggdatum, värdnamn, tillverkare, modell;
  • CPU-belastning, minne, växlingsutrymme och temperaturer;
  • filsystemsanvändning och disklayout;
  • RAID- och Btrfs-status;
  • SMART-hälsa för diskar;
  • körande och avslutade Docker-containrar;
  • storleken på katalogerna AppData och Main-Storage;
  • IPv4-gränssnitt, bryggor och standardrutt;
  • processerna med högst CPU- och minnesanvändning.

En diagnosrapport är inte en säkerhetskopia eller en ögonblicksbild av filsystemet

Ordet ”snapshot” kan vara missvisande. Skriptet skriver systeminformation till en textfil; det fångar inte programdatabaser, filer, containerlager eller lagringens tillstånd vid en viss tidpunkt för återställning.

Använd ZimaOS Backup, programmedvetna exporter, RAID-skydd eller riktiga verktyg för ögonblicksbilder av filsystem/virtuella maskiner för återställning.

Det ursprungliga skriptet skrev till Main-Storage

V1-skriptet skapade:

/media/Main-Storage/Zima_snapshot/

och lagrade daterade textrapporter där. Den sökvägen förutsätter att användarens lagringsutrymme faktiskt heter Main-Storage.

På ett annat system kan hårdkodning av den sökvägen misslyckas eller skriva någonstans oavsiktligt om monteringen inte är tillgänglig.

Zima-Giorgio föreslog /DATA för enklare åtkomst

I det slutliga svaret från källan sa Zima-Giorgio att han, om projektet fortsatte att utvecklas, skulle föreslå att utdatafiler lagrades under /DATA eftersom den katalogen är lättare att komma åt via appen Filer.

Detta var officiell återkoppling på community-projektet, inte ett tillkännagivande om att IceWhale hade integrerat skriptet.

SMART-utdata kräver tolkning per enhet

Exempelrapporten visade traditionella SMART-fält för hårddiskar, som temperatur, omallokerade sektorer, väntande sektorer, CRC-fel och drifttimmar. Den visade även ”SMART not available” för NVMe-enheterna eftersom skriptets enkla tolkning inte genererade motsvarande NVMe-utdata.

Tolka inte ”not available” i det här skriptet som ett bevis på att NVMe-enheten saknar hälso­telemetri.

Skriptet skrevs utifrån författarens RAID 5-layout

Exemplet märker uttryckligen md0 och skriver ut avsnittet ”RAID5-status”. En annan ZimaOS-installation kan använda RAID 1, RAID 6, JBOD, ZFS, enskilda diskar eller md-enheter med andra namn.

Granska varje hårdkodad enhet, monteringssökväg och filsystemantagande innan du återanvänder skriptet.

Docker-utdata kan avslöja programinventeringen

Rapporten innehåller namn på containeravbildningar och programnamn. Det är användbart för supportpersonal, men en offentlig inklistring kan avslöja vilka tjänster du kör, vilka versioner som är installerade och potentiellt vilka program som är föråldrade.

Maskera onödiga tjänstenamn när rapporten publiceras utanför en betrodd supportkanal.

Nätverksutdata kan avslöja intern topologi

Exempelrapporten listar gränssnittsnamn, LAN-IP-adresser, virtuella nätverk, Docker-bryggor och standardrutter. Källförfattaren maskerade manuellt en del av IP-informationen i det publicerade exemplet.

Granska följande innan du delar en rapport offentligt:

  • IP-adresser och subnät;
  • värdnamn;
  • namn på VPN-/overlay-gränssnitt;
  • monterings- och resursnamn;
  • program-/container-namn;
  • alla sökvägar som innehåller personliga identifierare.

Föredra skrivskyddad diagnostik

Styrkan hos den här typen av skript är att de flesta användbara felsökningsdata kan samlas in med skrivskyddade kommandon, till exempel systeminformation, diskanvändning, SMART-frågor, Docker-listning och processinspektion.

Ett diagnostikskript bör inte i det tysta starta om tjänster, rensa Docker, ändra RAID-metadata eller radera loggar. Håll insamling av bevis åtskild från reparationsåtgärder.

Aktuella ZimaOS visar redan mer diagnostik för lagring och appar

I Inställningar > Appar visas aktuell lagringsanvändning per program och kontroller för cache, medan Lagring visar diskhälsa och information om lagringsarrayer. Använd först de inbyggda översikterna och lägg sedan till en community-rapport när supporten behöver en bredare systemavbild i en enda fil.

De aktuella verktygen för att visa app-lagring kan besvara många lagringsrelaterade frågor utan ett anpassat skript.

Vanliga frågor om diagnostiska ögonblicksbilder

Skapar det här skriptet en återställningsbar systemavbild?

Nej. Det skapar en textbaserad diagnosrapport.

Antog IceWhale officiellt skriptet?

Nej. Zima-Giorgio lovordade den och föreslog att rapporter skulle lagras under /DATA, men koden är fortfarande skapad av communityn.

Bör rapporten publiceras offentligt utan granskning?

Nej. Det kan exponera IP-adresser, topologi, lagringsnamn, programinventering och andra miljödetaljer.