Community-Lösung

ZimaOS-Diagnoseschnappschuss-Skript: System-, RAID-, SMART-, Docker-, Netzwerk- und Datenschutzüberprüfung

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.

Das „ZimaOS Premium Snapshot Script“ ist kein ZimaOS-Snapshot im Sinne eines Dateisystem- oder VM-Snapshots. Es erstellt weder einen Btrfs-Snapshot noch ein Backup-Image. Es handelt sich um ein Community-Bash-Skript, das einen Diagnosebericht mit Systemversion, Ressourcennutzung, Temperaturen, Dateisystemen, RAID-Status, SMART-Zustand, Docker-Containern, AppData-Größe, Netzwerkkonfiguration und den Prozessen mit der höchsten Auslastung erfasst.

Dadurch kann es für den Support nützlich sein, aber der erzeugte Text kann auch Umgebungsdetails enthalten, die du möglicherweise nicht öffentlich teilen möchtest. Zima-Giorgio lobte die Idee und schlug vor, iterative Berichtsdateien unter zu speichern /DATA weil dieser Speicherort über Dateien leichter zugänglich ist. IceWhale hat das Skript in diesem Thread weder als integriertes Diagnosetool übernommen noch zertifiziert.

Das Skript erstellt einen einzigen für Menschen lesbaren Systembericht

Das Quellskript erfasst:

  • ZimaOS-Version, Variante, Build-Datum, Hostname, Hersteller, Modell;
  • CPU-Auslastung, Arbeitsspeicher, Swap und Temperaturen;
  • Dateisystemauslastung und Festplattenlayout;
  • RAID- und Btrfs-Status;
  • SMART-Zustand der Laufwerke;
  • laufende und beendete Docker-Container;
  • Größen der Verzeichnisse AppData und Main-Storage;
  • IPv4-Schnittstellen, Bridges und Standardroute;
  • Prozesse mit der höchsten CPU- und Speichernutzung.

Ein Diagnosebericht ist weder ein Backup noch ein Dateisystem-Snapshot

Das Wort „Snapshot“ kann irreführend sein. Das Skript schreibt Systeminformationen in eine Textdatei. Es erfasst keine Anwendungsdatenbanken, Dateien, Container-Layer oder einen zeitpunktbezogenen Speicherzustand zur Wiederherstellung.

Verwende für Wiederherstellungszwecke ZimaOS Backup, anwendungsbezogene Exporte, RAID-Schutz oder tatsächliche Dateisystem-/VM-Snapshot-Tools.

Das ursprüngliche Skript schrieb nach Main-Storage

Das V1-Skript erstellte:

/media/Main-Storage/Zima_snapshot/

und dort datierte Textberichte zu speichern. Dieser Pfad setzt voraus, dass der Speicher des Benutzers tatsächlich Main-Storage heißt.

Auf einem anderen System kann die fest codierte Angabe dieses Pfads fehlschlagen oder an einen unbeabsichtigten Ort schreiben, wenn der Mount nicht verfügbar ist.

Zima-Giorgio schlug /DATA für einen leichteren Zugriff vor

In der abschließenden Antwort zur Quelle sagte Zima-Giorgio, dass er vorschlagen würde, die Ausgabedateien unter zu speichern, wenn das Projekt weiterentwickelt würde. /DATA weil dieses Verzeichnis über die Dateien-App leichter zugänglich ist.

Dabei handelte es sich um offizielles Feedback zum Community-Projekt, nicht um eine Ankündigung, dass IceWhale das Skript integriert hatte.

SMART-Ausgabe muss für jedes Gerät separat interpretiert werden

Der Beispielbericht zeigte herkömmliche SMART-Felder für HDDs wie Temperatur, neu zugewiesene Sektoren, ausstehende Sektoren, CRC-Fehler und Betriebsstunden. Außerdem wurde für die NVMe-Geräte „SMART nicht verfügbar“ angezeigt, weil die einfache Analyse des Skripts keine entsprechenden NVMe-Ausgaben erzeugte.

Interpretiere „nicht verfügbar“ aus diesem Skript nicht als Beweis dafür, dass die NVMe keine Zustandsdaten liefert.

Das Skript wurde für das RAID-5-Layout des Autors entwickelt

Das Beispiel kennzeichnet ausdrücklich md0 und gibt einen Abschnitt „RAID5-Status“ aus. Eine andere ZimaOS-Installation kann RAID 1, RAID 6, JBOD, ZFS, einzelne Laufwerke oder anders benannte md-Geräte verwenden.

Überprüfen Sie vor der Wiederverwendung des Skripts alle fest codierten Geräte, Mount-Pfade und Dateisystemannahmen.

Docker-Ausgaben können die Anwendungsübersicht offenlegen

Der Bericht enthält Namen von Container-Images und Anwendungen. Das ist für Supportmitarbeiter nützlich, aber eine öffentliche Veröffentlichung kann offenlegen, welche Dienste Sie betreiben, welche Versionen installiert sind und möglicherweise welche Anwendungen veraltet sind.

Machen Sie nicht benötigte Dienstnamen unkenntlich, wenn der Bericht außerhalb eines vertrauenswürdigen Supportkanals veröffentlicht wird.

Netzwerkdaten können die interne Topologie offenlegen

Der Beispielbericht listet Schnittstellennamen, LAN-IP-Adressen, virtuelle Netzwerke, Docker-Bridges und Standardrouten auf. Der Autor des Quelltexts hat in dem veröffentlichten Beispiel einen Teil der IP-Informationen manuell unkenntlich gemacht.

Überprüfen Sie vor der öffentlichen Weitergabe eines Berichts:

  • IP-Adressen und Subnetze;
  • Hostnamen;
  • Namen von VPN-/Overlay-Schnittstellen;
  • Mount- und Freigabenamen;
  • Anwendungs-/Container-Namen;
  • alle Pfade, die persönliche Identifikatoren enthalten.

Schreibgeschützte Diagnosen bevorzugen

Die Stärke eines solchen Skripts besteht darin, dass sich die meisten nützlichen Daten zur Fehlerbehebung über schreibgeschützte Befehle erfassen lassen, etwa Systeminformationen, Speicherplatznutzung, SMART-Abfragen, Docker-Auflistungen und Prozessinspektionen.

Ein Diagnoseskript sollte nicht unbemerkt Dienste neu starten, Docker bereinigen, RAID-Metadaten ändern oder Protokolle löschen. Halten Sie die Beweiserfassung von Reparaturmaßnahmen getrennt.

ZimaOS bietet bereits umfassendere Diagnoseinformationen zu Speicher und Anwendungen

Unter „Einstellungen > Apps“ wird die Speichernutzung und die Cache-Steuerung pro Anwendung angezeigt, während „Speicher“ Informationen zum Laufwerkszustand und zu Arrays bereitstellt. Verwenden Sie zuerst die integrierten Anzeigefunktionen und fügen Sie erst dann einen Community-Bericht hinzu, wenn der Support einen umfassenderen System-Schnappschuss in einer einzigen Datei benötigt.

Die aktuellen Tools zur Anzeige des Anwendungsspeichers können viele Fragen zum Speicherplatz ohne ein benutzerdefiniertes Skript beantworten.

FAQ zum Diagnose-Schnappschuss

Erstellt dieses Skript einen wiederherstellbaren Systemschnappschuss?

Nein. Es erstellt einen textbasierten Diagnosebericht.

Hat IceWhale das Skript offiziell übernommen?

Nein. Zima-Giorgio lobte ihn und schlug vor, Berichte unter /DATA, aber der Code bleibt von der Community erstellt.

Soll der Bericht ohne Überprüfung öffentlich veröffentlicht werden?

Nein. Es kann IP-Adressen, Topologie, Speichernamen, die Anwendungsübersicht und weitere Umgebungsdetails offenlegen.