Jellyfin 오류는 한 기기에서 문제가 발생하고 제어 클라이언트는 정상 작동할 때는 대개 클라이언트를 따라가며, 동일한 미디어 경로에서 여러 클라이언트가 실패할 때는 서버를 따라가는 경우가 많습니다. 코덱이나 하드웨어를 변경하기 전에 로컬 제어 테스트부터 시작하세요.
영향받은 클라이언트와 정상 작동이 확인된 클라이언트를 비교할 때 서버, 계정, 미디어, 화질을 동일하게 유지한 다음, 로컬에서 직접 재생하는 경우와 원격 또는 프록시 경로를 비교하세요. 결과에 따라 클라이언트 기능, Jellyfin 트랜스코딩 설정, 네트워크 라우팅 중 무엇을 변경할지 판단할 수 있으며, 증거가 엇갈릴 때는 언제 중단해야 하는지도 알 수 있습니다.
동일 서버의 제어 클라이언트 사용
한 클라이언트에서 재생 오류가 보고되었습니다. 가장 영향이 적은 확인부터 시작하세요. 동일한 계정과 화질로 같은 항목을 제어 클라이언트에서 재생합니다. 동일 서버 제어 테스트
중요한 관찰 결과는 구체적이어야 합니다. 제어 클라이언트는 정상 작동하는지, 두 클라이언트 모두 실패하는지, 제어 클라이언트가 다른 재생 모드를 선택하는지 확인하세요. 다른 변수를 변경하기 전에 결과를 기록합니다.
추측하지 말고 결과에 따라 분기하세요. 영향을 받은 클라이언트만 실패하면 클라이언트 영역일 가능성이 높고, 두 클라이언트 모두 실패하면 서버 또는 경로를 점검해야 합니다. 재생 모드가 다르면 먼저 코덱과 자막 경로를 비교하세요.
재생 모드와 서버 로그 확인
제어 클라이언트도 실패하거나 동일한 서버 경로를 요청합니다. 가장 영향이 적은 확인부터 시작하세요. 영향을 받은 세션과 제어 세션의 대시보드 재생 모드 및 해당 FFmpeg 또는 서버 로그 항목을 비교합니다.
중요한 관찰 결과는 구체적이어야 합니다. 두 클라이언트 모두 Direct Play에 실패하는지, 두 클라이언트 모두 트랜스코딩이 종료되는지, 한 클라이언트만 트랜스코딩하는지 확인하세요. 다른 변수를 변경하기 전에 결과를 기록합니다. FFmpeg 로그 근거
추측하지 말고 결과에 따라 분기하세요. 두 세션에서 동일한 서버 오류가 발생하면 서버 영역일 가능성이 높고, 한 세션만 트랜스코딩하면 클라이언트 기능을 다시 확인해야 합니다. 로그가 정상이라면 경로와 브라우저 상태를 테스트하세요.
로컬 직접 경로와 원격 경로 비교
클라이언트와 서버 중 어느 쪽의 문제인지 아직 확정할 수 없습니다. 가장 영향이 적은 확인부터 시작하세요. 동일한 클라이언트와 미디어를 LAN URL로 사용한 다음 원격 또는 프록시 URL로 사용합니다.
중요한 관찰 결과는 구체적이어야 합니다. 로컬에서는 정상 작동하고 원격에서는 실패하는지, 둘 다 실패하는지, 원격에서는 정상 작동하고 로컬에서는 실패하는지 확인하세요. 다른 변수를 변경하기 전에 결과를 기록합니다. 로컬 경로와 원격 경로 비교
추측하지 말고 결과에 따라 분기하세요. 원격에서만 실패하면 문제 범위를 프록시, DNS, 라우팅 또는 대역폭으로 유지하고, 둘 다 실패하면 서버 관련 근거를 다시 검토하세요. 로컬에서만 실패하면 바인딩 또는 로컬 DNS를 점검합니다.
최초 발생 조건을 다시 확인하고 담당 영역에서 중단
문제의 담당 영역은 조건에 따라 정해집니다. 가장 영향이 적은 확인부터 시작하세요. 한 가지 targeted 변경만 적용한 다음 최초 세션과 제어 세션을 다시 재생합니다.
중요한 관찰 결과는 구체적이어야 합니다. 최초 세션은 정상 작동하고 제어 세션은 안정적으로 유지되는지, 최초 세션이 여전히 실패하는지, 두 경로 모두 변경되는지 확인하세요. 다른 변수를 변경하기 전에 결과를 기록합니다.
추측하지 말고 결과에 따라 분기하세요. 최초 세션이 정상 작동하고 제어 세션도 안정적으로 유지되면 중단합니다. 여전히 실패하면 변경을 되돌리고 지정된 담당 영역 내에서 문제를 상위 단계로 넘기세요. 두 세션 모두 변경되면 가장 먼저 통제되지 않았던 변수로 돌아갑니다.
지원 및 팁
더 읽어보기

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

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

Jellyfin 백업에서 일관되지 않은 상태가 캡처되지 않도록 하는 방법
완전한 파일 복사만으로는 자동으로 일관성이 보장되지 않습니다. 쓰기를 중지하거나 원자적으로 스냅샷을 생성하고, 모든 상태 경로를 캡처한 다음 복원을 검증하세요.

