“ZimaOS Premium Snapshot Script”는 파일 시스템/VM 관점의 ZimaOS 스냅샷이 아닙니다. Btrfs 스냅샷이나 백업 이미지를 생성하지 않습니다. 시스템 버전, 리소스 사용량, 온도, 파일 시스템, RAID 상태, SMART 상태, Docker 컨테이너, AppData 크기, 네트워크 구성 및 주요 프로세스를 수집하는 커뮤니티 Bash 스크립트입니다.
이는 지원에 유용할 수 있지만, 생성된 텍스트에 공개적으로 게시하고 싶지 않은 환경 세부 정보가 포함될 수도 있음을 의미합니다. Zima-Giorgio는 이 아이디어를 긍정적으로 평가하며 반복적으로 생성되는 보고서 파일을 다음 위치에 저장하자고 제안했습니다. /DATA 해당 위치가 Files에서 더 쉽게 접근할 수 있기 때문입니다. 이 스레드에서 IceWhale은 해당 스크립트를 기본 제공 진단 도구로 채택하거나 인증하지 않았습니다.
스크립트는 사람이 읽기 쉬운 단일 시스템 보고서를 생성합니다
소스 스크립트가 수집하는 정보:
- ZimaOS 버전, 변형, 빌드 날짜, 호스트 이름, 제조업체, 모델;
- CPU 부하, 메모리, 스왑 및 온도;
- 파일 시스템 사용량 및 디스크 레이아웃;
- RAID 및 Btrfs 상태;
- 디스크의 SMART 상태;
- 실행 중이거나 종료된 Docker 컨테이너;
- AppData 및 Main-Storage 디렉터리 크기;
- IPv4 인터페이스, 브리지 및 기본 경로;
- CPU 및 메모리 사용량이 높은 프로세스.
진단 보고서는 백업이나 파일 시스템 스냅샷이 아닙니다
“스냅샷”이라는 단어는 오해를 불러일으킬 수 있습니다. 이 스크립트는 시스템 정보를 텍스트 파일에 기록할 뿐이며, 애플리케이션 데이터베이스, 파일, 컨테이너 레이어 또는 복원을 위한 특정 시점의 저장소 상태를 캡처하지 않습니다.
복구 목적으로는 ZimaOS 백업, 애플리케이션 인식형 내보내기, RAID 보호 또는 실제 파일 시스템/VM 스냅샷 도구를 사용하세요.
원본 스크립트는 Main-Storage에 기록했습니다
V1 스크립트가 생성한 항목:
/media/Main-Storage/Zima_snapshot/그리고 그곳에 날짜가 포함된 텍스트 보고서를 저장했습니다. 이 경로는 사용자의 저장 공간 이름이 실제로 Main-Storage라고 가정합니다.
다른 시스템에서는 해당 마운트가 사용할 수 없을 경우 이 경로를 하드코딩하면 실패하거나 의도하지 않은 위치에 파일이 기록될 수 있습니다.
더 쉽게 접근할 수 있도록 Zima-Giorgio가 제안한 /DATA
최종 소스 답변에서 Zima-Giorgio는 프로젝트가 계속 개선된다면 출력 파일을 다음 위치에 저장하자고 제안했습니다. /DATA 해당 디렉터리는 Files 앱을 통해 더 쉽게 접근할 수 있기 때문입니다.
이는 커뮤니티 프로젝트에 대한 공식 피드백이었으며, IceWhale이 해당 스크립트를 통합했다는 발표가 아니었습니다.
SMART 출력은 장치별로 해석해야 함
예시 보고서에는 온도, 재할당 섹터, 보류 중인 섹터, CRC 오류, 전원 켜짐 시간과 같은 기존 HDD SMART 필드가 표시되었습니다. 또한 스크립트의 단순한 파싱으로는 이에 상응하는 NVMe 출력이 생성되지 않았기 때문에 NVMe 장치에 대해 “SMART를 사용할 수 없음”이라고 표시되었습니다.
이 스크립트에서 “사용할 수 없음”이라고 표시된다고 해서 NVMe에 상태 정보가 없다는 증거로 해석해서는 안 됩니다.
이 스크립트는 작성자의 RAID 5 구성에 맞춰 작성되었습니다.
예시에는 명시적으로 다음과 같이 표시되어 있습니다. md0 그리고 “RAID5 상태” 섹션을 출력합니다. 다른 ZimaOS 설치에서는 RAID 1, RAID 6, JBOD, ZFS, 단일 디스크 또는 이름이 다르게 지정된 md 장치를 사용할 수 있습니다.
스크립트를 재사용하기 전에 하드코딩된 모든 장치, 마운트 경로 및 파일 시스템 가정을 검토하세요.
Docker 출력으로 애플리케이션 목록이 노출될 수 있습니다
보고서에는 컨테이너 이미지 이름과 애플리케이션 이름이 포함됩니다. 이는 지원 담당자에게 유용하지만, 공개 게시물에서는 실행 중인 서비스, 설치된 버전 및 잠재적으로 오래된 애플리케이션을 파악할 수 있습니다.
신뢰할 수 있는 지원 채널 외부에 보고서를 게시할 경우 불필요한 서비스 이름을 삭제하세요.
네트워크 출력으로 내부 토폴로지가 노출될 수 있습니다
예시 보고서에는 인터페이스 이름, LAN IP 주소, 가상 네트워크, Docker 브리지 및 기본 경로가 나열되어 있습니다. 원문 작성자는 게시된 예시에서 IP 정보 일부를 수동으로 가렸습니다.
보고서를 공개적으로 공유하기 전에 다음을 검토하세요.
- IP 주소 및 서브넷
- 호스트 이름
- VPN/오버레이 인터페이스 이름
- 마운트 및 공유 이름
- 애플리케이션/컨테이너 이름
- 개인 식별 정보가 포함된 모든 경로
읽기 전용 진단을 우선하세요
이러한 스크립트의 장점은 시스템 정보, 디스크 사용량, SMART 조회, Docker 목록 및 프로세스 검사와 같은 읽기 전용 명령을 통해 대부분의 유용한 문제 해결 데이터를 수집할 수 있다는 것입니다.
진단 스크립트가 조용히 서비스를 다시 시작하거나, Docker를 정리하거나, RAID 메타데이터를 수정하거나, 로그를 삭제해서는 안 됩니다. 증거 수집 작업과 복구 작업을 분리하세요.
현재 ZimaOS는 이미 더 많은 스토리지 및 앱 진단 정보를 제공합니다
현재 설정 > 앱에는 애플리케이션별 저장 공간 사용량과 캐시 제어 기능이 표시되며, 저장 공간에서는 디스크 상태와 어레이 정보를 확인할 수 있습니다. 먼저 기본 제공 가시성 기능을 사용한 다음, 지원팀에서 더 광범위한 단일 파일 시스템 스냅샷을 필요로 할 때 커뮤니티 보고서를 추가하세요.
맞춤형 스크립트 없이도 많은 저장 공간 관련 질문에 답할 수 있도록 현재 앱 저장 공간 가시성 도구를 사용할 수 있습니다.
진단 스냅샷 FAQ
이 스크립트가 복구 가능한 시스템 스냅샷을 생성하나요?
아니요. 텍스트 형식의 진단 보고서를 생성합니다.
IceWhale은 이 스크립트를 공식적으로 채택했나요?
아니요. Zima-Giorgio는 이를 높이 평가하며 보고서를 다음 위치에 저장할 것을 제안했습니다. /DATA하지만 코드는 여전히 커뮤니티에서 작성되었습니다.
검토 없이 보고서를 공개적으로 게시해야 하나요?
아니요. IP 주소, 네트워크 토폴로지, 스토리지 이름, 애플리케이션 목록 및 기타 환경 세부 정보가 노출될 수 있습니다.
