Jellyfin은 일반적으로 저장소를 옮긴 후 오래된 데이터를 표시합니다. 서비스가 이전 경로를 참조하거나, 새 마운트를 읽지 못하거나, 새 위치를 대상으로 유효한 스캔을 완료하지 않았기 때문입니다.
대시보드에 이전 항목, 누락된 항목 또는 두 가지가 섞여 표시되나요? 먼저 라이브러리를 삭제하거나 휴지통을 비우지 마세요. 메타데이터를 손상시키지 않고 각 분기를 테스트할 수 있도록 정확한 이전 경로와 새 경로, 마운트 상태, 서비스 소유자, 스캔 결과를 기록하세요.
Jellyfin이 실제로 인식하는 경로 확인
호스트 셸에서만 확인하지 말고 Jellyfin 프로세스 또는 컨테이너 내부에서 경로를 점검하세요. 부팅 후 마운트가 존재하는지, 서비스 계정이 샘플 파일을 나열하고 읽을 수 있는지, 컨테이너 매핑이 라이브러리 구성에 저장된 경로와 일치하는지 확인하세요.
경로가 비어 있거나 접근할 수 없다면 먼저 마운트, UID/GID 또는 컨테이너 볼륨을 수정하세요. 수동 로그인 후에만 나타나는 저장소 마운트 때문에 Jellyfin이 시작 시 빈 디렉터리를 스캔할 수 있습니다.
라이브러리 구성과 데이터베이스 레코드 하나에서 이전 경로와 새 경로를 비교하세요. 두 경로가 모두 남아 있으면 Jellyfin이 유효한 항목 하나와 오래된 참조 하나를 표시하는 것은 정상일 수 있습니다.
오래된 메타데이터와 스캔 실패 구분
경로를 읽을 수 있게 된 후 제어된 스캔을 실행하고, 로그에서 라이브러리 이름, 항목 수, 권한 오류 및 건너뛴 파일을 확인하세요. 이전 항목으로 확인된 파일 하나와 새로 추가한 파일 하나를 비교하세요. 스캔이 완료되었는데도 이전 경로가 남아 있다면 데이터베이스에 이전 위치가 여전히 포함되어 있거나, 이전 참조를 제거하지 않은 채 새 경로가 추가된 것입니다.
캐시된 포스터를 미디어 파일을 사용할 수 있다는 증거로 해석하지 마세요. 저장소 경로 규칙에 따라 마운트된 파일 시스템과 애플리케이션 경로는 별도로 확인해야 합니다.
매핑을 수정한 후 한 번만 제어된 스캔을 실행하고 항목 수와 확인된 파일 하나를 비교하세요. 경로를 수정하기 전에 반복해서 다시 스캔하면 상태가 더 혼란스러워질 수 있습니다.
분기를 확인한 후에만 복구
경로 매핑 또는 권한을 수정하고 한 번 재시작한 다음 다시 스캔하세요. 데이터베이스 경로가 잘못되었다면 라이브러리 위치를 가능한 한 최소한으로 변경하고, 오래된 항목을 정리하기 전에 예상 항목 수를 확인하세요. 대량 메타데이터 작업을 수행하기 전에 애플리케이션 데이터와 백업을 보존하세요.
재부팅 후에도 서비스가 새 경로를 계속 인식하고, 대표 클라이언트에서 항목이 재생되며, 두 번째 스캔에서도 오래된 상태가 다시 생성되지 않아야 복구가 입증됩니다. 파일 시스템에서 손상이 보고되거나, 데이터베이스에 충돌하는 경로가 포함되어 있거나, 정상적인 마운트와 재시작 후에도 문제가 재발하면 에스컬레이션하세요.
복구 후 부팅 시 마운트를 사용할 수 있는 상태에서 재시작하고 스캔을 반복하세요. 재시작 후에도 동일한 경로가 계속 표시될 때까지 오래된 데이터가 해결된 것으로 볼 수 없습니다.
경로가 계속 다시 나타날 때 에스컬레이션
정상적인 재시작, 한 번의 스캔 및 대표 항목 재생이 모두 새 경로를 사용하고 이전 항목이 다시 생성되지 않는다면 수정된 매핑을 유지하세요.
이전 경로가 다시 나타나거나, 데이터베이스에 충돌하는 식별자가 있거나, 스캔할 때마다 저장소 마운트가 변경된다면 정리를 중단하세요. 먼저 데이터베이스와 현재 경로 매핑을 보존하세요.
파일 시스템은 정상인데도 정상적인 매핑과 재시작 후 오래된 참조가 남아 있다면 백업 복원 또는 데이터베이스별 복구를 진행하도록 에스컬레이션하세요.
지원 및 팁
더 읽어보기

동시에 실행되는 컨테이너에 맞게 Jellyfin 데이터베이스 연결을 최적화하는 방법
데이터베이스 소유자는 한 명으로 시작하고 SQLite의 잠금 동작을 측정하세요. 동시성과 복구 요구 사항이 복잡성을 감수할 만한 경우에만 다른 백엔드를 추가하세요.

Jellyfin에서 중복 작업 또는 가져오기를 방지하는 방법
중복 작업은 대개 스케줄러가 겹치거나 작성자가 둘 이상일 때 발생합니다. 담당자 한 명, 경로 하나, 완료 확인 하나를 지정하세요.

데이터베이스 볼륨이 가득 찬 후 Jellyfin을 복구하는 방법
쓰기 작업을 중지하고, 데이터베이스와 WAL 파일을 보존하며, 상태를 무작정 삭제하지 않고 공간을 확보한 다음 무결성과 원래 워크로드를 확인하세요.

