이 출처의 최종 결론은 간단합니다. ZimaOS WebUI를 포트 80/443에서 변경하자 사용자의 ZimaBoard 2에서 Zima App 2.3.0 연결이 끊겼지만, ZimaOS를 버전 1.5로 업데이트한 후 사용자가 문제가 해결되었다고 알렸습니다.
따라서 이 페이지에서는 2025년의 장애를 근거로 현재 사용자에게 숨겨진 “ZimaClient 포트”를 수동으로 설정하라고 안내해서는 안 됩니다. 이는 클라이언트와 사용자 지정 WebUI 포트 간의 과거 호환성 문제였으며, 출처 자체에서 ZimaOS 1.5가 해결된 시점임을 확인할 수 있습니다.
사용자가 Nginx Proxy Manager를 위해 포트를 변경함
Nginx Proxy Manager는 일반적으로 HTTP/HTTPS 진입 트래픽에 호스트 포트 80과 443을 사용해야 합니다. 따라서 사용자는 ZimaOS를 다음과 같이 변경했습니다.
[gateway]
port = 8080
[ssl]
enabled = true
port = 30443그 후 CasaOS/ZimaOS 게이트웨이 서비스를 다시 시작했습니다.
그 후 Windows용 Zima App이 연결되지 않음
출처의 환경은 다음과 같았습니다.
- ZimaBoard 2 1664
- ZimaOS 커널 6.12.25
- Windows 11에서 실행되는 Zima App 2.3.0
WebUI 포트를 변경한 후 Windows 앱을 다시 시작하고 재연결을 시도했지만 실패했습니다.
IceWhale은 포트 설정을 추측하기보다 재현 가능한 세부 정보를 요청함
Zima-Giorgio는 사용자에게 정확한 문제 설명, 재현 단계, 이전에 변경한 내용, 시도한 해결 방법, 하드웨어, OS 버전 및 클라이언트 버전을 제공해 달라고 요청했습니다. 동일하게 보이는 연결 실패라도 검색, 원격 액세스, TLS, 포트 또는 클라이언트 버전 문제로 발생할 수 있으므로 이는 적절한 증거 수집 방식입니다.
ZimaOS 1.5로 업데이트하여 출처 사례가 해결됨
사흘 후 ThomasSpi는 다음과 같이 게시했습니다. “Zima OS 1.5로 업데이트한 후 작동합니다. 문제가 해결되었습니다.”
이는 가장 확실한 출처의 결론이며, Zima App에 사용자 지정 포트를 수동으로 설정해야 한다는 추측을 대신해야 합니다.
현재 ZimaClient는 계속 발전하고 있음
현재 IceWhale 문서에서는 ZimaClient가 LAN, 외부 네트워크, 핫스팟 및 기타 지원되는 경로에서 WebUI에 연결할 수 있는 가장 빠른 방법을 자동으로 찾는다고 설명합니다.
오래된 사용자 지정 포트 호환성 문제를 재현하기 전에 현재 ZimaClient 설치 및 연결 방식을 사용하세요.
ZimaOS 1.7.1에서 Docker Web URL 및 동적 네트워크 처리가 추가로 개선됨
1.7.1 변경 로그에는 더욱 유연한 Docker Web URL 포트 설정과 동적 네트워크 환경을 위한 URL 처리 개선 사항이 포함되어 있습니다. 이러한 변경 사항은 애플리케이션 URL과 관련된 것이며 과거 ZimaClient 버그에 대해 구체적인 사실을 입증하는 것은 아닙니다. 그러나 플랫폼의 포트 및 URL 처리가 계속 발전해 왔다는 점을 보여 줍니다.
역방향 프록시와 ZimaClient는 별도의 액세스 경로임
Nginx Proxy Manager는 앱이나 ZimaOS 대시보드에 친숙한 HTTPS 도메인을 제공할 수 있습니다. ZimaClient는 자체 검색 및 원격 액세스 로직을 사용합니다. 모든 버전에서 역방향 프록시 변경이 ZimaClient를 자동으로 재구성한다고 가정해서는 안 됩니다.
ZimaOS 대시보드를 프록시하는 경우 WebSocket을 유지해야 함
이후 2026년 커뮤니티 사례에서는 Nginx Proxy Manager를 통해 대시보드가 시각적으로 로드되었지만, WebSocket 지원을 활성화하기 전까지 실시간 위젯과 앱 대화 상자가 작동하지 않았습니다. 포트 충돌과 WebSocket 프록시 설정은 서로 다른 계층의 문제입니다.
WebUI 포트를 변경하는 더 안전한 방법
- 기존 포트를 기록합니다.
- 가능한 경우 지원되는 UI를 통해 WebUI 포트를 변경합니다.
- 새 IP:포트에서 브라우저로 직접 접속되는지 확인합니다.
- ZimaClient를 다시 시작하거나 업데이트하고 검색이 정상적으로 이루어지는지 확인합니다.
- 그 후에만 포트 80/443을 역방향 프록시에 할당합니다.
- 프록시와 클라이언트가 모두 실패할 경우를 대비해 로컬 복구 경로를 유지합니다.
ZimaClient 포트 변경 FAQ
출처의 사용자가 Zima App에서 사용자 지정 포트를 수동으로 설정하는 방법을 찾았나요?
아니요. 운영체제를 업데이트하여 문제가 해결된 것으로 스레드가 종료되었습니다.
출처 사례를 해결한 버전은 무엇인가요?
사용자는 ZimaOS 1.5에서 문제가 해결되었다고 명시적으로 보고했습니다.
현재 사용자도 ZimaClient 2.3.0의 동작이 여전히 적용된다고 봐야 하나요?
아니요. 현재의 ZimaClient와 ZimaOS 연결 처리는 훨씬 최신 버전입니다.
