가장 흔한 매칭 오류는 스캐너가 동영상 파일 이름에서 시즌 및 에피소드 번호를 안정적으로 인식하지 못하는 위치에 해당 정보를 넣는 것입니다.
미디어 서버는 프로그램 폴더, 시즌 폴더, 파일 이름 패턴, 에피소드 순서 소스, 로컬 NFO 데이터, 공급자 식별자 등 여러 계층을 통해 TV 에피소드를 식별합니다. 올바른 시리즈 아래에 제목이 표시되더라도 실제 파일에 S01E03과 같은 명확한 토큰이 없으면 매칭되지 않을 수 있습니다. 전체 라이브러리의 이름을 일괄 변경하기 전에 매칭에 실패한 에피소드 하나를 정상적으로 매칭된 에피소드 하나와 비교해 문제를 진단하세요.
프로그램, 시즌 또는 에피소드 매칭 중 무엇이 잘못되었는지 확인하세요
영향을 받은 항목을 열고 시리즈 식별자, 시즌 번호, 에피소드 번호, 표시 제목, 파일 경로 및 공급자 ID를 기록하세요. 이를 통해 스캐너가 올바른 프로그램을 찾았지만 에피소드 파싱에 실패한 것인지, 아니면 시리즈 전체를 잘못 식별한 것인지 확인할 수 있습니다.
Jellyfin 이슈에서는 파일이 올바른 시리즈와 시즌 아래에 배치되었지만, 미디어 파일 이름에 에피소드 토큰이 없어 에피소드 자체가 매칭되지 않은 사례를 보여 줍니다.
시리즈와 시즌은 올바르지만 에피소드 번호가 없다면 파일 이름에 집중하세요. 프로그램 식별자가 잘못되었다면 에피소드 구문을 변경하기 전에 프로그램 폴더, 연도, 공급자 ID 및 라이브러리 유형을 확인하세요.
미디어 파일 이름에 명확한 SxxExx 토큰을 넣으세요
Show Name - S01E03 - Episode Title.mkv와 같이 예측 가능한 패턴을 사용하세요. 릴리스 폴더, 다운로드 디렉터리 또는 상위 폴더에만 의존하지 말고 실제 동영상 파일 이름에 시즌 및 에피소드 토큰을 포함하세요.
1.03, 단독 에피소드 번호 또는 릴리스별 코드와 같은 대체 형식은 일관되게 인식되지 않을 수 있습니다. Jellyfin 보고서에서 단 하나의 에피소드만 감지된 사례는 명확한 시즌-에피소드 패턴 대신 1.01 및 1.02와 같은 이름을 사용했습니다.
파일 하나를 복사한 뒤 표준 패턴으로 이름을 변경하고 해당 프로그램만 다시 스캔하세요. 정상적으로 매칭되면 되돌릴 수 있는 이름 변경 목록을 만든 다음, 메타데이터를 삭제하거나 데이터베이스를 재구축하지 말고 나머지를 소규모 배치로 처리하세요.
프로그램 번호와 시즌 번호가 파서에서 서로 충돌하지 않게 하세요
프로그램 폴더 이름에는 시리즈 제목과 선택적 연도를 사용하고, 시즌 폴더는 Season 01처럼 명시적으로 지정하세요. 시즌 표시로 오인될 수 있는 추가 숫자 폴더는 만들지 마세요.
프로그램 제목에 포함된 숫자는 주변 구조가 불명확할 때 모호하게 해석될 수 있습니다. Jellyfin 이슈에서는 “The 100”, “24”, “Stargate SG-1”과 같은 제목이 시즌 번호로 해석된 사례를 설명합니다.
제목은 그대로 유지하되 계층 구조와 파일 이름 토큰을 명확히 하세요: The 100 (2014)/Season 01/The 100 - S01E01.mkv. 폴더 구조가 모호하다는 이유만으로 공식 프로그램 이름에 포함된 정당한 숫자를 삭제하지 마세요.
여러 에피소드가 포함된 파일과 버전에 올바른 패턴을 사용하세요
에피소드가 두 개 이상 포함된 파일에는 지원되는 다중 에피소드 토큰이 필요하며, 동일한 에피소드의 인코딩이 두 개라면 서버의 버전 또는 파트 이름 지정 규칙을 사용해야 합니다. 이 두 목적을 혼용하면 중복 항목이 생성되거나 서로 다른 에피소드가 하나로 묶일 수 있습니다.
사용자들은 서로 다른 이름 지정 방식으로 인해 동일한 에피소드가 두 번 이상 표시된 사례를 보고했습니다. 한 Jellyfin 이슈에서는 여러 복사본 간의 일관되지 않은 에피소드 이름 지정이 중복 항목의 원인으로 지목되었습니다.
다중 에피소드와 다중 버전 사례는 각각 따로 테스트하세요. 여러 에피소드가 결합된 파일에는 S01E01-E02와 같은 패턴을 사용할 수 있으며, 여러 화질 버전에는 동일한 에피소드 식별자와 함께 지원되는 버전 레이블을 사용해야 합니다. 애플리케이션이 파일을 올바르게 그룹화할 때까지 원본 파일을 보존하세요.
스페셜과 보너스 기능을 일반 시즌 번호에서 분리하세요
실제 스페셜 에피소드는 애플리케이션이 예상하는 스페셜 시즌에 넣으세요. 일반적으로 Season 00 폴더와 S00E## 파일 이름을 사용합니다. 비하인드 영상은 일반 에피소드 번호를 임의로 부여하지 말고 지원되는 추가 콘텐츠 구조에 배치하세요.
최근 Jellyfin 테스트에 따르면 여러 이름 지정 역할이 하나의 시즌에 함께 존재할 때 스페셜 기능과 에피소드 변형이 충돌할 수 있습니다. 이 실패 양상은 단순한 프로그램 수준의 메타데이터 오류가 아니라 혼합된 변형 및 스페셜 기능에 해당합니다.
보너스 파일 하나를 지원되는 추가 콘텐츠 또는 스페셜 위치로 옮긴 다음 해당 항목만 다시 스캔하세요. 일반 에피소드가 즉시 매칭된다면 보너스 콘텐츠를 파서의 기본 에피소드 순서에서 분리해 두세요.
파일 이름을 올바르게 지정했더라도 이름을 변경하기 전에 에피소드 순서를 확인하세요
파일에 올바른 SxxExx 토큰이 있어도 라이브러리가 방영 순서를 기준으로 예상하는 반면 파일은 DVD 순서, 절대 번호, 제작 순서 또는 다른 공급자별 순서를 사용하면 제목이 잘못 표시될 수 있습니다.
Jellyfin 이슈에서는 선택한 메타데이터 공급자와 표시 순서에 따른 에피소드 순서 문제가 확인되었습니다. 파일 이름 구조가 올바르더라도 공급자별 순서가 다를 수 있음을 보여 준 사례입니다.
이름을 변경하기 전에 선택한 공급자의 에피소드 목록과 시즌 하나를 비교하세요. 파일이 이미 정당한 순서와 일치한다면 라이브러리 또는 시리즈의 순서를 변경하고, 의도한 소스와 번호가 실제로 일치하지 않을 때만 파일 이름을 변경하세요.
하나의 관리된 폴더를 다시 스캔하고 이름 변경 목록을 보존하세요
일반 에피소드 하나, 다중 에피소드 파일 하나, 스페셜 하나, 대체 버전 하나가 포함된 테스트 폴더를 만드세요. 제안한 이름 지정 패턴을 적용한 다음, 격리된 임시 라이브러리에서 해당 폴더를 스캔하세요.
ZimaSpace의 애플리케이션별 이름 지정 규칙 가이드는 미디어 라이브러리에 일반적인 파일 이름 표준이 아니라 자체적으로 예측 가능한 규칙이 필요한 이유를 설명합니다.
모든 테스트 항목에 올바른 프로그램, 시즌, 에피소드, 에디션 및 제목이 지정되고, 중복 항목이 나타나지 않으며, 메타데이터 새로 고침 후에도 결과가 유지되면 이름 지정 수정이 완료된 것입니다. 재생 목록, 백업 도구 및 기타 애플리케이션을 안전하게 업데이트할 수 있도록 이전 이름과 새 이름의 변경 목록을 보관하세요.
지원 및 팁
더 읽어보기

Docker 볼륨을 복원하면 파일 내용은 복원되지만 확장 속성은 사라지는 이유는 무엇인가요?
xattr 인벤토리, tar 및 Rsync 옵션, 네임스페이스, 대상 지원, 권한, 레이블, 앱 메타데이터와 테스트를 다루는 볼륨 복원 진단.

Compose 파일을 변경한 후에도 실행 중인 컨테이너의 메모리 제한이 기존 값으로 유지되는 이유는 무엇인가?
실행 중인 cgroup, 재시작과 재생성, Compose 필드, 하드 및 소프트 제한, 상위 범위, 스왑, 런타임 힙을 다루는 메모리 제한 진단입니다.

리버스 프록시를 재시작하면 셀프 호스팅 앱 하나의 모든 세션이 무효화되는 이유는 무엇인가요?
재시작 범위, 쿠키 소유권, 비밀 키 순환, 캐시 기반 세션, 스티키 라우팅, 인증 게이트웨이 및 복구를 다루는 세션 손실 진단.

