ZimaOS 1.7 베타에서는 앱 타일의 웹 URL을 편집하는 방식이 변경되었습니다. 사용자는 프로토콜, 포트, 경로를 변경할 수 있었지만 호스트 이름은 ZimaOS 대시보드 주소에 연결되어 있었습니다. 그렇다고 해서 Nginx Proxy Manager나 로컬 DNS가 독립적으로 사용자 지정 도메인을 제공하는 것이 제한되지는 않았습니다.
당시 IceWhale 팀의 답변에서는 시각적 편집기에서 호스트 이름을 편집할 수 없다고 확인했으며, 팀에서 이 기능을 다시 제공할 계획이라고 밝혔습니다. 현재 ZimaOS 1.7.1에서는 Docker 웹 URL 포트 설정과 URL 처리가 개선되었지만, 공개된 변경 로그에는 시각적 편집기에서 임의의 호스트 이름 편집 기능이 복원되었다는 내용이 명시적으로 나와 있지 않습니다.
1.7 베타에서 실제로 변경된 사항
사용자는 https://app.example.net/과 같은 로컬 DNS 및 리버스 프록시 구성을 사용하고 있었습니다. 베타 편집기에서는 앱 타일이 해당 사용자 지정 호스트 이름을 열도록 더 이상 구성할 수 없었습니다.
커뮤니티에서 재현한 결과, x-casaos.hostname을 수동으로 설정하면 YAML에는 해당 값이 남아 있을 수 있지만 양식과 앱 타일에서는 여전히 대시보드 IP를 사용하는 것으로 나타났습니다. 이후 IceWhale 직원은 시각적 호스트 이름 필드를 일시적으로 사용할 수 없다고 확인했습니다.
리버스 프록시에서는 여전히 사용자 지정 도메인을 사용할 수 있습니다
해당 스레드에서 설명한 제한은 ZimaOS 앱 타일이 여는 URL에 관한 것이었으며, Nginx Proxy Manager, AdGuard Home 또는 다른 DNS/리버스 프록시 스택이 게시된 앱 포트로 사용자 지정 호스트 이름을 라우팅할 수 있는지와는 관련이 없었습니다.
프록시가 이미 도메인을 올바른 ZimaOS IP와 앱 포트로 전달하고 있다면, 해당 프록시 경로를 대시보드 타일 설정과 분리해 유지하세요. ZimaOS HTTPS 리버스 프록시 가이드에서 이러한 구성을 다룹니다.
ZimaOS 1.7.1에서 확인되는 사항
공식 ZimaOS 1.7.1 변경 로그에는 더욱 유연해진 웹 URL 포트 구성과 개선된 Docker URL 처리가 나와 있습니다. 하지만 기존 호스트 이름 편집기가 복원되었다는 내용은 구체적으로 문서화되어 있지 않습니다.
현재 ZimaOS 앱 메타데이터 참조 문서에는 앱 진입 URL에 사용되는 port_map, scheme, index가 설명되어 있습니다. 기존 프록시 구성을 이전 베타 동작을 기준으로 다시 구축하기 전에 현재 안정 버전의 편집기를 테스트하세요.
베타 버전에서 다운그레이드해야 하나요?
이 특정 문제에 대해 포럼에서는 사용자 지정 도메인 자체가 여전히 리버스 프록시를 통해 작동하므로 성급하게 롤백하지 말라고 조언했습니다. 현재로서는 최신 안정 버전의 ZimaOS로 이동하고, 앱 구성을 백업한 다음, 해당 환경에서 앱 타일 동작을 확인하는 것이 우선입니다.
앱 YAML을 가져오거나 복구해야 한다면, 베타 시절의 해결 방법을 그대로 복사하는 것보다 사용자 지정 Docker Compose 가이드를 참고하는 편이 안전합니다.
