대부분의 Jellyfin 컨테이너는 브리지 네트워킹으로 시작하고 필요한 포트만 노출하세요. 테스트된 검색 또는 네트워크 토폴로지 요구 사항이 있을 때만 호스트 모드를 선택하세요.
홈 서버에서 브리지 모드는 경계를 좁게 유지하고 포트 매핑을 명시적으로 설정할 수 있습니다. 반면 호스트 모드는 이 계층을 제거해 검색을 단순화할 수 있지만 더 넓은 노출이 발생합니다. 먼저 브리지 기준 구성을 만들고 로컬 및 원격 재생을 테스트한 다음, 실패한 기능이 명확히 확인된 경우에만 호스트 모드로 한 가지 변경을 적용하세요.
가장 제한적인 네트워크 기준 구성 선택
컨테이너의 검증된 네트워크 기준 구성이 없습니다. 가장 영향이 적은 확인부터 시작하세요. 필요한 클라이언트 경로를 나열합니다: 로컬 웹, 로컬 재생, 원격 프록시, 선택적 검색.
유용한 관찰 결과는 구체적이어야 합니다. 모든 경로가 명시적 포트를 사용하고, 검색만 누락되며, 프록시에 호스트 토폴로지가 필요합니다. 다른 변수를 변경하기 전에 결과를 기록하세요. 브리지 네트워크 격리
추측하지 말고 분기 결과를 해석하세요. 명시적 포트로 경로가 충족되면 브리지를 유지하고, 검색만 실패하면 호스트 모드로 전환하기 전에 검색 매핑을 테스트하세요. 프록시에 호스트 바인딩이 필요하다면 해당 예외를 문서화하세요.
브리지 네트워킹 구성 및 확인
브리지 모드를 기준 구성으로 선택했습니다. 가장 영향이 적은 확인부터 시작하세요. 선택한 포트를 매핑하고, 호스트 URL에 로컬로 접속한 다음 Direct Play 세션 하나와 트랜스코딩 세션 하나를 재생하세요.
유용한 관찰 결과는 구체적이어야 합니다. 웹과 재생이 모두 통과하거나, 웹은 통과하지만 미디어가 실패하거나, 원격 프록시만 실패합니다. 다른 변수를 변경하기 전에 결과를 기록하세요. Jellyfin 포트 매핑
추측하지 말고 분기 결과를 해석하세요. 로컬 재생이 통과하면 브리지를 유지하고, 미디어가 실패하면 매핑과 로그를 확인하세요. 원격 연결만 실패한다면 네트워크 모드를 변경하지 말고 프록시와 라우터 경로를 테스트하세요.
명확한 예외가 있을 때만 호스트 네트워킹 테스트
특정 검색 또는 바인딩 요구 사항을 제외하면 브리지가 정상적으로 작동합니다. 가장 영향이 적은 확인부터 시작하세요. 동일한 데이터 마운트를 사용해 컨테이너를 호스트 모드로 다시 생성하고 동일한 클라이언트와 포트를 테스트하세요.
유용한 관찰 결과는 구체적이어야 합니다. 지정한 기능이 작동하거나, 아무것도 변경되지 않거나, 다른 서비스가 포트를 잃습니다. 다른 변수를 변경하기 전에 결과를 기록하세요.
추측하지 말고 분기 결과를 해석하세요. 지정한 기능이 작동하고 노출 범위를 허용할 수 있다면 호스트 모드를 문서화하세요. 아무것도 변경되지 않으면 브리지로 되돌리세요. 충돌이 발생하면 호스트 모드는 적합하지 않습니다.
재시작 및 프록시 변경 후 연결 가능성 확인
브리지 또는 호스트 모드를 선택했습니다. 가장 영향이 적은 확인부터 시작하세요. 컨테이너를 한 번 재시작하고 로컬 및 원격 재생을 테스트한 다음, 필요한 경우 검색 기능을 확인하세요.
유용한 관찰 결과는 구체적이어야 합니다. 모든 경로가 통과하거나, 검색만 실패하거나, 원격 프록시만 실패합니다. 다른 변수를 변경하기 전에 결과를 기록하세요. 원격 경로 테스트
추측하지 말고 분기 결과를 해석하세요. 필요한 모든 경로가 통과하면 중단하세요. 검색만 실패한다면 브리지를 유지하고 명시적인 클라이언트 설정을 사용하세요. 프록시가 실패한다면 네트워킹 범위를 넓히지 말고 프록시 라우팅을 수정하세요.
지원 및 팁
더 읽어보기

Jellyfin이 다른 컨테이너와 GPU 또는 가속기를 안전하게 공유할 수 있나요?
GPU 공유는 조건부로 지원됩니다. 먼저 장치가 표시되는지와 드라이버가 지원되는지 확인한 다음, 두 워크로드를 모두 실행하고 소프트웨어 폴백이 발생하는지 지켜보세요.

Jellyfin 오류가 클라이언트에서 발생했는지 서버에서 발생했는지 확인하는 방법
Jellyfin 오류는 한 기기에서만 발생하면 클라이언트 문제이고, 동일한 경로에서 여러 클라이언트가 실패하며 로그 내용도 일치하면 서버 문제입니다.

Jellyfin 캐시 및 임시 저장소 구성 방법
지속적인 상태 데이터, 재구축 가능한 캐시, 임시 트랜스코딩 저장 공간을 분리한 다음 실제 재생 테스트로 용량과 권한을 확인하세요.

