Communityoplossing

ZimaOS-diagnostieksnapshot-script: controle van systeem, RAID, SMART, Docker, netwerk en privacy

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.

Het “ZimaOS Premium Snapshot Script” is geen ZimaOS-snapshot in de betekenis van een bestandssysteem- of VM-snapshot. Het maakt geen Btrfs-snapshot of back-upimage. Het is een community-Bash-script dat een diagnostisch rapport verzamelt met systeemversie, resourcegebruik, temperaturen, bestandssystemen, RAID-status, SMART-status, Docker-containers, de grootte van AppData, netwerkconfiguratie en processen met het hoogste gebruik.

Dat maakt het mogelijk nuttig voor ondersteuning, maar betekent ook dat de gegenereerde tekst omgevingsgegevens kan bevatten die je misschien niet openbaar wilt plaatsen. Zima-Giorgio prees het idee en stelde voor om iteratieve rapportbestanden op te slaan onder /DATA omdat die locatie gemakkelijker toegankelijk is vanuit Bestanden. IceWhale heeft het script in deze thread niet overgenomen of gecertificeerd als ingebouwd diagnostisch hulpmiddel.

Het script bouwt één door mensen leesbaar systeemrapport

Het bronscript verzamelt:

  • ZimaOS-versie, variant, builddatum, hostnaam, fabrikant en model;
  • CPU-belasting, geheugen, swap en temperaturen;
  • gebruik van het bestandssysteem en schijfindeling;
  • RAID- en Btrfs-status;
  • SMART-status van schijven;
  • actieve en beëindigde Docker-containers;
  • de grootte van de mappen AppData en Main-Storage;
  • IPv4-interfaces, bridges en de standaardroute;
  • processen met het hoogste CPU- en geheugengebruik.

Een diagnostisch rapport is geen back-up of bestandssysteem-snapshot

Het woord “snapshot” kan misleidend zijn. Het script schrijft systeeminformatie naar een tekstbestand; het legt geen applicatiedatabases, bestanden, containerlagen of opslagstatus op een bepaald moment vast voor herstel.

Gebruik voor hersteldoeleinden ZimaOS Backup, applicatiebewuste exports, RAID-bescherming of echte tools voor bestandssysteem-/VM-snapshots.

Het oorspronkelijke script schreef naar Main-Storage

Het V1-script maakte het volgende aan:

/media/Main-Storage/Zima_snapshot/

en daar gedateerde tekstrapporten opsloeg. Dat pad gaat ervan uit dat de opslagruimte van de gebruiker daadwerkelijk Main-Storage heet.

Op een ander systeem kan het vastleggen van dat pad mislukken of ergens anders schrijven als de mount niet beschikbaar is.

Zima-Giorgio stelde /DATA voor voor eenvoudigere toegang

In het uiteindelijke antwoord van de bron zei Zima-Giorgio dat hij, als het project verder zou worden ontwikkeld, zou voorstellen om uitvoerbestanden op te slaan onder /DATA omdat die map gemakkelijker toegankelijk is via de Bestanden-app.

Dit was officiële feedback op het communityproject, geen aankondiging dat IceWhale het script had geïntegreerd.

SMART-uitvoer vereist interpretatie per apparaat

Het voorbeeldrapport toonde traditionele HDD-SMART-velden, zoals temperatuur, opnieuw toegewezen sectoren, in behandeling zijnde sectoren, CRC-fouten en inschakeluren. Het toonde ook “SMART niet beschikbaar” voor de NVMe-apparaten, omdat de eenvoudige parsering van het script geen vergelijkbare NVMe-uitvoer opleverde.

Interpreteer “niet beschikbaar” in dit script niet als bewijs dat de NVMe geen gezondheidsgegevens heeft.

Het script is geschreven rond de RAID 5-indeling van de auteur

In het voorbeeld wordt expliciet het label md0 en geeft een sectie “RAID5-status” weer. Een andere ZimaOS-installatie kan RAID 1, RAID 6, JBOD, ZFS, afzonderlijke schijven of anders benoemde md-apparaten gebruiken.

Controleer elk hardgecodeerd apparaat, mountpad en bestandssysteemveronderstelling voordat u het script opnieuw gebruikt.

Docker-uitvoer kan de applicatie-inventaris blootleggen

Het rapport bevat namen van containerimages en applicaties. Dat is nuttig voor supportmedewerkers, maar een openbare paste kan onthullen welke services u gebruikt, welke versies zijn geïnstalleerd en mogelijk welke applicaties verouderd zijn.

Scherm onnodige servicenamen af wanneer het rapport buiten een vertrouwd supportkanaal wordt geplaatst.

Netwerkuitvoer kan de interne topologie onthullen

Het voorbeeldrapport vermeldt interfacenamen, LAN-IP-adressen, virtuele netwerken, Docker-bridges en standaardroutes. De auteur van de bron heeft in het gepubliceerde voorbeeld een deel van de IP-informatie handmatig afgeschermd.

Controleer het volgende voordat u een rapport openbaar deelt:

  • IP-adressen en subnetten;
  • hostnamen;
  • namen van VPN-/overlayinterfaces;
  • namen van mounts en shares;
  • namen van applicaties/containers;
  • alle paden die persoonlijke identificatiegegevens bevatten.

Geef de voorkeur aan diagnostiek in alleen-lezenmodus

De kracht van dit soort scripts is dat de meeste nuttige gegevens voor probleemoplossing kunnen worden verzameld via alleen-lezenopdrachten, zoals systeeminformatie, schijfgebruik, SMART-query's, Docker-overzichten en procesinspectie.

Een diagnostisch script mag niet stilletjes services herstarten, Docker opschonen, RAID-metadata wijzigen of logboeken verwijderen. Houd het verzamelen van bewijs gescheiden van herstelacties.

Het huidige ZimaOS biedt al meer diagnostische informatie over opslag en apps

De huidige optie Instellingen > Apps toont het opslaggebruik per applicatie en opties voor cachebeheer, terwijl Opslag informatie geeft over schijfstatus en arrays. Gebruik eerst de ingebouwde informatievoorziening en voeg daarna een communityrapport toe wanneer support een uitgebreider systeemoverzicht in één bestand nodig heeft.

De huidige hulpprogramma's voor inzicht in app-opslag kunnen veel vragen over opslagruimte beantwoorden zonder aangepast script.

Veelgestelde vragen over diagnostische snapshots

Maakt dit script een herstelbare systeemsnapshot?

Nee. Het maakt een tekstueel diagnostisch rapport.

Heeft IceWhale het script officieel overgenomen?

Nee. Zima-Giorgio sprak er lovend over en stelde voor rapporten op te slaan onder /DATA, maar de code blijft door de community gemaakt.

Moet het rapport zonder controle openbaar worden geplaatst?

Nee. Het kan IP-adressen, topologie, opslagnamen, de applicatie-inventaris en andere omgevingsdetails blootleggen.