저장 경로 변경 후 영화 항목 중복을 방지하는 방법

미디어 서버가 이전된 라이브러리를 스캔하기 전에 기존 경로와 새 경로가 서로 배타적이 되도록 설정하여 영화가 중복 표시되지 않게 하세요.

스토리지 마이그레이션을 진행하면 두 개의 바인드 마운트, 두 개의 라이브러리 루트, 임시 복사본 또는 기존 경로를 제거한 후에도 남아 있는 오래된 데이터베이스 레코드 때문에 같은 영화가 여러 경로로 노출될 수 있습니다. 가장 안전한 작업 흐름은 자동 스캔을 일시 중지하고, 애플리케이션 데이터베이스를 백업한 다음, 기존 경로와 새 경로를 정확히 매핑하고, 통제된 시간대에 미디어를 이동하거나 복사한 뒤, 라이브러리에서 더 이상 사용하지 않는 소스를 제거하고, 서버가 하나의 표준 위치만 인식할 수 있을 때 의도적으로 한 번만 다시 스캔하는 것입니다.

같은 영화에 접근할 수 있는 모든 경로를 매핑하세요

라이브러리 루트, Docker 바인드 마운트, 심볼릭 링크, merger 파일시스템, 네트워크 마운트, 임시 마이그레이션 폴더를 모두 나열하세요. 호스트와 컨테이너 양쪽에서 영화 하나의 실제 경로를 확인하세요.

스캐너가 새 경로를 통해 같은 파일을 다시 받는 동안 기존 데이터베이스 항목이 여전히 유효하면 중복이 자주 발생합니다. Jellyfin 마이그레이션 보고서에서는 라이브러리 폴더를 이동했을 때 중복 항목이 생성되는 문제가 재현되었습니다.

/media/movies와 같은 하나의 표준 컨테이너 경로를 선택하고, 호스트 스토리지 소스가 변경되더라도 이 경로를 안정적으로 유지하세요. 컨테이너 경로가 안정적이면 풀이나 드라이브를 마이그레이션할 때마다 애플리케이션이 새 위치를 학습할 필요가 없으므로 향후 데이터베이스 변경이 줄어듭니다.

미디어를 복사하거나 이름을 변경하기 전에 자동 스캔을 일시 중지하세요

마이그레이션 중에는 실시간 모니터링과 예약된 라이브러리 스캔을 비활성화하세요. 그렇지 않으면 폴더 이름을 단계적으로 변경하는 동안 서버가 복사 중인 일부 파일을 색인하거나 두 위치를 모두 인식하거나 같은 제목을 기록할 수 있습니다.

경로를 변경하기 전에 미디어 서버 설정과 데이터베이스를 백업하세요. 이렇게 하면 시청 상태, 아트워크 선택, 컬렉션, 사용자, 공급자 식별자 등 깨끗한 라이브러리를 새로 구축할 때 정확히 복원되지 않을 수 있는 정보를 보호할 수 있습니다.

먼저 작은 테스트 폴더 하나를 복사하거나 이동하고, 체크섬 또는 파일 크기를 확인하세요. 그런 다음 새 위치를 서비스 계정이 읽을 수 있을 때까지 기존 소스를 그대로 유지하세요. 이 검증 기간에는 두 경로가 모두 활성 라이브러리 루트로 남아 있지 않도록 하세요.

새 경로를 스캔하기 전에 기존 라이브러리 경로를 제거하세요

새 경로가 검증되면 라이브러리 설정에서 더 이상 사용하지 않는 폴더를 제거하거나, 기존 컨테이너 경로를 새 호스트 소스에 매핑하세요. 다른 라이브러리나 심볼릭 링크를 통해 기존 경로에 더 이상 접근할 수 없는지 확인하세요.

경로를 제거해도 연결된 모든 레코드가 즉시 삭제되는 것은 아닙니다. Jellyfin 이슈에서는 제거된 경로에 연결된 메타데이터가 계속 남아 있던 사례를 보고하고 있습니다. 따라서 경로 정리는 추정하지 말고 반드시 확인해야 합니다.

기존 소스에 접근할 수 없게 만든 후에만 애플리케이션에서 지원하는 라이브러리 정리 또는 전체 스캔을 실행하세요. 테스트된 백업과 버전별 복구 계획이 없다면 데이터베이스를 직접 편집하지 마세요.

-15% OFF

ZimaBoard 2 - 당신의 큰 아이디어를 위한 미니 홈 서버

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

파일이 이동되는 동안 미디어 식별 정보를 유지하세요

영화 폴더 이름, 파일 이름, 연도 표기, 에디션 라벨, 공급자 ID, 로컬 메타데이터 파일을 일관되게 유지하세요. 동영상 데이터가 동일하더라도 같은 마이그레이션 중에 제목 이름을 변경하면 다른 항목으로 인식될 수 있습니다.

로컬 메타데이터와 아트워크를 의도적으로 보관하세요. TMDB 또는 IMDb ID와 같은 식별자가 이름이나 NFO 파일에 포함되어 있다면 이를 유지하여 새 경로가 동일한 영화 식별자로 확인되도록 하세요. 그렇지 않으면 두 번째 모호한 일치 항목이 생성될 수 있습니다.

ZimaSpace의 NAS 데이터 마이그레이션 작업 흐름은 기존 복사본을 제거하기 전에 소스 데이터를 보호하고 권한을 확인하는 데 도움이 되는 관련 점검 항목입니다.

두 경로와 두 버전 또는 에디션을 구분하세요

중복 항목을 모두 열고 파일 경로, 미디어 정보, 공급자 ID, 재생 시간, 에디션 태그, 사용 가능 여부를 비교하세요. 두 항목이 두 경로를 통해 같은 파일을 가리키는 것일 수도 있고, 실제로 두 개의 물리적 복사본일 수도 있으며, 정당한 버전이 잘못 그룹화된 것일 수도 있습니다.

경로가 사라진 후에도 오래된 레코드에 접근할 수 있는 경우가 있습니다. Jellyfin 보고서에서는 이러한 항목을 유령 항목이라고 부르며, 이는 실제 두 번째 영화 파일과 혼동해서는 안 됩니다.

두 항목이 모두 활성 경로를 가리킨다면 의도하지 않은 경로를 라이브러리 범위에서 제거하세요. 한 경로가 더 이상 존재하지 않는다면 지원되는 정리 절차를 사용하고 레코드가 사라지는지 확인하세요. 파일이 의도적으로 여러 에디션으로 존재한다면 하나를 무작정 삭제하지 말고 미디어 서버에서 지원하는 이름 지정 및 그룹화 규칙을 적용하세요.

이 분류를 활용하면 데이터베이스 정리 과정에서 정당한 다른 편집본이나 더 높은 품질의 버전을 삭제하는 일을 방지할 수 있습니다.

통제된 재스캔을 한 번 실행하고 상태를 확인하세요

표준 경로가 마운트되고 기존 경로가 제거되었으며 서비스 사용자가 새 위치를 읽을 수 있을 때만 스캔을 다시 활성화하세요. 전체 스캔을 한 번 시작하고 마이그레이션된 영화 주변에서 제거 및 추가 이벤트가 발생하는지 확인하세요.

설정에서 기존 경로를 삭제한 후에도 스토리지 이동으로 인해 파일이 제거되지 않는 라이브러리가 있습니다. Jellyfin 보고서에서는 제거된 파일이 라이브러리에 남아 있던 사례를 확인할 수 있으므로, 최종 점검에서는 데이터베이스 항목과 실제 경로를 비교해야 합니다.

각 영화가 한 번만 표시되고 새 경로에서 열리며 시청 상태와 컬렉션을 유지하고 서버를 다시 시작한 후에도 정상적으로 표시되는지 확인하세요. 이 감사를 통과할 때까지 기존 스토리지는 오프라인 상태로 유지하되 그대로 보존하세요. 그런 다음 백업 및 마이그레이션 계획에 따라 폐기하세요.