저장소 경로를 변경한 후 영화가 중복 등록되는 것을 방지하는 방법

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

미디어 서버가 마이그레이션된 라이브러리를 검색하기 전에 이전 경로와 새 경로가 동시에 노출되지 않도록 하여 영화 중복을 방지하세요.

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

같은 영화에 연결될 수 있는 모든 경로 매핑하기

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

스캐너가 새 경로의 같은 파일을 인식하는 동안 이전 데이터베이스 항목이 여전히 유효한 상태로 남아 중복이 생기는 경우가 많습니다. 라이브러리 폴더를 이동하면 중복 항목이 생성되는 문제가 Jellyfin 마이그레이션 보고서에서 재현되었습니다.

/media/movies처럼 기준이 되는 컨테이너 경로를 하나 정하고, 호스트 저장소의 소스가 바뀌더라도 이 경로를 유지하세요. 컨테이너 경로를 안정적으로 유지하면 풀이나 드라이브를 마이그레이션할 때마다 애플리케이션이 새 위치를 학습할 필요가 없으므로 향후 데이터베이스 변경을 줄일 수 있습니다.

미디어를 복사하거나 이름을 변경하기 전에 자동 검색 일시 중지

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

경로를 변경하기 전에 미디어 서버 설정과 데이터베이스를 백업하세요. 시청 상태, 아트워크 선택, 컬렉션, 사용자 및 제공업체 식별자가 보존되므로, 라이브러리를 새로 구축할 때 정확히 재현하지 못할 수 있는 정보를 보호할 수 있습니다.

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

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

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

경로를 제거해도 관련 레코드가 모두 즉시 삭제되지는 않을 수 있습니다. Jellyfin 이슈에 따르면 제거된 경로와 연결된 메타데이터가 남아 있었습니다. 따라서 경로 정리는 당연히 완료됐다고 여기지 말고 확인해야 합니다.

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

파일을 옮기는 동안 미디어 식별 정보 보존하기

영화 폴더 이름, 파일명, 연도 표시, 에디션 라벨, 제공업체 ID, 로컬 메타데이터 파일을 일관되게 유지하세요. 같은 마이그레이션 중에 제목을 변경하면 비디오 데이터가 바뀌지 않았더라도 다른 항목으로 인식될 수 있습니다.

로컬 메타데이터와 아트워크를 신중하게 보관하세요. TMDB 또는 IMDb ID 같은 식별자가 이름이나 NFO 파일에 포함되어 있다면 보존하여 새 경로에서도 동일한 영화로 인식되도록 하세요. 그래야 모호하게 중복 인식되는 일을 막을 수 있습니다.

ZimaSpace NAS 데이터 마이그레이션 워크플로는 원본 데이터를 보호하고 이전 사본을 제거하기 전에 권한을 확인하는 데 도움이 됩니다.

경로가 다른 경우와 버전 또는 에디션이 다른 경우 구분하기

중복된 두 항목을 모두 열고 파일 경로, 미디어 정보, 제공업체 ID, 재생 시간, 에디션 태그, 이용 가능 여부를 비교하세요. 두 항목은 서로 다른 경로에 있는 같은 파일이거나, 물리적 복사본 두 개이거나, 잘못 묶인 정식 버전일 수 있습니다.

경로가 사라진 뒤에도 오래된 레코드에 계속 접근할 수 있습니다. Jellyfin 보고서에서는 이를 유령 항목이라고 부르며, 실제 영화 파일이 하나 더 있는 경우와 혼동해서는 안 됩니다.

두 항목이 모두 유효한 경로를 가리키면 의도하지 않은 경로를 라이브러리 범위에서 제외하세요. 경로 하나가 더 이상 존재하지 않으면 지원되는 정리 절차를 사용하고 해당 레코드가 사라지는지 확인하세요. 파일이 의도적으로 보관한 에디션이라면 하나를 무작정 삭제하는 대신 미디어 서버에서 지원하는 명명 및 그룹화 규칙을 적용하세요.

중복 유형 가능성 높은 원인 올바른 조치
항목 두 개, 두 경로 모두 유효함 이전 루트와 새 루트를 모두 스캔함 기준 경로 하나만 유지
항목 두 개, 경로 하나는 유효하지 않음 오래된 데이터베이스 레코드 백업 후 라이브러리 정리
파일 두 개, 제목 하나 마이그레이션한 사본이 아직 남아 있음 확인 후 이전 사본 폐기
의도적으로 보관한 두 가지 에디션 이름 지정 또는 그룹화 불일치 지원되는 에디션 명명 규칙 사용

이렇게 분류하면 데이터베이스를 정리할 때 정당한 대체 버전이나 고화질 버전이 삭제되는 일을 막을 수 있습니다.

통제된 재검색을 한 번 실행하고 상태 확인

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

일부 라이브러리에서는 설정에서 이전 경로를 삭제한 뒤에도 저장소를 옮긴 후 파일이 제거되지 않았습니다. Jellyfin 보고서에는 삭제된 파일이 라이브러리에 남아 있는 문제가 기록되어 있으므로, 마지막 점검에서 데이터베이스 항목과 실제 경로를 대조해야 합니다.

각 영화가 한 번씩만 표시되고, 새 경로에서 열리며, 시청 상태와 컬렉션을 유지하고, 서비스를 다시 시작한 뒤에도 그대로인지 확인하세요. 이 점검을 통과할 때까지 이전 저장소는 오프라인 상태로 그대로 보존하세요. 그런 다음 백업 및 마이그레이션 계획에 따라 폐기하세요.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.