먼저 기준이 되는 원본 내보내기본 하나를 가져온 다음, 동일한 복사본과 편집된 변형을 분류한 후에만 휴대폰 백업을 활성화하여 사진 중복을 방지하세요.
클라우드 라이브러리 마이그레이션에는 원본, 편집본, 크기를 줄여 다운로드한 파일, 공유 앨범 버전, Live Photo 구성 요소, 메타데이터 사이드카, 반복된 내보내기 폴더가 함께 포함되는 경우가 많습니다. 자체 호스팅 갤러리는 바이트 단위로 완전히 동일한 중복 파일은 거부할 수 있지만, 압축 방식, 크기, 메타데이터 또는 파일명이 다른 시각적으로 동일한 파일은 계속 허용할 수 있습니다. 안전한 절차는 실제 라이브러리 외부에서 마이그레이션을 준비하고, 해시와 원본 폴더를 기록하며, 관리되는 배치 하나를 가져온 뒤, 자동 휴대폰 백업을 시작하기 전에 갤러리가 변형 파일을 어떻게 표시하는지 확인하는 것입니다.
같은 사진을 포함할 수 있는 모든 출처를 확인하세요
클라우드 내보내기 아카이브, 휴대폰 카메라 롤, 데스크톱 사진 라이브러리, 공유 앨범, 다운로드 폴더, 파트너 라이브러리, 이전 NAS 폴더, 갤러리에 마운트된 외부 라이브러리를 나열하세요. 각 출처의 날짜 범위와 파일 수를 기록하세요.
중복은 클라우드 복사본을 가져온 후 휴대폰이 로컬 원본을 업로드할 때 자주 발생합니다. Immich 토론에서는 클라우드 버전이 압축된 상태인 반면 휴대폰에서는 다른 전체 해상도 파일이 제공되어 Google 포토와 모바일 백업에서 중복처럼 보이는 문제가 설명되었습니다.
원본에 대해 어떤 출처를 기준으로 삼을지 결정하세요. 첫 번째 가져오기를 진행하는 동안 다른 출처는 오프라인으로 유지하여, 중복으로 가득 찬 타임라인이 삭제할 항목을 판단하는 환경이 되지 않도록 하세요.
완전히 동일한 중복 파일과 시각적 변형을 구분하세요
가져오기 전에 파일의 암호화 해시를 생성하세요. 해시가 일치하면 바이트 단위로 동일하다는 뜻이며, 해시가 다르면 편집, 재압축, 메타데이터 변경, 크기를 조정한 내보내기, 모션 사진 구성 요소 또는 실제로 다른 촬영본일 수 있습니다.
Immich 마이그레이션 사용자들은 외부 라이브러리 전송이 API 업로드와 동일한 중복 검사를 수행하지 않을 수 있기 때문에 가져오기 전 해시 확인 절차를 마련했습니다. 보고된 방법은 파일을 복사하기 전에 해시를 비교하는 것이었습니다.
썸네일이 비슷해 보인다는 이유만으로 파일을 자동 삭제하지 마세요. 더 높은 해상도의 원본, 원하는 편집본, 모션 구성 요소, 메타데이터 사이드카는 갤러리 외부에서 비교할 때까지 보존하세요.
원본을 다시 작성하지 않고 내보내기 폴더 구조를 정리하세요
모든 클라우드 아카이브를 준비 디렉터리에 압축 해제하고, 반복된 아카이브 조각, “original” 및 “edited” 접미사, JSON 사이드카, 앨범 중복 파일, 여러 내보내기 패키지로 나뉜 파일을 확인하세요.
첫 번째 목록 작성 단계에서는 파일명과 타임스탬프를 변경하지 마세요. 해시를 생성하기 전에 이름을 바꾸거나, 다시 인코딩하거나, 메타데이터를 다시 작성하면 완전히 동일한 중복 파일이 서로 다른 바이트의 파일로 바뀌어 갤러리가 자동으로 식별하지 못할 수 있습니다.
원본 아카이브, 원본 상대 경로, 파일명, 해시, 크기, 해상도, 촬영 시간, 사이드카 경로가 포함된 매니페스트를 만드세요. 이렇게 하면 이후의 모든 삭제를 되돌릴 수 있고, 비슷한 두 자산이 라이브러리에 들어온 이유도 설명할 수 있습니다.
먼저 소규모 대표 배치를 가져오세요
일반 JPEG, HEIC 사진, 편집 이미지, Live Photo, 동영상, 연사 사진, 공유 앨범 복사본, 완전히 동일한 중복 파일 두 개가 포함된 배치를 선택하세요. 전체 라이브러리에 사용할 예정인 것과 동일한 방식으로 가져오세요.
클라우드 자산과 로컬 자산은 하나가 서버 복사본이고 다른 하나가 휴대폰에만 남아 있는 경우에도 모바일 타임라인에 두 번 표시될 수 있습니다. Immich 보고서에는 사진이 클라우드 및 클라우드 오프 상태로 모두 표시된 사례가 기록되어 있습니다.
갤러리가 동일한 해시를 거부하는지, 모션 구성 요소를 그룹화하는지, 편집본을 보존하는지, 사이드카를 읽는지, 로컬 전용 자산과 업로드된 자산을 구분하는지 확인하세요. 전체 내보내기로 확장하기 전에 가져오기 경로를 조정하세요.
기존 가져오기가 안정될 때까지 모바일 백업을 활성화하지 마세요
마이그레이션한 클라우드 라이브러리의 일부가 들어 있는 모든 휴대폰에서 자동 백업을 일시 중지하세요. 그렇지 않으면 서버가 내보낸 파일에서 동일한 기록을 수집하는 동안 모바일 클라이언트가 수천 개의 자산을 업로드할 수 있습니다.
사용자가 외부 라이브러리의 복사본은 유지하면서 업로드본을 삭제하면 여러 출처 간 중복이 다시 발생할 수 있습니다. 이후 모바일 클라이언트가 같은 자산을 다시 업로드할 수 있기 때문입니다. Immich 토론에서는 모바일과 외부 라이브러리 간에 반복되는 중복 루프가 설명되었습니다.
기존 기록의 가져오기가 완료되면 휴대폰의 대기 항목 수와 서버 매니페스트를 비교하세요. 먼저 최근 앨범 하나만 백업하도록 활성화하고, 이미 알려진 기존 자산이 건너뛰어지거나 이미 백업된 항목으로 표시되는지 확인하세요.
외부 라이브러리와 업로드 라이브러리를 신중하게 처리하세요
마이그레이션한 파일을 갤러리가 관리하는 업로드 파일로 저장할지, 외부 읽기 전용 라이브러리로 저장할지 결정하세요. 같은 실제 파일을 두 경로를 통해 동시에 표시하지 마세요.
관리 라이브러리에서 외부 라이브러리로 자산을 이동하면 이전 데이터베이스 기록이 남아 있고 새로운 외부 스캔이 또 다른 자산을 추가하여 타임라인에 중복 항목이 생길 수 있습니다. 보고된 결과는 고아 기록과 새로운 중복 항목이었습니다.
파일 세트마다 하나의 소유권 모델만 사용하세요. 모델을 전환할 경우 데이터베이스를 백업하고, 기존 경로에 대해 지원되는 제거 또는 정리 절차를 완료한 뒤, 새 위치를 스캔하기 전에 오래된 기록이 사라졌는지 확인하세요.
메타데이터와 복구 상황을 고려하여 중복을 검토하세요
갤러리가 중복을 식별하면 삭제할 자산을 선택하기 전에 해상도, 파일 크기, 코덱, 촬영 시간, 편집 기록, Live Photo 연결 상태, 앨범 소속, 즐겨찾기, 얼굴 지정 정보, 백업 출처를 비교하세요.
유사 중복 감지는 같은 장면의 서로 다른 해상도나 인코딩을 식별할 수 있지만, 어떤 버전이 사용자가 선호하는 편집본이나 최고 품질의 원본을 보존하는지는 알 수 없습니다. 자동 감지는 삭제 지시가 아니라 검토 대기열로 취급하세요.
ZimaSpace NAS 데이터 마이그레이션 가이드는 다음과 같은 원칙을 제시합니다. 파일 수, 메타데이터, 앨범, 대표적인 복원이 검증될 때까지 클라우드 내보내기 파일과 원본 라이브러리를 유지하세요.
재현 가능한 감사로 마이그레이션을 완료하세요
원본 매니페스트, 가져온 파일 수, 거부된 완전 중복 파일, 보존된 변형 파일, 실패한 파일, 휴대폰 대기 항목 수를 비교하세요. 여러 연도, 앨범, 편집본, 동영상, Live Photo를 표본으로 확인하세요.
구독을 취소하거나 클라우드 자산을 제거하기 전에 원본 클라우드 내보내기를 변경하지 않고 보존하고, 자체 호스팅 라이브러리의 두 번째 백업을 생성하세요. 중복 정리는 백업이 아니며, 사본을 변경하는 유일한 작업이 되어서는 안 됩니다.
각 원본에 의도적으로 선택한 기준 사본 하나가 있고, 편집된 변형을 구분할 수 있으며, 휴대폰은 새 자산만 업로드하고, 외부 라이브러리와 관리 라이브러리가 겹치지 않으며, 제외하거나 보존한 모든 중복 파일을 매니페스트로 설명할 수 있을 때 마이그레이션이 완료됩니다.
지원 및 팁
더 읽어보기

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

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

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

