가장 빠른 판별 기준은 범위입니다. 동일한 미디어가 여러 클라이언트에서 재생되지 않으면 서버나 공유 네트워크 경로를 조사하고, 한 클라이언트에서만 문제가 발생하면 해당 클라이언트부터 확인하세요.
실패한 계층이 달라도 Plex 오류는 앱에서 동일하게 표시되는 경우가 많습니다. 클라이언트가 코덱을 거부하거나 로컬 앱 상태를 잃거나 다른 재생 품질을 선택할 수 있고, 서버가 파일을 읽거나 트랜스코딩하거나 인증하거나 원격 경로에 연결하지 못할 수도 있습니다. 서버 설정을 그대로 둔 채 두 클라이언트에서 동일한 항목을 같은 시점부터 재생해 보세요. 결과에 따라 어떤 로그와 해결 방법에 우선적으로 집중할지 결정할 수 있습니다.
하나의 미디어 항목으로 클라이언트 간 범위 테스트하기
지속적으로 문제가 발생하는 항목을 선택하고 서버를 변경하지 않은 채 두 번째 클라이언트에서 재생하세요. 가능한 한 연결 유형도 비슷하게 유지하세요. 두 클라이언트가 같은 지점에서 모두 실패한다면, 격리된 앱 문제보다는 미디어 파일, 서버 읽기 경로, 트랜스코딩 또는 공유 네트워크 경로일 가능성이 높습니다.
Plex의 서버 로그 안내에서는 서버 로그를 핵심 문제 해결 도구로 다루며, 로그를 다운로드하는 기본 기능도 제공합니다. 로그를 수집하기 전에 정확한 재생 시점을 기록하세요. 하루 전체를 무작정 검색하는 대신 관련 로그 구간과 오류를 대조할 수 있습니다.
두 번째 클라이언트에서 같은 항목이 정상적으로 재생된다면 클라이언트 문제 분기를 계속 조사하세요. 앱 버전, 로컬 네트워크와 원격 경로, 재생 품질, 자막, 코덱 지원 여부, 그리고 해당 클라이언트가 정상 작동하는 클라이언트에는 필요하지 않은 트랜스코딩을 강제하고 있는지 비교하세요.
오류 문구뿐 아니라 세션 경로 비교하기
오류를 재현하는 동안 Plex 대시보드를 열고 세션을 확인하세요. 문제가 발생한 클라이언트가 다이렉트 플레이, 다이렉트 스트림 또는 트랜스코딩 중 무엇을 사용하는지, 그리고 로컬인지 원격인지 기록하세요. 같은 파일을 열더라도 두 클라이언트가 서버에 서로 다른 재생 경로를 요청한다면 동일한 테스트가 아닙니다.
문제가 발생한 클라이언트만 트랜스코딩을 실행한다면 정상 작동하는 클라이언트에서 비슷한 품질을 강제로 설정한 뒤 다시 테스트하세요. 이제 두 클라이언트에서 모두 문제가 발생한다면 원인은 클라이언트별 분기에서 서버 트랜스코딩 분기로 이동한 것입니다. 동일한 경로에서도 두 번째 클라이언트가 계속 정상 작동한다면 원래 클라이언트가 여전히 더 유력한 원인입니다.
모든 클라이언트가 원격 환경에서만 실패하고 로컬에서는 정상 작동한다면, 클라이언트 앱을 재설치하기 전에 라우터, 터널, 리버스 프록시, 릴레이, 업로드 대역폭 또는 DNS와 같은 공유 원격 경로를 조사하세요. 범위 분석은 클라이언트 문제를 분리하는 것만큼 효과적으로 네트워크 경계를 분리할 수 있습니다.
실제로 실패한 계층에서 로그 수집하기
범위 분석을 통해 서버 분기가 확인되면 문제를 한 번 재현하고 시점을 기록한 뒤 즉시 서버 로그를 다운로드하세요. 해당 이벤트 전후에서 파일 접근, 트랜스코딩, 네트워크, 데이터베이스 또는 인증 오류를 검색하세요. 지원 문서에서 구체적으로 요청하지 않는 한 최대 상세 로그를 활성화하지 마세요. 로그가 많다고 해서 증거가 자동으로 더 좋아지는 것은 아닙니다.
유사한 로그 우선 방식은 ZimaSpace 앱 문제 해결 가이드에도 나옵니다. 먼저 실패한 계층에서 시작한 다음 로그 단서를 사용해 다음으로 DNS, 포트, 권한 또는 앱 중 어느 분기를 조사할지 결정하는 방식입니다. Plex 문제 해결에도 동일한 원칙을 적용할 수 있습니다.
클라이언트 분기로 문제가 계속 한정된다면 플랫폼에서 허용하는 경우 해당 클라이언트의 앱 로그나 진단 정보를 수집하고, 서버 로그의 시점은 대조 기준으로 유지하세요. 한 엔드포인트에서만 재현되는 문제를 해결하기 위해 서버 전체 설정을 변경하지 마세요.
원래 클라이언트와 대조 클라이언트에서 수정 사항 확인하기
분리된 계층에 맞는 최소한의 수정만 적용하세요. 해당 클라이언트에서만 문제가 발생하면 클라이언트를 업데이트하거나 초기화하고, 여러 클라이언트에서 문제가 발생하면 서버 권한, 트랜스코딩 또는 네트워크 상태를 수정하세요. 그런 다음 오류가 발생했던 동일한 지점에서 같은 미디어를 다시 재생하세요.
Plex의 문제 보고 절차에서는 문제를 재현하고 구체적인 버전 및 환경 정보와 함께 로그를 수집할 것을 권장합니다. 이는 문제 해결을 요청하기 전 확인할 사항으로도 유용합니다. 시점이 기록된 재현 가능한 오류가 단순한 “재생 오류”보다 진단하기 훨씬 쉽기 때문입니다.
원래 클라이언트가 정상 작동하고 대조 클라이언트도 계속 정상적으로 작동하면 수정이 확인된 것입니다. 클라이언트 오류는 사라졌지만 모든 원격 클라이언트에서 이제 문제가 발생하는 것처럼 오류가 다른 계층으로 이동했다면 중단하고 문제를 다시 분류하세요. 처음 내린 진단에 수정 사항을 계속 덧붙이지 마세요.
지원 및 팁
더 읽어보기

Plex가 다른 Docker 컨테이너와 GPU를 공유할 수 있나요?
Plex와 다른 컨테이너가 동일한 GPU에 함께 액세스할 수 있는 경우가 많지만, 드라이버 지원, 디바이스 매핑, 비디오 엔진 부하, 메모리, 복구 동작을 테스트해야 합니다.

Plex 캐시 및 트랜스코딩 임시 저장소 구성 방법
영구 Plex 상태는 보호하면서 트랜스코딩 임시 파일은 적합한 로컬 저장소에 배치한 다음, 정리 상태와 여유 공간 및 재시작 동작을 확인하세요.

일관성이 깨진 데이터베이스를 백업하지 않고 Plex를 백업하는 방법
핵심 상태에는 Plex의 데이터베이스 백업을 사용하거나, 전체 앱 데이터 트리를 복사하기 전에 Plex를 중지한 다음 라이브 파일 복사본을 무작정 신뢰하지 말고 복원 가능성을 테스트하세요.

