저장소 경로 변경 후 Immich에 오래된 데이터가 표시됨

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

저장 경로 변경 후 Immich 데이터가 오래된 상태로 남는 원인은 서로 다른 세 가지이며, 혼동해서는 안 됩니다. 관리형 미디어 루트 이동, 외부 라이브러리 가져오기 경로 변경, 또는 캐시된 상태를 계속 표시하는 클라이언트입니다. 최신 Immich 버전에서는 구성된 미디어 위치와 볼륨 마운트가 일관되게 유지되면 이동된 관리형 미디어 위치를 조정할 수 있지만, 외부 라이브러리 이동은 여전히 새 에셋 ID로 처리될 수 있습니다.

다시 스캔하기 전에 이전 경로와 데이터베이스를 보존하세요. 먼저 실행 중인 컨테이너에서 어떤 경로가 보이는지 확인한 다음 Immich의 서버 측 기록이 잘못되었는지, 아니면 클라이언트 하나만 오래된 상태인지 파악하세요. 이 차이에 따라 마운트를 수정할지, 컨테이너에서 보이는 경로를 원래대로 유지할지, 일부 테스트 항목만 다시 스캔할지, 아니면 클라이언트 캐시만 지울지가 결정됩니다.

관리형 미디어 루트 이동과 외부 라이브러리 이동 구분하기

Immich에서 관리하는 업로드 파일의 호스트 위치를 변경했다면 실제 미디어 위치 설정과 호스트-컨테이너 마운트가 함께 변경되었는지 확인하세요. 최신 관리형 미디어 이동은 외부 라이브러리 가져오기 경로의 이름을 바꾸는 경우와 같은 방식으로 진단해서는 안 됩니다.

여기서는 ZimaSpace의 Immich 영구 상태 맵이 유용합니다. 데이터베이스와 파일 시스템 경로가 하나의 복구 경계를 이루기 때문입니다. 컨테이너가 다른 위치에 마운트되어 있다면 호스트에 올바른 파일이 있는 것만으로는 충분하지 않습니다.

관리형 미디어 루트가 일치하지 않는다면 라이브러리 작업을 실행하기 전에 환경 설정과 볼륨 매핑을 먼저 수정하고 서비스를 다시 시작하세요. 변경된 경로가 외부 라이브러리에 해당한다면 데이터베이스를 그대로 유지하고 해당 경우를 별도로 테스트하세요.

가능하면 외부 라이브러리의 컨테이너 경로를 그대로 유지하세요

외부 라이브러리의 경우, 컨테이너에서 보이는 가져오기 경로를 그대로 유지할 수 있도록 호스트 측 저장소를 옮기는 것이 가장 안전합니다. Immich에 표시되는 경로가 바뀐다면 스캔 전에 일부 에셋 ID, 앨범, 사람, 이전 경로를 기록해 두어 기존 에셋이 다시 연결되었는지 아니면 새로 만들어졌는지 확인할 수 있도록 하세요.

Immich의 외부 라이브러리 경로 변경 보고서에는 파일을 옮긴 뒤 새 에셋으로 처리되어 재처리되고 Immich에만 저장된 관계가 손실된 사례가 설명되어 있습니다. 특정 버전에 한정된 사례이지만, 외부 라이브러리 경로가 변경되었다고 해서 자동으로 투명하게 이름이 변경되는 것은 아니라는 보수적인 원칙을 뒷받침합니다.

테스트한 하위 집합이 새 자산으로 나타나고 이전 레코드는 누락되거나 휴지통으로 이동한 것으로 표시되면 전체 재스캔을 중단하세요. 가능하다면 이전 컨테이너 표시 경로를 복원하거나 해당 버전에 맞는 마이그레이션 방법을 사용하세요. 검증된 백업 없이 운영 데이터베이스 경로를 직접 수정하지 마세요.

이 문제를 Immich 관리형 파일의 스토리지 템플릿 마이그레이션과 혼동하지 마세요. 타임라인에서 증상이 비슷해 보일 수 있지만 파일의 소유 방식과 지원되는 마이그레이션 경로는 다릅니다.

저장된 서버 경로와 클라이언트 캐시 구분하기

웹 클라이언트와 인증된 다른 클라이언트에서 동일한 확인용 자산을 살펴본 다음, 이를 서버 로그 또는 서버에서 확인 가능한 경로와 비교하세요. 서버 측 작업에서 여전히 이전 경로를 가리킨다면 브라우저 캐시를 지워도 근본적인 레코드는 수정되지 않습니다.

이후 발생한 Immich 이전 경로 메타데이터 문제에서는 이름을 변경한 후에도 처리가 이전 외부 라이브러리 경로를 계속 참조했습니다. 이는 모바일 또는 웹 UI를 탓하기 전에 작업 측 경로를 확인해야 한다는 강력한 근거입니다.

서버 경로가 올바른데 웹 보기 하나만 오래된 상태라면 해당 클라이언트의 캐시를 새로 고치거나 지운 다음 원본 파일을 다시 확인하세요. 캐시된 썸네일과 오래된 클라이언트 상태 때문에 서버가 정상인데도 문제가 있는 것처럼 보일 수 있습니다. 반대로 캐시된 미리보기 때문에 서버 경로가 잘못되었는데도 정상처럼 보일 수 있습니다.

최소 경로 경계를 수정하고 제어된 재스캔으로 검증하기

되돌릴 수 있는 수정 하나만 적용하세요. 관리형 미디어 설정과 마운트를 동기화하거나, 이전 외부 라이브러리 컨테이너 경로를 복원하거나, 가져오기 경로를 수정하거나, 클라이언트 캐시 하나를 지우세요. 대규모 라이브러리 재검색을 유발할 수 있는 작업을 하기 전에 데이터베이스를 백업하세요.

실용적인 최소 범위로 재스캔을 실행하고 기존 레코드의 연결이 유지되는지, 이전 경로 오류가 사라지는지, 이전 경로와 새 경로의 중복 자산이 나타나지 않는지 확인하세요. 그런 다음 표본 원본 파일을 열고 앨범 및 인물 연결 관계를 확인하고, 검색을 실행한 뒤 스택을 재시작하세요.

이전 경로와 새 경로의 레코드가 동시에 활성 상태로 남아 있거나, 대규모 외부 라이브러리가 예상치 않게 다시 처리되거나, 원본 파일을 계속 읽을 수 있는데 연결 관계가 사라지면 문제를 에스컬레이션하세요. 변경 전후의 마운트 맵, Immich 버전, 영향을 받은 자산 ID, 파일 시스템의 대소문자 구분 방식, 데이터베이스 백업 시각을 정확히 기록하세요.

지원 및 팁

더 읽어보기

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.