ZimaOS 홈 화면에서 모든 앱이 사라졌지만 서버와 데이터에는 여전히 접근할 수 있다면, NAS에 문제가 생겼거나 앱이 삭제되었다고 단정하지 마세요. 먼저 정확한 ZimaOS 버전, Docker 컨테이너가 여전히 존재하는지, 문제가 프런트엔드/대시보드의 회귀 현상에만 해당하는지 확인하세요.
원본 사례가 좋은 예입니다. ZimaOS 1.6.1에서 사용자는 여러 브라우저에서 앱이 전혀 표시되지 않아 시스템에 곧 심각한 장애가 발생할까 걱정했습니다. 1.6.2로 업그레이드한 후 앱이 다시 표시되었습니다. 이는 사용자가 직접 확인한 복구 사례이지만, 해당 스레드에는 앱이 사라지는 모든 경우가 보편적인 1.6.1 버그였음을 입증하는 IceWhale의 공식 설명은 없습니다.
1단계: 앱이 실제로 사라졌는지 확인
터미널을 열고 Docker를 확인하세요.
docker ps -a컨테이너가 여전히 목록에 표시된다면 홈 화면이 비어 있어도 앱 정의와 데이터는 남아 있을 가능성이 높습니다.
Docker 자체에서 오류가 반환된다면 문제는 대시보드보다 더 깊은 곳에 있으므로 서비스 또는 스토리지 문제로 진단해야 합니다.
2단계: 정확한 ZimaOS 버전 확인
원본 사례의 사용자는 1.6.1을 사용 중이었으며 1.6.2로 업데이트한 뒤 앱 아이콘이 복원되었다고 보고했습니다. 공식 ZimaOS 1.6.2 릴리스 노트에는 전반적인 안정성 및 스토리지 수정 사항이 설명되어 있지만, 사용자가 겪은 앱 누락 증상은 구체적으로 기록되어 있지 않습니다.
이미 최신 안정 버전을 사용 중이라면, 과거의 한 사례에서 문제가 해결되었다는 이유만으로 1.6.2로 다운그레이드하지 마세요.
3단계: 깨끗한 브라우저 세션에서 대시보드 테스트
시크릿/비공개 창을 사용하고 페이지를 강제로 새로 고침하세요. 테스트하는 동안 로컬 ZimaOS 주소에 대해 지나치게 강력한 콘텐츠 차단기나 스크립트 필터를 비활성화하세요.
원본 사용자는 이미 Brave, Firefox, Chrome을 모두 사용해 보았으므로 단일 브라우저의 단순한 캐시 문제일 가능성은 낮았습니다. 하지만 현재 발생한 문제를 확인할 때도 이 방법은 유용합니다.
4단계: IP 주소와 호스트 이름으로 테스트
직접 LAN IP 주소와 평소 사용하는 로컬 호스트 이름을 모두 열어 보세요. 한쪽에서는 앱 대시보드가 로드되고 다른 쪽에서는 로드되지 않는다면 DNS, 캐시된 프런트엔드 리소스 또는 출처별 브라우저 저장소를 조사하세요.
Docker 컨테이너가 정상적으로 실행 중인데 두 주소 모두 빈 홈 화면을 표시한다면 Docker 앱을 다시 설치하기보다 ZimaOS 프런트엔드/백엔드의 앱 목록 서비스를 중점적으로 확인하세요.
5단계: 반복적으로 재부팅하기 전에 스토리지 확인
원본 사용자는 디스크가 간헐적으로 사라지고 매일 재부팅해야 한다는 점도 언급했습니다. 이는 별도의 고우선순위 증상입니다. AppData 스토리지가 사라지면 애플리케이션이 목록에 표시되지 않거나 시작되지 않을 수 있기 때문입니다.
설정 → 스토리지로 이동하여 AppData 위치가 마운트되어 있는지 확인하세요. 최신 ZimaOS 스토리지 설정 가이드에서는 현재 디스크 및 어레이 상태 표시기를 설명합니다.
데이터가 안전한지 확인하기 전에는 앱을 다시 설치하지 마세요
컨테이너와 AppData가 여전히 존재한다면 App Store에서 다시 설치할 경우 경로가 중복되거나 새 볼륨이 생성될 수 있으며, 어느 데이터가 어느 인스턴스에 속하는지 혼란이 생길 수 있습니다.
Docker 앱 문제 해결 가이드에서는 UI에서만 앱이 사라진 경우와 실제 컨테이너가 손실된 경우를 구분하는 방법을 설명합니다.
UI 오류와 앱 오류를 구분하는 방법
| 증상 | 가능성이 높은 계층 |
|---|---|
| 홈 화면은 비어 있지만 컨테이너가 존재하고 실행 중임 | 대시보드/앱 목록 UI 또는 백엔드 메타데이터 |
| 컨테이너는 존재하지만 중지되어 있음 | Docker/앱 구성 또는 종속성 문제 |
| 컨테이너는 없지만 AppData는 존재함 | 앱 메타데이터 복구 또는 재설치 경로 |
| AppData 스토리지가 사라짐 | 스토리지 마운트, 권한 또는 디스크 문제 |
| 대시보드와 터미널 모두 사용할 수 없음 | 시스템/네트워크/서비스 장애 |
업데이트할 때와 로그를 수집할 때
최신 안정 버전의 ZimaOS가 출시되어 있고 백업이 최신 상태라면 업데이트를 진행해도 좋습니다. 특히 문제가 이전 업데이트 직후 시작되었다면 더욱 그렇습니다. 하지만 스토리지가 손상되었거나 시스템 디스크에 문제가 있다면 먼저 데이터 계층을 복구하거나 보호하세요.
최신 안정 버전에서도 문제가 계속된다면 브라우저 콘솔 오류, docker ps -a 결과, 현재 스토리지 상태, ZimaOS 버전 및 관련 시스템/앱 서비스 로그를 수집하여 지원팀에 제공하세요.
FAQ
ZimaOS 1.6.2에서 사라진 앱 아이콘 문제가 해결되었나요?
원본 사용자의 1.6.1 사례에서는 문제가 해결되었습니다. 하지만 모든 앱 누락 문제가 동일한 원인으로 발생했다는 점을 해당 스레드가 입증하지는 않습니다.
홈 화면이 비어 있으면 앱이 삭제된 것인가요?
반드시 그런 것은 아닙니다. 무엇이든 다시 설치하기 전에 docker ps -a와 AppData 스토리지를 확인하세요.
브라우저 캐시 때문에 ZimaOS 앱이 모두 숨겨질 수 있나요?
오래된 프런트엔드 리소스로 인해 UI 문제가 발생할 수 있으므로 강제 새로 고침이나 비공개 창을 사용해 보는 것이 좋습니다. 모든 깨끗한 브라우저에서 동일한 문제가 발생한다면 다음으로 서버 측을 조사하세요.
업데이트하기 전에 백업 드라이브를 구매해야 하나요?
어떤 경우든 백업을 유지하는 것은 현명하지만, 대시보드가 비어 있다는 사실만으로 데이터가 곧 손실된다고 볼 수는 없습니다. 먼저 시스템과 스토리지 상태를 확인하세요.
