이는 현재 Jellyfin 설정에 필요한 사항이 아니라, 특정 과거 버전에만 해당하는 문제입니다. ZimaOS 1.2.5에서 IceWhale은 Windows LAN 장치 검색 및 DLNA 관련 서비스를 추가했습니다. 이러한 서비스가 1900번과 1901번 포트를 점유하여 Jellyfin이 정상적으로 시작되거나 재시작되지 않을 수 있었습니다.
기존 공식 해결 방법은 검색 서비스를 중지하는 것이었습니다
777-Spider는 충돌을 일으키는 ZimaOS 서비스로 minidlnad.service와 ssdpd.service를 확인하고, 일시적으로 중지하고 비활성화하는 명령을 게시했습니다. 사용자가 해당 지침을 따른 후 Jellyfin이 다시 작동했습니다.
이 명령은 IceWhale 직원이 이 특정 과거 릴리스에 대해 게시한 것이므로 공식 근거 자료로 유효합니다. 현재 기본 설정으로 간주해서는 안 됩니다.
재부팅 후 충돌이 다시 발생했습니다
원문 사용자는 ZimaOS를 재시작한 후 Jellyfin이 다시 실패했다고 보고했습니다. 이후 Docker 오류에는 1901/tcp 포트가 이미 사용 중이라고 표시되었습니다.
Zima-Jerry가 1901번 포트의 사용자가 ssdpd임을 확인했습니다
Zima-Jerry는 최신 UPnP/Windows 장치 브로드캐스트 서비스가 1901번 포트를 점유했으며, 비활성화 작업이 예상대로 유지되지 않았다고 설명했습니다. 다음 릴리스가 나올 때까지는 부팅 후 ssdpd.service를 다시 중지해야 할 수 있었습니다.
IceWhale은 포트를 변경하겠다고 밝혔습니다
공식 답변에서는 ssdpd가 사용하는 1901번 포트를 예정된 릴리스에서 변경하여 Jellyfin이 검색 서비스와 더 이상 충돌하지 않도록 하겠다고도 밝혔습니다.
이후 ZimaOS 1.3.0에서 포트 충돌이 해결된 것으로 명시되었습니다
IceWhale의 ZimaOS 1.3.0 릴리스 노트에는 Plex를 사용할 수 있도록 1900번 및 1901번 포트 점유 문제를 해결했다고 명시되어 있습니다. 이 릴리스 수준의 수정 사항이 중요한 현재 기준입니다. 최신 ZimaOS 사용자는 2024년 문서에 나온다는 이유만으로 해당 오래된 서비스를 비활성화하면서 Jellyfin 문제 해결을 시작해서는 안 됩니다.
실제 오류를 바탕으로 현재 포트 충돌을 진단하세요
현재 Jellyfin 컨테이너가 address already in use 오류와 함께 실패한다면, Docker 오류에서 정확한 포트를 확인하고 어떤 호스트 프로세스 또는 컨테이너가 해당 포트를 사용 중인지 확인하세요. 과거의 ssdpd/minidlnad 버그라고 추정하지 마세요.
DLNA 및 검색 포트는 Jellyfin 웹 포트와 다릅니다
Jellyfin의 일반적인 브라우저 인터페이스는 SSDP/DLNA 검색에 사용되는 포트와 다른 포트를 사용합니다. 따라서 웹 UI는 정상적으로 작동하면서 검색 기능만 충돌할 수 있으며, 다른 서비스가 이미 사용 중인 호스트 포트를 앱 정의에서 게시하여 컨테이너가 실패할 수도 있습니다.
systemctl disable이 예상대로 유지되지 않은 이유
사용자는 처음 비활성화 명령을 실행한 후에도 재부팅하면 서비스가 다시 시작되었다고 보고했습니다. Zima-Jerry는 1.2.5 환경에서 ssdpd가 실제로 비활성화된 상태를 유지하지 않았음을 인정했습니다. 따라서 릴리스 수준의 수정 사항이 배포될 때까지는 공식 해결 방법에 따라 부팅 후 서비스를 다시 중지해야 했습니다.
Docker 오류에서 정확한 포트가 확인되었습니다
재부팅 후 발생한 오류에는 failed to bind port 0.0.0.0:1901/tcp와 address already in use가 포함되어 있었습니다. 이러한 Docker 메시지는 포트 충돌과 Jellyfin 데이터베이스 또는 미디어 권한 문제를 구분하는 가장 빠른 방법입니다.
이전 systemctl 명령은 ZimaOS 1.2.5에 한정해서 사용하세요
원문의 명령은 특정 일시적 회귀 문제에 대한 공식 해결 방법이었습니다. 최신 ZimaOS 빌드에서 검색 서비스를 중지하면 실제 충돌을 해결하지 못한 채 기능만 제거할 수 있습니다. 먼저 현재 포트를 사용 중인 주체를 확인한 다음, 실제 원인이 되는 서비스를 변경하세요.
과거 Jellyfin 포트 관련 FAQ
이 문서화된 충돌이 발생한 ZimaOS 버전은 무엇인가요?
ZimaOS 1.2.5입니다.
어떤 서비스가 관련되어 있었나요?
IceWhale 직원은 minidlnad.service와 ssdpd.service를 관련 서비스로 확인했습니다.
IceWhale은 이후 이 문제를 해결했나요?
예. ZimaOS 1.3.0 릴리스 노트에는 1900번 및 1901번 포트 점유 문제가 해결된 것으로 명시되어 있습니다.
현재 사용자가 해당 서비스를 자동으로 비활성화해야 하나요?
아니요. 먼저 현재 실제로 포트를 사용 중인 주체를 진단하세요.
