ZimaOS 대시보드에서 Jellyfin이 열리지만 휴대폰이나 TV가 로컬 네트워크에서 서버를 찾지 못한다면, Jellyfin 컨테이너는 정상적으로 작동하면서도 LAN에 연결되는 포트 또는 검색 프로토콜이 Jellyfin 클라이언트가 예상하는 것과 다를 수 있습니다. 이것이 2026년 4월 IceWhale Community 토론에서 혼란을 해결한 핵심 구분입니다.
해당 글에서 가장 중요한 내용은 설명된 ZimaOS App Store 설치가 Jellyfin을 호스트 포트 8096에 노출하지 않았다는 점입니다. ZimaOS 호스트의 8097을 Jellyfin 컨테이너 내부의 8096에 매핑했습니다. 자동 검색과 관련된 두 번째 문제도 있었습니다. Jellyfin은 7359/UDP 포트를 사용하지만, 당시 커뮤니티에서 보고한 ZimaOS 앱 정의에는 7359 포트가 TCP로 표시되어 있었습니다. 이는 서로 별개의 문제이므로 먼저 직접 액세스를 테스트한 다음 검색을 테스트해야 합니다.
Jellyfin이 ZimaOS 대시보드에서는 작동하지만 LAN에서는 작동하지 않는 이유
원 게시자는 ZimaOS 대시보드를 통해 Jellyfin을 열 수 있었지만, nmap scan에서 TCP 포트 8096을 찾지 못했고, 휴대폰과 TV의 Jellyfin 클라이언트에서도 서버를 볼 수 없었습니다. 이런 조합은 ISP나 라우터 문제처럼 보일 수 있지만, 로컬 액세스에는 일반적으로 공용 포트 포워딩이 필요하지 않습니다. 먼저 확인할 곳은 설치된 ZimaOS 앱에서 사용하는 Docker 포트 매핑입니다.
한 커뮤니티 답변에서는 처음에 다음과 같은 직접 매핑이 있는지 확인하라고 제안했습니다.
8096:8096이후 다른 참여자가 해당 글에서 사용한 App Store 패키지와 관련된, 중요한 ZimaOS 전용 세부 정보를 제공했습니다.
호스트: 8097/TCP
컨테이너: 8096/TCP따라서 호스트 포트 8096을 검색하거나 해당 포트로 접속해도 Jellyfin 웹 인터페이스가 테스트되지 않습니다. 해당 설치 환경에서 올바른 LAN 테스트 주소는 다음과 같습니다.
http://ZIMAOS_LAN_IP:8097이 때문에 ZimaOS 대시보드에서 Jellyfin을 열면 정상적으로 작동할 수 있습니다. 대시보드는 이미 앱에 구성된 Web UI 호스트 포트를 알고 있기 때문입니다.
검색 문제를 해결하기 전에 Jellyfin 수동 테스트
같은 홈 네트워크에 연결된 휴대폰, 노트북 또는 다른 기기에서 ZimaOS 서버의 LAN 주소와 Jellyfin 앱 설정에 표시된 실제 호스트 포트를 입력합니다. 해당 글에서 보고된 App Store 구성은 다음과 같습니다.
http://192.168.x.x:8097바꾸기 192.168.x.x ZimaOS 시스템의 LAN IP로 접속합니다. 이 페이지가 로드되면 Jellyfin 웹 서비스에 연결할 수 있으므로, 남은 문제는 핵심 컨테이너가 아니라 자동 검색 또는 클라이언트 설정일 가능성이 높습니다.
페이지가 로드되지 않으면 ZimaOS에서 Jellyfin 앱 설정을 열고 현재 Web UI 포트 매핑을 확인하세요. 현재 App Store 정의가 2026년 4월에 확인된 것과 정확히 같은 호스트 포트를 사용한다고 가정하지 마세요. ZimaOS 앱 템플릿과 네트워크 설정은 릴리스에 따라 변경될 수 있습니다.
Jellyfin 문서에는 8096이라고 되어 있는데 ZimaOS는 왜 8097을 사용할 수 있나요?
업스트림 Jellyfin은 8096/TCP를 기본 HTTP 포트로 사용합니다. 공식 Jellyfin 네트워킹 문서에는 HTTP용 8096/TCP와 클라이언트 검색용 7359/UDP가 나와 있습니다.
Docker를 사용하면 호스트에서 다른 외부 포트를 노출하면서 Jellyfin의 내부 포트는 그대로 유지할 수 있습니다. 다음과 같은 매핑이 그 예입니다.
8097:8096은 LAN에 있는 기기가 다음에 연결한다는 의미입니다. ZIMAOS_IP:8097이 경우 트래픽은 Jellyfin 컨테이너 내부의 8096 포트로 전달됩니다. 이는 유효한 Docker 동작이며, 두 포트 번호가 일치할 필요는 없습니다.
공식 Jellyfin 컨테이너 예시에서는 일반적으로 다음을 게시합니다. 8096:8096/tcp 및 7359:7359/udp. ZimaOS는 다른 서비스와의 충돌을 피하기 위해 호스트 측 Web UI 포트를 다르게 선택할 수 있습니다. 따라서 휴대폰이나 TV에서 중요한 값은 업스트림 기본값이 아니라 ZimaOS에 현재 표시된 호스트 포트입니다.
Jellyfin 자동 검색은 UDP 포트 7359를 사용합니다
커뮤니티 스레드의 마지막 답변에서는 두 번째 구성 세부 사항을 확인했습니다. 당시 표시된 ZimaOS Docker 설정에서는 포트 7359가 TCP로 설정되어 있었지만, Jellyfin에서는 로컬 클라이언트 검색에 이 포트를 UDP로 정의합니다.
Jellyfin의 현재 문서에서 확인되는 내용은 다음과 같습니다.
-
8096/TCP— 표준 설치에서 Jellyfin의 기본 HTTP 서비스 -
8920/TCP— 활성화된 경우 선택적 HTTPS 서비스 -
7359/UDP— 로컬 네트워크에서 Jellyfin 클라이언트 검색
현재 ZimaOS Jellyfin 앱 정의에서 7359가 여전히 TCP로 매핑되어 있다면 해당 검색 매핑을 UDP로 변경하거나 매핑을 다음과 같이 다시 생성하세요. 7359/UDP. 웹 인터페이스 매핑을 TCP에서 UDP로 변경하지 마세요. 포트 8096의 HTTP는 여전히 TCP입니다.
휴대폰 또는 TV에서 Jellyfin 서버 수동 추가
자동 검색은 편리하지만 Jellyfin을 사용하는 데 필수는 아닙니다. 직접 LAN 액세스가 작동한다면 ZimaOS에서 구성한 호스트 포트를 사용하여 Jellyfin 클라이언트에 서버를 수동으로 추가하세요.
http://ZIMAOS_LAN_IP:8097다른 ZimaOS 설치 환경에서는 다음을 바꾸세요. 8097 앱 설정에 표시된 실제 호스트 측 웹 UI 포트를 사용합니다.
수동으로 입력한 주소는 작동하지만 자동 검색이 작동하지 않는다면 Jellyfin을 다시 설치하기보다 포트 7359/UDP와 로컬 네트워크 분할에 집중하세요. 검색 브로드캐스트가 작동하려면 일반적으로 클라이언트와 서버가 서로 연결 가능한 동일한 로컬 서브넷에 있어야 합니다. 게스트 Wi-Fi 격리, VLAN 규칙 또는 방화벽 필터링으로 인해 직접 HTTP 액세스가 허용되더라도 검색이 차단될 수 있습니다.
ZimaOS에서 Jellyfin 포트 매핑을 확인하는 방법
- ZimaOS에서 Jellyfin 앱 설정을 엽니다.
- 웹 UI 또는 컨테이너 포트 매핑을 찾습니다.
- Jellyfin 컨테이너 포트
8096에 매핑된 호스트 TCP 포트를 확인합니다. - 테스트
http://ZIMAOS_LAN_IP:HOST_PORT다른 LAN 기기에서 확인합니다. - 그런 다음 포트의 검색 매핑을 확인하세요.
7359. - 자동 LAN 검색을 사용하려면 7359가 TCP가 아닌 UDP를 사용하는지 확인하세요.
- Docker 네트워크 설정을 변경한 후 Jellyfin 앱을 다시 시작하세요.
ZimaOS App Store 패키지가 아닌 사용자 지정 Docker 설치를 사용 중이라면, 공식 Jellyfin 컨테이너 가이드에 upstream 기준 매핑이 나와 있습니다.
8096:8096/tcp
7359:7359/udpNmap에서 포트 8096을 확인할 수 없다는 것은 무엇을 의미하나요?
이 특정 스레드에서는 호스트 포트 8096이 닫혀 있거나 존재하지 않는다고 해서 Jellyfin을 사용할 수 없다는 의미는 아닙니다. 커뮤니티에서 보고한 ZimaOS App Store 패키지는 호스트 포트 8097을 대신 사용했습니다. 따라서 유용한 테스트는 ZimaOS가 실제로 노출하는 포트를 스캔하는 것입니다.
nmap -p 8097 ZIMAOS_LAN_IP현재 앱 설정에 다른 호스트 포트가 표시된다면 해당 포트를 대신 스캔하세요. 이는 LAN 문제 해결을 위한 확인 용도로만 사용하세요. 집 안의 휴대폰이나 TV가 연결되도록 Jellyfin을 공용 인터넷에 직접 노출할 필요는 없습니다.
로컬 Jellyfin 액세스에 라우터 또는 ISP 포트 포워딩이 필요한가요?
아니요. 같은 홈 네트워크 내에서 통신하는 기기에는 필요하지 않습니다. 원글 작성자는 ISP 지원팀에 문의했지만, 스레드에서 설명된 증상은 로컬 Docker 포트 및 검색 문제와 관련된 것이었습니다. 공용 포트 포워딩은 의도적으로 홈 네트워크 외부에서 Jellyfin에 접속하려는 경우에만 별도의 주제가 됩니다.
Jellyfin 자체 네트워킹 가이드에서는 서비스 포트를 더 넓은 네트워크에 개방하면 노출 위험이 커진다고 경고합니다. 먼저 LAN 액세스에 집중하여 문제를 해결하세요. 원격 액세스에는 보안 영향을 이해하지 못한 채 포트를 개방하기보다, 적절하게 구성된 리버스 프록시, 프라이빗 오버레이 네트워크 또는 다른 안전한 원격 액세스 설계를 사용하세요.
ZimaOS Jellyfin LAN 문제 해결 체크리스트
- Jellyfin이 실행 중이며 ZimaOS 대시보드에서 열리는지 확인하세요.
- 앱 설정을 열고 현재 호스트-컨테이너 간 웹 UI 매핑을 기록하세요.
- 다음과 같이 표시되면
8097:8096다음 주소에 연결하세요.http://ZIMAOS_IP:8097포트 8096이 아니라, - 같은 LAN에 있는 다른 기기에서 해당 주소에 접속해 보세요.
- 직접 접속이 가능하면 Jellyfin 모바일 또는 TV 클라이언트에 주소를 수동으로 추가하세요.
- Jellyfin 검색 포트 7359가 UDP로 매핑되어 있는지 확인하세요.
- 휴대폰이나 TV가 게스트 Wi-Fi에 격리되어 있거나 차단된 VLAN에 연결되어 있지 않은지 확인하세요.
- 포트 구성을 변경한 후 Jellyfin 컨테이너를 다시 시작하세요.
- 이러한 확인을 마친 후에만 호스트 방화벽 규칙이나 더 복잡한 네트워크 분할을 조사하세요.
ZimaOS Jellyfin을 찾을 수 없음 FAQ
ZimaOS에서 Jellyfin에 사용해야 하는 포트는 무엇인가요?
ZimaOS Jellyfin 앱 설정에 표시된 호스트 측 웹 UI 포트를 사용하세요. 2026년 4월 커뮤니티 스레드에서는 App Store 설치 시 호스트 포트가 다음과 같이 사용되었습니다. 8097 Jellyfin의 내부 포트에 매핑됨 8096나중에 제공되는 모든 패키지가 동일한 호스트 포트를 사용한다고 가정하지 마세요.
Jellyfin에는 포트 8096이라고 표시되는데 ZimaOS에서는 8097을 사용하는 이유는 무엇인가요?
8096은 Jellyfin의 기본 내부 HTTP 포트입니다. Docker는 이 서비스를 다른 호스트 포트를 통해 게시할 수 있습니다. 보고된 ZimaOS 매핑은 다음과 같습니다. 8097:8096따라서 LAN 클라이언트에는 ZimaOS IP와 포트 8097이 필요했습니다.
Jellyfin 포트 7359는 TCP인가요, UDP인가요?
UDP입니다. Jellyfin의 공식 네트워킹 문서에서는 로컬 클라이언트 검색에 7359/UDP 포트를 사용하도록 안내합니다. 커뮤니티에서는 ZimaOS 앱 구성이 이를 TCP로 표시했다는 보고가 있었으며, 이로 인해 자동 검색이 방해될 수 있습니다.
ZimaOS 대시보드에서는 Jellyfin을 열 수 있는데 TV 앱에서는 열 수 없는 이유는 무엇인가요?
대시보드에서는 ZimaOS 내부에 구성된 포트를 사용해 웹 UI를 열 수 있습니다. TV 앱은 LAN에서 연결 가능한 호스트 주소와 포트에 도달해야 하며, 자동 검색은 추가로 UDP 검색 트래픽에 의존합니다. 따라서 대시보드에 접속된다는 사실만으로 검색이 올바르게 구성되었다고 볼 수는 없습니다.
자동 서버 검색 없이 Jellyfin을 사용할 수 있나요?
예. Jellyfin 클라이언트에 서버 주소를 직접 입력하세요. 해당 스레드에 보고된 매핑의 형식은 다음과 같습니다. http://ZIMAOS_LAN_IP:8097현재 호스트 포트가 다르면 해당 포트를 사용하세요.
