커뮤니티 솔루션

ZimaOS 터미널 및 네트워크 위젯이 작동하지 않음

A ZimaOS dashboard suddenly showed a black network widget and both the host and app web terminals stopped opening even after a restart.

결론: 네트워크 위젯과 웹 터미널이 함께 작동하지 않으면 먼저 대시보드 외부에서 호스트가 정상인지 확인하세요

검은색 네트워크 패널과 작동하지 않는 호스트/앱 터미널은 네트워크 장애처럼 보일 수 있지만, 대시보드 자체에는 이미 접속할 수 있습니다. 무엇이든 재설치하기 전에 브라우저/UI 문제와 호스트 서비스 문제를 분리하세요.

독립적인 제어 경로로 SSH 테스트하기

현재 ZimaOS SSH 및 웹 터미널 가이드는 SSH, 기본 제공 ttyd 웹 터미널 및 ttydBridge를 지원합니다. 개발자 모드에서 SSH를 활성화한 후 다음 명령으로 테스트하세요:

ssh YOUR_ZIMA_USER@ZIMA_IP

SSH는 작동하지만 내장 터미널이 작동하지 않는다면 운영 체제와 네트워크 경로는 정상입니다. 스토리지나 이더넷 하드웨어가 아니라 브라우저, HTTPS, ttyd/WebSocket 경로 또는 대시보드 서비스에 집중하세요.

앱별 터미널과 브라우저 콘솔 테스트하기

웹 터미널 아이콘이 강조 표시된 ZimaOS 앱 설정 헤더
주 답변에서는 기본 개발자 모드 터미널을 사용할 수 없을 때 두 번째 테스트 경로로 앱별 웹 터미널 버튼을 사용하도록 안내했습니다.

앱의 설정을 열고 해당 앱의 터미널 버튼을 사용해 보세요. 그런 다음 브라우저 개발자 콘솔에서 차단된 WebSocket, 인증서 또는 혼합 콘텐츠 오류가 있는지 확인하세요. MDN의 혼합 콘텐츠 차단WebSocket 동작 설명은 브라우저 터미널과 관련이 있습니다.

HTTPS는 유용한 진단 경로입니다

HTTPS를 활성화하거나 인증서를 변경한 후 문제가 시작되었다면, 신뢰할 수 있는 LAN에서 일반적으로 지원되는 로컬 URL을 사용해 대시보드에 접속한 뒤 결과를 비교하세요. ZimaOS HTTPS 문제 해결 가이드에서는 대시보드와 앱 엔드포인트의 TLS 동작이 서로 다를 수 있는 이유를 설명합니다.

SSH도 작동하지 않는 경우

그렇다면 문제는 더 이상 내장 브라우저 터미널에만 국한되지 않습니다. 사용 가능한 경우, 직접 연결한 키보드와 모니터를 사용해 로컬 디스플레이에 표시된 IP, 인터페이스 상태 및 최근 시스템 로그를 확인하세요. ZimaOS 설치 및 업그레이드 가이드에서 현재 개발자 모드와 터미널 관련 정보를 확인할 수 있습니다.