ISP를 변경하고 ZimaOS를 재설치한 후, 한 커뮤니티 회원은 호스트에서 인터넷 사이트에 핑을 보내고 App Store 이미지를 다운로드할 수 있었지만 컨테이너 내부의 애플리케이션은 외부 서비스에 연결할 수 없다는 사실을 발견했습니다. qBittorrent는 다운로드할 수 없었고 Jellyfin은 메타데이터를 가져오지 못했습니다.
원래 사례는 문제가 발생한 컨테이너를 브리지 네트워킹에서 호스트 모드로 옮겨 해결되었습니다. 이후 답변에서는 비슷한 증상이 발생했지만 원인은 달랐던 두 번째 사례도 기록되었습니다. 공개 WAN 주소가 게이트웨이로 입력되어 있었고, 사용자의 ISP 경로에서는 Jellyfin에 IPv4와 함께 IPv6도 필요했습니다.
호스트 연결성만으로는 컨테이너 연결성을 입증할 수 없었습니다
작성자는 ZimaOS 웹 터미널을 사용하고 앱을 설치할 수 있었으므로 운영 체제 자체에는 정상적인 외부 연결 경로가 있었습니다. 하지만 이것만으로 각 Docker 네트워크에 올바른 라우팅이 설정되어 있다고 볼 수는 없습니다. 따라서 앱의 연결 실패는 호스트 상태로 추론하지 말고 컨테이너 측에서 테스트해야 했습니다.
Zima 팀원 Giorgio는 브라우저 컨테이너를 통해 연결을 테스트하고 애플리케이션 설정 패널에서 다른 네트워크 모드를 시도해 보라고 제안했습니다. 게시글에서는 서드파티 스토어, YAML 설치, CLI 설치를 통해 진단용 애플리케이션을 추가할 수 있다고도 설명하지만, 이는 선택 사항일 뿐 필수라는 확인은 없습니다.
호스트 모드로 원래의 브리지 네트워크 사례가 해결되었습니다
작성자는 영향을 받은 모든 컨테이너를 호스트 모드로 전환했고 인터넷 연결이 작동하기 시작했다고 보고했습니다. 클린 설치 후 브리지 모드가 실패한 이유는 해당 스레드에서 확인되지 않았으므로, 이 설정에서 성공한 변경 사항을 호스트 모드로 기록해야 하며 이를 보편적인 브리지 네트워크 결함의 증거로 간주해서는 안 됩니다.
이후 한 참여자는 중요한 부작용을 언급했습니다. 모드를 전환한 뒤에도 대시보드 링크가 이전에 게시된 호스트 포트를 가리킬 수 있다는 것입니다. Jellyfin의 경우 대시보드가 계속 8097 포트를 열었기 때문에, 참여자는 8096 포트로 직접 접속해야 했습니다.
이후 사례에서 잘못된 게이트웨이가 드러났습니다
두 번째 사용자의 Jellyfin 로그에는 외부 메타데이터 서비스에 연결하는 중 No route to host가 기록되어 있었습니다. 커뮤니티 회원들은 VPN을 사용하지 않은 상태에서 테스트하고 ZimaOS 네트워크 설정에 표시된 게이트웨이를 확인하라고 권고했습니다.
스크린샷을 통해 설정된 게이트웨이가 사용자의 공개 WAN 주소라는 사실이 드러났습니다. 답변에서는 게이트웨이가 같은 LAN 서브넷에 있는 로컬 라우터 주소여야 한다고 설명했습니다. 사용자는 게이트웨이를 수정하고 AT&T 연결이 IPv6를 우선 사용하기 때문에 Jellyfin에서 IPv4와 함께 IPv6도 활성화했습니다. 이후 메타데이터와 이미지가 정상적으로 가져와졌다고 확인했습니다.
두 커뮤니티 사례의 결과를 구분해야 합니다
- 2025년 10월의 원래 사례: 작성자의 컨테이너에서 브리지 네트워킹이 실패했으며, 호스트 모드로 전환하자 연결이 복구되었습니다.
- 2026년 1월 후속 사례: 게이트웨이가 공개 IP로 설정되어 있었고, 해당 ISP 경로에서 Jellyfin을 사용하려면 IPv6도 활성화해야 했습니다.
두 사례 모두 “앱이 인터넷에 연결할 수 없다”는 광범위한 증상을 보였지만, 확인된 근본 원인이 하나로 같지는 않았습니다. 해당 스레드는 네트워크 모드, 모드 변경 후 사용하는 주소, 게이트웨이 설정, VPN의 영향, 프로토콜 사용 가능 여부를 서로 다른 점검 항목으로 확인해야 한다는 점을 뒷받침합니다.
FAQ
ZimaOS에서는 앱을 다운로드할 수 있는데 컨테이너는 왜 오프라인 상태인가요?
호스트와 Docker 컨테이너는 서로 다른 라우팅 및 네트워크 설정을 사용할 수 있습니다. 원래 사례에서는 호스트 연결은 정상이었지만 브리지 네트워크를 사용하는 애플리케이션은 실패했습니다.
Jellyfin을 호스트 모드로 변경하면 기존 대시보드 포트가 유지되나요?
반드시 그렇지는 않습니다. 한 참여자는 대시보드가 계속 8097 포트로 연결했지만, 호스트 모드의 Jellyfin은 8096 포트에서 직접 접속할 수 있었다고 설명했습니다.
