Jellyfin이 한 명의 사용자나 한 대의 기기에서만 작동하지 않을 때는 서버 전체를 변경하는 것부터 시작하지 마세요. 문제가 있는 계정을 정상 작동이 확인된 기기에서 교차 테스트하고, 문제가 있는 기기에서 정상 작동이 확인된 계정을 테스트하세요.
이 두 가지 테스트로 간단한 진단 매트릭스를 만들 수 있습니다. 문제가 계정을 따라가면 사용자 권한과 세션 상태를 확인하세요. 문제가 기기를 따라가면 저장된 서버 주소, 앱 상태, 코덱 경로, DNS, 네트워크 경로를 확인하세요. 계정과 관계없이 특정 미디어 항목 하나에서만 문제가 발생하면 사용자나 기기를 원인으로 간주하지 말고 재생 호환성을 확인하세요.
계정 및 기기 2×2 테스트 실행
동일한 서버와 가능하면 동일한 미디어 항목을 사용하세요. 문제가 있는 사용자를 정상 작동하는 기기에서 테스트한 다음, 정상 작동하는 사용자를 문제가 있는 기기에서 테스트하세요. 증상이 어느 쪽을 따라가는지 알기 전에는 비밀번호 변경, 앱 재설치, 캐시 삭제를 피하세요.
한 기기에서 두 사용자 모두 실패하면 해당 기기 또는 네트워크 경로가 우선적인 원인입니다. 여러 기기에서 한 사용자만 실패하면 계정이 우선적인 원인입니다. 사용자와 기기의 특정 조합에서만 실패한다면 서버 전체 장애보다는 캐시된 세션 상태나 클라이언트별 설정일 가능성이 높습니다.
정확한 실패 유형을 기록하세요. 로그인 거부, 라이브러리 누락, 재생 거부, 스트림 버퍼링, 서버 연결 불가 중 무엇인지 확인해야 합니다. “Jellyfin이 작동하지 않는다”는 너무 광범위한 표현이므로 해결하기 어렵습니다. 관찰된 결과마다 다음에 확인할 항목이 다릅니다.
문제가 사용자를 따라가면 권한 및 원격 액세스 확인
문제가 있는 Jellyfin 사용자를 열고 정상 작동하는 계정과 라이브러리 액세스, 미디어 재생 권한, 트랜스코딩 권한, 원격 연결 권한을 비교하세요. 확인된 차이점은 한 번에 하나씩만 변경하세요.
Jellyfin은 미디어 재생 및 트랜스코딩이 필요한 재생을 허용할지 여부를 포함한 사용자별 재생 제어 기능을 문서화하고 있습니다. Jellyfin 사용자 재생 권한
사용자가 LAN에서는 작동하지만 원격에서는 작동하지 않는다면 자격 증명을 재설정하기 전에 해당 계정의 원격 액세스 권한과 서버의 네트워크 분류를 확인하세요. 원격에서만 거부되는 것은 인증 실패가 아니라 정상적인 정책일 수 있습니다.
문제가 기기를 따라가면 클라이언트 상태만 재설정
먼저 스킴, 호스트 이름, 포트, 리버스 프록시 하위 경로를 포함한 저장된 서버 주소를 확인하세요. 정상 작동하는 클라이언트와 문자를 하나씩 비교하세요. 오래된 직접 IP 주소나 누락된 하위 경로 때문에 서버는 정상인데 한 기기에서만 문제가 발생할 수 있습니다.
주소가 올바르다면 모든 앱 데이터를 삭제하기 전에 로그아웃한 후 다시 로그인하세요. 그런 다음 클라이언트가 지나치게 오래된 경우 업데이트하세요. 더 좁은 범위의 방법이 실패한 뒤에만 재설치하세요. 모든 데이터를 삭제하면 세션 토큰이나 저장된 서버 항목이 문제의 원인이었는지 판단할 단서가 사라집니다.
원격 기기에서는 Jellyfin 원격 액세스 경로를 사용하여 의도한 호스트 이름이나 터널 경로와 문제가 있는 클라이언트에 저장된 주소를 비교할 수 있습니다.
로그인은 되지만 재생에 실패하면 재생 경로 비교
정상 작동하는 기기와 문제가 있는 기기에서 동일한 파일을 재생하고 Jellyfin 대시보드를 확인하세요. 각 클라이언트가 직접 재생, 리먹스, 직접 스트리밍, 트랜스코딩 중 어떤 방식을 사용하는지와 자막이 활성화되어 있는지를 기록하세요.
Jellyfin의 코덱 문서에 따르면 지원되지 않는 컨테이너, 오디오, 비디오 또는 자막으로 인해 클라이언트마다 서로 다른 변환 경로가 사용될 수 있습니다. 클라이언트 코덱 호환성 따라서 데스크톱 클라이언트에서는 완벽하게 재생되는 콘텐츠가 특정 TV에서는 재생되지 않을 수 있습니다.
문제가 있는 기기에서만 트랜스코딩이 발생한다면 미디어 파일을 변경하기 전에 FFmpeg 로그와 사용자의 트랜스코딩 권한을 확인하세요. 두 클라이언트가 동일한 재생 모드를 사용하지만 한쪽에서만 실패한다면 기기의 네트워크와 앱 상태를 계속 확인하세요.
문제가 있는 기기에 대해서만 DNS 및 네트워크 경로 확인
재생 오류가 아니라 서버에 연결할 수 없는 경우, 문제가 있는 기기와 동일한 네트워크의 정상 작동 기기에서 DNS 확인 결과와 경로를 비교하세요. 먼저 의도한 호스트 이름을 테스트하세요. TLS 또는 리버스 프록시 라우팅이 호스트 이름에 의존하는 경우 직접 IP가 동일한 방식으로 작동한다고 가정하지 마세요.
Jellyfin의 문제 해결 가이드에 따르면 일치하는 웹 트래픽 로그가 전혀 없으면 요청이 서버에 도달하지 않았을 가능성이 높습니다. 네트워크 문제 해결 신호
문제가 있는 기기에서 서버 로그 항목이 전혀 생성되지 않는다면 클라이언트 계층에서 DNS, Wi-Fi/VLAN 연결 가능 여부, VPN 상태, 인증서 신뢰, 저장된 주소를 수정하세요. Jellyfin이 요청을 기록하고 애플리케이션 오류를 반환한다면 매트릭스에서 계정 또는 재생 동작을 다시 확인하세요.
원래 사용자, 기기, 미디어로 수정 사항 검증
확인된 계층을 변경한 후 정확히 원래의 조합으로 돌아가 실패했던 동작을 재현하세요. 다른 노트북에서 관리자 계정이 정상 작동한다고 해서 TV를 사용하는 해당 가정 사용자의 문제가 해결되었다는 뜻은 아닙니다.
그런 다음 클라이언트를 한 번 재시작하거나 다시 연결하여 새 세션에서도 성공 상태가 유지되는지 확인하세요. 원격 액세스와 관련된 문제를 해결했다면 기기가 여전히 LAN에 연결된 상태에서만 테스트하지 말고 외부 네트워크에서도 다시 테스트하세요.
원래의 사용자와 기기 조합이 정상 작동하고 제어 조합도 정상적으로 유지되면 중단하세요. 동일한 격리된 문제가 계속되면 매트릭스 결과, 클라이언트 버전, 서버 버전, 서버 URL, 재생 모드 및 관련 로그 발췌를 포함하여 문제를 에스컬레이션하세요.
지원 및 팁
더 읽어보기

Home Assistant를 실행 중에 백업해야 할까요, 아니면 먼저 서비스를 중지해야 할까요?
내장된 Home Assistant 백업은 실행 중에도 진행할 수 있지만, 일반 파일 시스템 복사본을 만들 때는 데이터베이스가 일관되게 백업되지 않는 한 Home Assistant를 중지하거나 일시...

유휴 시간에 Home Assistant 서버가 뜨겁거나 시끄럽게 작동하는 이유는 무엇인가요?
냉각이나 CPU 제한을 변경하기 전에 Recorder, 백업, 통합 구성 요소 및 함께 실행되는 작업을 통해 Home Assistant의 팬 작동 또는 온도 급증 원인을 분석하세요.

Home Assistant를 수리하기보다 다시 구축해야 할 때는 언제인가요?
먼저 실패한 Home Assistant 계층 중 가장 작은 부분을 복구하고, 다음으로 검증된 정상 상태를 복원하며, 지속적인 구성을 신뢰할 수 없을 때만 다시 구축하세요.

