리버스 프록시가 재시작된 후에도 Jellyfin이 직접 로컬 로그인을 허용한다면 프록시 경로를 장애 경계로 간주하세요. 직접 로그인도 실패한다면 프록시 설정 변경을 중단하세요.
재시작된 프록시는 이전 업스트림 포트를 다시 불러오거나, 웹소켓 또는 전달된 헤더 설정을 잃거나, 다른 호스트 이름과 쿠키 범위를 적용할 수 있습니다. 먼저 Jellyfin 직접 URL을 테스트한 다음 프록시 로그와 인증 요청을 비교하세요. 한 번에 한 계층만 변경하고, 자격 증명이 노출될 수 있는 전체 URL 로깅은 피하세요.
Jellyfin 자체가 여전히 로그인을 허용하는지 확인
프록시 로그인이 재시작 직후 실패합니다. 가장 영향이 적은 확인부터 시작하세요. LAN에서 Jellyfin의 직접 로컬 주소를 열고 동일한 계정으로 로그인하세요.
확인해야 할 결과는 구체적이어야 합니다. 직접 로그인 성공, 직접 로그인에서 401 반환, 직접 URL에 연결할 수 없음 중 하나를 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요. 직접 연결과 프록시 연결 비교 테스트
추측하지 말고 결과에 따라 판단하세요. 직접 로그인이 성공하면 자격 증명은 변경하지 말고 프록시 계층을 점검하세요. 실패하면 Jellyfin 로그를 확인하고 프록시 설정 변경을 중단하세요. 연결할 수 없다면 먼저 서비스 또는 마운트 상태를 복구하세요.
업스트림, 포트 및 웹소켓 상태 확인
직접 로그인은 작동하거나, 프록시 경로만 연결할 수 없습니다. 가장 영향이 적은 확인부터 시작하세요. 프록시 업스트림 설정과 액세스 로그를 확인한 다음 프록시를 통해 Jellyfin 로그인 엔드포인트에 요청을 보내세요.
확인해야 할 결과는 구체적이어야 합니다. 502 또는 연결 거부, 로그인 페이지는 로드되지만 POST 요청 실패, 재생 중 웹소켓 오류 중 하나를 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요. 알려진 프록시 설정
추측하지 말고 결과에 따라 판단하세요. 업스트림 연결이 거부되면 주소 또는 포트를 수정하세요. 페이지는 로드되지만 POST 요청이 실패하면 헤더와 스킴을 점검하세요. 재생 웹소켓만 실패한다면 로그인 관련 변경과 분리해서 처리하세요.
알려진 프록시, 헤더, 쿠키 및 DNS 점검
프록시는 Jellyfin에 연결되지만 인증이 계속 실패하거나 로그인 루프가 발생합니다. 가장 영향이 적은 확인부터 시작하세요. 마스킹한 로그와 브라우저 도구에서 성공한 직접 요청 하나와 실패한 프록시 요청 하나를 비교하세요.
확인해야 할 결과는 구체적이어야 합니다. Jellyfin이 클라이언트로 프록시 IP를 인식하는지, 리디렉션 호스트 이름이 변경되는지, 쿠키가 거부되는지를 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요.
추측하지 말고 결과에 따라 판단하세요. 알려진 프록시 또는 전달된 헤더가 다르면 해당 설정만 수정하세요. 쿠키 또는 호스트 이름이 다르면 영향을 받은 사이트 데이터만 삭제하세요. DNS가 다르면 레코드 또는 443 포트 경로를 수정하세요.
한 계층만 다시 불러오고 로컬 및 원격 로그인 확인
프록시, 헤더, 쿠키 또는 DNS를 변경했습니다. 가장 영향이 적은 확인부터 시작하세요. 프록시를 한 번 다시 불러온 다음 로컬과 원격에서 로그인하고, 프록시를 다시 재시작한 후 재생 세션 하나를 확인하세요. 프록시 재생 경로
확인해야 할 결과는 구체적이어야 합니다. 두 경로가 모두 두 번 연속 성공하는지, 로컬은 성공하지만 원격은 실패하는지, 로그인은 성공하지만 재생은 실패하는지를 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요.
추측하지 말고 결과에 따라 판단하세요. 두 로그인 경로가 두 번째 재시작 후 모두 성공하면 중단하세요. 원격만 실패하면 프록시 또는 라우터 범위에서 계속 점검하세요. 재생이 실패하면 웹소켓 또는 스트리밍 라우팅을 별도로 수정하세요.
지원 및 팁
더 읽어보기

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

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

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

