작동하는 직접 URL은 문제를 실행 경로로 좁혀 줍니다
호스트 IP와 포트를 입력했을 때 애플리케이션이 열리면 컨테이너, 포트 공개, 기본 LAN 경로는 이미 정상적으로 작동하고 있는 것입니다. 문제가 있는 부분은 ZimaOS 타일이 생성한 URL, 해당 링크를 브라우저가 처리하는 방식 또는 일시적으로 오래된 애플리케이션 메타데이터일 가능성이 더 높습니다.
커뮤니티 답변에서는 Docker보다 먼저 런처가 로드되어 오래된 경로를 유지했을 가능성을 제시했습니다. 하지만 이는 입증되지 않았습니다. 사용자는 이미 Docker와 앱 관리자를 재시작했고, 전체 재부팅으로도 즉시 문제가 해결되지 않았으며, 약 하루 후에 타일이 작동하기 시작했습니다. 따라서 링크 자체를 진단할 때는 이러한 불확실성을 유지해야 합니다.
타일의 대상 주소를 정상 작동하는 주소와 비교하세요
타일을 마우스 오른쪽 버튼으로 클릭하고 열지 않은 상태에서 링크 주소를 복사하세요. 스킴, 호스트 이름, IP, 포트, 경로를 직접 입력해 작동하는 URL과 비교합니다. 잘못된 포트나 오래된 호스트 주소는 오래된 앱 메타데이터를 가리키며, HTTP와 HTTPS의 차이는 프록시 또는 브라우저 보안 처리 문제를 가리킵니다.
복사한 타일 URL을 새 탭에서 엽니다. 눈에 보이는 브라우저 오류와 함께 실패하면 해당 결과를 정확히 기록하세요. 클릭해도 새 탭이 전혀 열리지 않으면 팝업 차단, 확장 프로그램 필터링을 확인하고, 시크릿 창이나 다른 브라우저에서 같은 대시보드를 테스트하세요.
이 비교가 끝나기 전에는 컨테이너 네트워킹을 수정하지 마세요. 복사한 타일 주소가 올바르고 붙여 넣었을 때 작동한다면 문제는 대시보드 클릭 이벤트나 브라우저 프로필에 있습니다. 복사한 주소가 잘못되었다면 문제는 런처 메타데이터에 있습니다.
먼저 클라이언트와 메타데이터 계층만 새로 고치세요
캐시 없이 대시보드를 새로 고침하고, 로그아웃한 뒤 다시 로그인한 다음, 깨끗한 브라우저 프로필에서 테스트하세요. 로컬 ZimaOS 출처에 대해 페이지를 변경하거나 개인정보를 보호하는 확장 프로그램을 하나씩 비활성화하세요. 이러한 되돌릴 수 있는 확인 작업을 호스트 서비스 재시작보다 먼저 수행해야 합니다.
모든 깨끗한 클라이언트에서 동일하게 잘못된 타일 URL을 받는다면 앱 이름, 표시된 포트, 복사한 주소, 작동하는 주소, ZimaOS 버전을 기록하세요. 앱을 한 번 재시작하고 대시보드가 앱을 다시 검색할 때까지 기다립니다. 그런 다음 해결의 증거가 아니라 확인 단계로서 ZimaOS를 한 번 정상적으로 재부팅하세요.
저장 장치가 활성 상태일 때 전원 플러그를 뽑지 마세요. 원래 사용자는 전원을 완전히 차단해 보았지만 즉시 복구되지 않았으므로, 이를 기본적인 다음 단계로 권장해서는 안 됩니다. 직접 URL이 여전히 작동한다면 앱 데이터를 삭제하거나 컨테이너를 재설치하지 마세요.
직접 경로도 작동하지 않기 시작한 경우에만 컨테이너 상태를 확인하세요
ZimaOS에서 애플리케이션 상태와 공개된 포트를 확인하세요. 직접 접속이 계속 정상이라면 런처 경계에서 진단을 중단합니다. 직접 접속도 이제 실패한다면 컨테이너의 가장 먼저 발생한 관련 로그 오류를 확인하고 포트가 여전히 예상한 호스트 인터페이스에 바인딩되어 있는지 확인하세요.
문제가 있는 앱 하나와 문제가 없는 앱 하나를 테스트하세요. 오래된 포트를 사용하는 타일이 하나뿐이라면 앱별 메타데이터 문제일 가능성이 있고, 한 브라우저에서 모든 타일이 실패한다면 클라이언트 문제일 가능성이 있습니다. 업데이트 후 여러 클라이언트에서 모든 타일이 실패한다면 앱 관리자나 대시보드 계층에 대한 더 강한 근거가 됩니다.
복구 후에는 같은 브라우저에서 원래의 클릭 테스트를 반복하고, 대시보드를 새로 고친 뒤에도 테스트하며, 정상적인 재부팅을 한 번 수행한 후에도 테스트하세요. 복구란 컨테이너 상태에 단순히 “실행 중”이라고 표시되는 것이 아니라, 타일이 정상적으로 작동하는 직접 URL과 동일한 주소를 일관되게 여는 것을 의미합니다.
시스템을 초기화하는 대신 두 URL을 함께 전달해 문의하세요
문제가 다시 발생하면 복사한 타일 URL과 수동으로 작동하는 URL을 캡처하고, 필요에 따라 비공개 호스트 정보는 가리세요. 시간, 앱 이름, 브라우저, 확장 프로그램, ZimaOS 버전, 다른 클라이언트에서도 같은 문제가 발생하는지를 포함하세요.
문제가 앱 업데이트, 포트 변경, 호스트 주소 변경, 프록시 설정 또는 ZimaOS 업그레이드 후에 발생했는지 보고하세요. 이러한 유발 요인은 문제가 다시 저절로 사라질 때까지 기다리는 대신 지원팀이 오래된 매핑을 재현할 수 있는 단서를 제공합니다.
직접 접속이 작동하는 동안에는 초기화, 앱 삭제 또는 광범위한 Docker 정리를 진행하지 마세요. 원본 스레드는 자발적인 복구로 끝났고 확인된 원인은 없었으므로, 파괴적인 복구는 검증된 결함을 대상으로 하지 못한 채 증거만 없앨 수 있습니다.
FAQ
Docker를 재시작하면 모든 ZimaOS 앱 링크가 다시 생성되나요?
스레드만으로는 이를 입증할 수 없습니다. 사용자는 Docker와 앱 관리자를 재시작했지만 문제가 한동안 계속되었습니다.
클릭하면 안 되는데 타일 URL을 붙여 넣으면 작동하는 이유는 무엇인가요?
이 결과는 브라우저의 클릭 처리, 확장 프로그램 또는 대시보드 JavaScript 문제로 범위를 좁혀 줍니다. 서버를 변경하기 전에 시크릿 창과 다른 브라우저에서 테스트하세요.
문제가 있는 앱을 재설치해야 하나요?
직접 URL이 작동하고 데이터가 온전한 동안에는 재설치하지 마세요. 먼저 주소를 비교하고 런처 관련 증거를 수집하세요.
원래의 관찰 내용과 해결되지 않은 시간 경과는 ZimaOS 앱 타일 논의에서 확인할 수 있습니다.
