Soluzione della community

Script di istantanea diagnostica di ZimaOS: revisione del sistema, RAID, SMART, Docker, rete e 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.

Lo “script Snapshot Premium di ZimaOS” non è uno snapshot di ZimaOS nel senso di filesystem/macchina virtuale. Non crea uno snapshot Btrfs né un'immagine di backup. È uno script Bash della community che raccoglie un report diagnostico: versione del sistema, utilizzo delle risorse, temperature, filesystem, stato RAID, stato SMART, container Docker, dimensioni di AppData, configurazione di rete e processi principali.

Questo lo rende potenzialmente utile per l'assistenza, ma significa anche che il testo generato può contenere dettagli sull'ambiente che potresti non voler pubblicare. Zima-Giorgio ha apprezzato l'idea e ha suggerito di salvare i file di report iterativi in /DATA perché è più facile accedere a quella posizione da File. In questa discussione IceWhale non ha adottato né certificato lo script come strumento diagnostico integrato.

Lo script crea un unico report di sistema leggibile

Lo script sorgente raccoglie:

  • versione di ZimaOS, variante, data di compilazione, nome host, produttore, modello;
  • carico della CPU, memoria, swap e temperature;
  • utilizzo del filesystem e disposizione dei dischi;
  • stato di RAID e Btrfs;
  • stato SMART dei dischi;
  • container Docker in esecuzione e terminati;
  • dimensioni delle directory AppData e Main-Storage;
  • interfacce IPv4, bridge e route predefinita;
  • i processi che utilizzano più CPU e memoria.

Un report diagnostico non è un backup né uno snapshot del filesystem

La parola “snapshot” può essere fuorviante. Lo script scrive le informazioni di sistema in un file di testo; non acquisisce database delle applicazioni, file, livelli dei container o lo stato dello spazio di archiviazione in un determinato momento ai fini del ripristino.

Per il ripristino, usa il backup di ZimaOS, esportazioni compatibili con le applicazioni, la protezione RAID o strumenti effettivi per snapshot del filesystem o delle macchine virtuali.

Lo script originale scriveva in Main-Storage

Lo script V1 creava:

/media/Main-Storage/Zima_snapshot/

e vi memorizzava report di testo datati. Quel percorso presuppone che lo spazio di archiviazione dell'utente si chiami effettivamente Main-Storage.

Su un altro sistema, codificare quel percorso direttamente nello script può causare errori o scrivere in una posizione imprevista se il punto di montaggio non è disponibile.

Zima-Giorgio ha suggerito /DATA per facilitare l'accesso

Nella risposta finale della fonte, Zima-Giorgio ha detto che, se il progetto avesse continuato a evolversi, avrebbe suggerito di salvare i file di output in /DATA perché è più facile accedere a quella directory tramite l'app File.

Si trattava di un feedback ufficiale sul progetto della community, non di un annuncio che IceWhale avesse integrato lo script.

L'output SMART richiede un'interpretazione per dispositivo

Il report di esempio mostrava i campi SMART tradizionali degli HDD, come temperatura, settori riallocati, settori in attesa, errori CRC e ore di funzionamento. Mostrava inoltre “SMART non disponibile” per i dispositivi NVMe, perché la semplice analisi dello script non produceva un output NVMe equivalente.

Non interpretare “non disponibile” riportato da questo script come prova che l'NVMe non disponga di dati di telemetria sullo stato di salute.

Lo script è stato scritto considerando la configurazione RAID 5 dell’autore

L’esempio etichetta esplicitamente md0 e stampa una sezione «Stato RAID5». Un’altra installazione di ZimaOS può utilizzare RAID 1, RAID 6, JBOD, ZFS, dischi singoli o dispositivi md denominati diversamente.

Prima di riutilizzare lo script, esamina ogni dispositivo, percorso di mount e presupposto sul filesystem codificato nello script.

L’output Docker può esporre l’inventario delle applicazioni

Il report include i nomi delle immagini dei container e delle applicazioni. È utile al personale di supporto, ma una pubblicazione pubblica può rivelare quali servizi esegui, quali versioni sono installate e potenzialmente quali applicazioni non sono aggiornate.

Oscura i nomi dei servizi non necessari quando il report viene pubblicato al di fuori di un canale di supporto fidato.

L’output di rete può rivelare la topologia interna

Il report di esempio elenca i nomi delle interfacce, gli indirizzi IP della LAN, le reti virtuali, i bridge Docker e le route predefinite. L’autore della fonte ha oscurato manualmente parte delle informazioni sugli IP nell’esempio pubblicato.

Prima di condividere pubblicamente un report, controlla:

  • indirizzi IP e sottoreti;
  • nomi host;
  • nomi delle interfacce VPN/overlay;
  • nomi dei mount e delle condivisioni;
  • nomi delle applicazioni/dei container;
  • eventuali percorsi che includono identificatori personali.

Preferisci la diagnostica di sola lettura

Il punto di forza di questo tipo di script è che la maggior parte dei dati utili per la risoluzione dei problemi può essere raccolta tramite comandi di sola lettura, come informazioni di sistema, utilizzo del disco, query SMART, elenco Docker e ispezione dei processi.

Uno script diagnostico non dovrebbe riavviare silenziosamente i servizi, eseguire il prune di Docker, modificare i metadati RAID o eliminare i log. Mantieni separata la raccolta delle prove dalle azioni di riparazione.

ZimaOS offre già più dati diagnostici sullo storage e sulle applicazioni

La sezione Impostazioni attuali > App mostra l’utilizzo dello spazio e i controlli della cache per ogni applicazione, mentre Archiviazione espone lo stato dei dischi e le informazioni sugli array. Usa prima gli strumenti integrati, poi aggiungi un report della community quando il supporto ha bisogno di un’istantanea di sistema più ampia in un unico file.

Gli strumenti attuali per la visibilità dello spazio delle applicazioni possono rispondere a molte domande relative allo spazio senza uno script personalizzato.

Domande frequenti sull’istantanea diagnostica

Questo script crea un’istantanea di sistema recuperabile?

No. Crea un report diagnostico di testo.

IceWhale ha adottato ufficialmente lo script?

No. Zima-Giorgio lo ha elogiato e ha suggerito di archiviare i report in /DATA, ma il codice resta creato dalla community.

Il report dovrebbe essere pubblicato senza revisione?

No. Può esporre indirizzi IP, topologia, nomi dello storage, inventario delle applicazioni e altri dettagli dell’ambiente.