Rozwiązanie społecznościowe

Skrypt diagnostyczny ZimaOS: przegląd systemu, RAID, SMART, platformy Docker, sieci i prywatności

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.

„Skrypt ZimaOS Premium Snapshot” nie jest migawką ZimaOS w znaczeniu systemu plików ani maszyny wirtualnej. Nie tworzy migawki Btrfs ani obrazu kopii zapasowej. Jest to społecznościowy skrypt Bash, który zbiera raport diagnostyczny: wersję systemu, wykorzystanie zasobów, temperatury, systemy plików, stan RAID, stan SMART, kontenery Docker, rozmiar AppData, konfigurację sieci i procesy zużywające najwięcej zasobów.

Dzięki temu może być przydatny podczas kontaktu z pomocą techniczną, ale oznacza to również, że wygenerowany tekst może zawierać informacje o środowisku, których nie chcesz publikować. Zima-Giorgio pochwalił ten pomysł i zasugerował zapisywanie kolejnych plików raportów w /DATA ponieważ ta lokalizacja jest łatwiej dostępna z poziomu aplikacji Pliki. IceWhale nie przyjęło ani nie certyfikowało tego skryptu jako wbudowanego narzędzia diagnostycznego w tym wątku.

Skrypt tworzy jeden czytelny dla człowieka raport systemowy

Skrypt źródłowy zbiera:

  • wersję ZimaOS, wariant, datę kompilacji, nazwę hosta, producenta i model;
  • obciążenie procesora, pamięć, pamięć wymiany i temperatury;
  • wykorzystanie systemu plików i układ dysków;
  • stan RAID i Btrfs;
  • stan SMART dysków;
  • uruchomione i zatrzymane kontenery Docker;
  • rozmiary katalogów AppData i Main-Storage;
  • interfejsy IPv4, mosty i trasę domyślną;
  • procesy zużywające najwięcej procesora i pamięci.

Raport diagnostyczny nie jest kopią zapasową ani migawką systemu plików

Słowo „migawka” może być mylące. Skrypt zapisuje informacje o systemie w pliku tekstowym; nie przechwytuje baz danych aplikacji, plików, warstw kontenerów ani stanu pamięci masowej z konkretnego punktu w czasie do późniejszego przywrócenia.

Do celów odzyskiwania danych użyj kopii zapasowej ZimaOS, eksportów uwzględniających aplikacje, ochrony RAID lub rzeczywistych narzędzi do tworzenia migawek systemu plików/maszyn wirtualnych.

Oryginalny skrypt zapisywał dane w Main-Storage

Skrypt V1 tworzył:

/media/Main-Storage/Zima_snapshot/

i przechowywał tam raporty tekstowe z datą. Ta ścieżka zakłada, że przestrzeń dyskowa użytkownika rzeczywiście nosi nazwę Main-Storage.

W innym systemie zakodowanie tej ścieżki na stałe może spowodować błąd lub zapis w niezamierzonym miejscu, jeśli punkt montowania będzie niedostępny.

Zima-Giorgio zasugerował /DATA dla łatwiejszego dostępu

W końcowej odpowiedzi źródłowej Zima-Giorgio powiedział, że jeśli projekt będzie nadal rozwijany, zasugeruje przechowywanie plików wyjściowych w /DATA ponieważ ten katalog jest łatwiej dostępny za pośrednictwem aplikacji Pliki.

Była to oficjalna opinia dotycząca projektu społecznościowego, a nie ogłoszenie, że IceWhale zintegrowało ten skrypt.

Dane SMART wymagają interpretacji dla każdego urządzenia

Przykładowy raport zawierał tradycyjne pola SMART dla dysków HDD, takie jak temperatura, realokowane sektory, oczekujące sektory, błędy CRC i liczba godzin pracy. Zawierał także komunikat „SMART niedostępne” dla urządzeń NVMe, ponieważ proste analizowanie danych przez skrypt nie generowało równoważnych informacji wyjściowych dla NVMe.

Nie interpretuj komunikatu „niedostępne” z tego skryptu jako dowodu, że NVMe nie udostępnia danych o stanie.

Skrypt napisano z myślą o układzie RAID 5 autora

Przykład wyraźnie oznacza md0 i wyświetla sekcję „Stan RAID5”. Inna instalacja ZimaOS może korzystać z RAID 1, RAID 6, JBOD, ZFS, pojedynczych dysków lub inaczej nazwanych urządzeń md.

Przed ponownym użyciem skryptu sprawdź każdą zakodowaną na stałe konfigurację urządzenia, ścieżkę montowania i założenie dotyczące systemu plików.

Dane wyjściowe Dockera mogą ujawnić wykaz aplikacji

Raport zawiera nazwy obrazów kontenerów i aplikacji. Jest to przydatne dla pracowników pomocy technicznej, ale publicznie udostępniony fragment może ujawnić używane usługi, zainstalowane wersje oraz potencjalnie nieaktualne aplikacje.

Usuń zbędne nazwy usług, jeśli raport jest publikowany poza zaufanym kanałem pomocy technicznej.

Dane wyjściowe sieci mogą ujawnić wewnętrzną topologię

Przykładowy raport zawiera nazwy interfejsów, lokalne adresy IP, sieci wirtualne, mosty Dockera i trasy domyślne. Autor źródła ręcznie zamaskował część informacji o adresach IP w opublikowanym przykładzie.

Przed publicznym udostępnieniem raportu sprawdź:

  • adresy IP i podsieci;
  • nazwy hostów;
  • nazwy interfejsów VPN/sieci nakładkowych;
  • nazwy punktów montowania i udziałów;
  • nazwy aplikacji/kontenerów;
  • wszelkie ścieżki zawierające dane osobowe.

Preferuj diagnostykę tylko do odczytu

Zaletą tego rodzaju skryptu jest możliwość zebrania większości przydatnych danych diagnostycznych za pomocą poleceń tylko do odczytu, takich jak informacje o systemie, wykorzystanie dysku, zapytania SMART, lista kontenerów Dockera i analiza procesów.

Skrypt diagnostyczny nie powinien po cichu restartować usług, usuwać danych Dockera, modyfikować metadanych RAID ani usuwać dzienników. Zbieranie danych powinno być oddzielone od działań naprawczych.

Bieżący ZimaOS już udostępnia więcej informacji diagnostycznych o pamięci masowej i aplikacjach

Bieżące menu Ustawienia > Aplikacje pokazuje wykorzystanie pamięci masowej przez poszczególne aplikacje i ustawienia pamięci podręcznej, natomiast Pamięć masowa udostępnia informacje o stanie dysków i macierzy. Najpierw korzystaj z wbudowanego wglądu, a następnie dodaj raport społeczności, gdy pomoc techniczna potrzebuje szerszej, jednoplikowej migawki systemu.

Bieżące narzędzia wglądu w pamięć aplikacji mogą odpowiedzieć na wiele pytań dotyczących miejsca bez używania niestandardowego skryptu.

Często zadawane pytania dotyczące migawki diagnostycznej

Czy ten skrypt tworzy możliwą do odzyskania migawkę systemu?

Nie. Tworzy tekstowy raport diagnostyczny.

Czy IceWhale oficjalnie przyjęło ten skrypt?

Nie. Zima-Giorgio pochwalił go i zasugerował przechowywanie raportów w /DATA, ale kod nadal jest tworzony przez społeczność.

Czy raport powinien zostać opublikowany publicznie bez weryfikacji?

Nie. Może ujawnić adresy IP, topologię, nazwy pamięci masowej, wykaz aplikacji i inne szczegóły środowiska.