스택을 다시 만들면 Immich가 영구 데이터에 대한 액세스 권한을 잃는 이유는 무엇인가요?

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

스택 재생성 후 Immich가 비어 보이거나 라이브러리를 읽지 못한다면, 데이터가 삭제되었다고 단정하기보다 기존 영구 데이터가 연결되지 않았거나 읽을 수 없는 상태라고 먼저 판단하세요.

컨테이너를 재생성하면 Compose 프로젝트 ID, 바인드 마운트 소스, 이름 있는 볼륨 연결, 네트워크 공유가 준비되는 시점 또는 데이터에 접근하는 UID/GID가 바뀔 수 있습니다. 새로 설치한 것처럼 보이는 인스턴스가 새로운 상태를 많이 기록하기 전에 중지하고, 호스트에서 기존 데이터베이스 및 미디어 경로를 찾은 다음, 재생성된 스택을 마지막으로 정상 작동했던 매핑과 비교하세요. 먼저 기존 상태를 다시 연결하는 것이 목표입니다. 기존 상태가 실제로 누락되었거나 손상되었음을 확인한 뒤에만 백업에서 복원하세요.

새 인스턴스를 중지하고 기존 데이터가 여전히 있는지 확인

재생성 직후 설정 마법사가 표시되거나 타임라인이 비어 있거나 외부 라이브러리가 보이지 않는다면, 이는 지속성 문제의 경고 신호입니다. 새 파일을 업로드하거나 비어 있는 새 설정을 적용하기 전에 Immich를 중지하고 호스트 측 데이터베이스 및 미디어 경로를 확인하세요. 새로운 쓰기 작업이 발생하면 나중에 경로를 비교하기가 더 어려워질 수 있습니다.

이전 디렉터리에서 예상 파일 개수, 수정 날짜, 데이터베이스 파일 또는 덤프, 대표 원본 이미지를 확인하세요. 데이터가 호스트에 있다면 문제는 데이터 소실이 아니라 접근 권한이나 매핑에 있습니다. 소유권을 변경하거나 디렉터리를 옮기기 전에 해당 상태의 읽기 전용 스냅샷이나 백업을 만드세요.

예상 경로에서 기존 데이터를 찾을 수 없다면, 무엇이든 삭제하기 전에 스토리지 풀과 Docker 볼륨 목록을 검색하세요. 판단은 둘 중 하나입니다. 기존 상태를 찾아 보호하거나, 실제로 사용할 수 없는 상태임을 확인하고 마운트를 복구하는 대신 정상 백업을 이용해 복구를 진행해야 합니다.

재생성된 마운트와 이전 스택 비교

재생성된 Immich 서버 및 데이터베이스 컨테이너의 실제 마운트를 확인하세요. 수정했던 Compose 텍스트만 확인하지 마세요. 상대 경로 바인드 마운트는 다른 프로젝트 디렉터리를 기준으로 해석될 수 있고, Compose 프로젝트 이름이 바뀌면 새 이름 있는 볼륨이 연결되는 한편 기존 볼륨은 그대로 남아 사용되지 않을 수 있습니다.

마운트가 실패하거나 변경되거나 누락되면 예상 데이터가 호스트의 다른 위치에 여전히 존재하더라도 컨테이너 내부에는 빈 디렉터리가 표시될 수 있습니다. Docker 볼륨 마운트 확인을 사용해 영구 데이터가 저장되는 각 Immich 경로의 Source, Destination, 마운트 유형 및 이름 있는 볼륨의 ID를 비교하세요. 여기서 불일치가 발견되면 인스턴스가 새로 생성된 것처럼 보이는 이유를 직접 설명할 수 있습니다.

잘못된 마운트 매핑만 수정한 다음 볼륨을 제거하지 않고 컨테이너를 생성하거나 시작하세요. 변경 후 예상 파일이 동일한 컨테이너 경로에 나타나면 데이터를 그대로 두세요. 마운트 목록이 올바른데도 액세스에 실패한다면 매핑을 유지하고 새 볼륨을 만드는 대신 호스트 저장소의 사용 가능 여부와 권한을 확인하세요.

Immich 시작 전에 외부 저장소가 마운트되었는지 확인

Immich 데이터가 HDD 풀, NAS 공유, 병합 계층 또는 기타 외부 마운트에 있다면 Docker가 스택을 시작하기 전에 해당 저장소가 호스트에 실제로 마운트되어 있는지 확인하세요. 실제 장치가 연결되지 않아도 /mnt/photos 같은 경로는 일반 로컬 디렉터리로 존재할 수 있습니다.

의도한 볼륨 또는 바인드 마운트를 올바르게 다시 연결한 경우에만 컨테이너를 교체해도 Docker 데이터가 유지됩니다. 기본 Docker 볼륨 지속성 모델은 호스트 디스크나 네트워크 공유가 누락된 경우 이를 자동으로 표시해 주지 않으므로, Immich 내부의 동일한 경로를 테스트하기 전에 호스트에서 저장 장치와 파일이 있는지 확인하세요.

실제 저장소가 연결되지 않은 상태에서 마운트 지점에 폴백 파일이 기록된 것을 발견하면, 해당 파일 위에 장치를 마운트하기 전에 Immich를 중지하세요. 해당 파일은 별도로 정리하고, 저장소 마운트에 대한 시작 종속성이나 상태 확인을 추가한 다음 스택을 다시 시작하세요. 호스트 저장소가 안정적인데 컨테이너 경로에 여전히 접근할 수 없다면 권한 문제 해결 단계로 넘어가세요.

모든 것을 다시 작성하지 않고 UID, GID 및 디렉터리 권한 확인

재생성된 스택은 이전 스택과 다른 숫자형 ID, 사용자 네임스페이스 또는 보안 컨텍스트로 서비스를 실행할 수 있습니다. 이 경우 마운트가 누락된 상황과는 다르게 보입니다. 호스트에서는 경로와 파일이 보이지만 Immich 로그에는 권한 오류가 표시되거나 필요한 파일을 만들지 못합니다.

영향을 받는 호스트 디렉터리의 숫자형 소유권과 권한 비트를 재생성된 컨테이너 내부의 사용자 ID와 비교하세요. 먼저 안전한 읽기를 테스트한 다음, 동일한 마운트 아래의 폐기 가능한 위치에 되돌릴 수 있는 쓰기 작업을 해보세요. 어떤 서비스에 쓰기 권한이 필요한지, 어떤 기존 파일을 그대로 보존해야 하는지 확인하기 전에는 사진 아카이브 전체에 재귀적으로 소유권을 변경하지 마세요.

문제를 설명하는 가장 작은 디렉터리 또는 사용자 ID 불일치를 수정하고, 한 번 재시작한 다음 로그를 다시 확인하세요. 마운트와 권한이 일치하는데도 접근에 실패하면 파일 시스템 변경을 중단하고 재생성 과정에서 달라진 데이터베이스 연결, 환경 변수 치환 또는 보안 계층을 점검하세요.

기존 상태를 다시 연결하고 스택 재생성을 다시 검증하기

기존 데이터베이스와 미디어 경로를 연결하고 읽을 수 있게 되면 Immich를 시작해 기존 사용자, 앨범, 인물 및 대표 파일이 있는지 확인하세요. 홈페이지가 로드된다는 이유만으로 복구가 완료됐다고 판단하지 마세요. 애플리케이션이 새로 초기화된 데이터베이스가 아니라 원래 상태를 읽고 있는지 확인하세요.

중요한 구분은 컨테이너는 일회용일 수 있지만 애플리케이션 상태는 컨테이너 수명 주기와 분리된 안정적인 저장소에 있어야 한다는 점입니다. 수정된 마운트 이름과 호스트 경로를 문서화하고, 지속형 파일 서버 스토리지 역할을 사용해 다음 스택 재생성 시에도 동일한 데이터에 연결되도록 하세요.

마지막으로 통제된 조건에서 스택을 한 번 더 재생성하고 원래 검사를 반복하세요. 재생성 후와 호스트 재부팅 후에도 동일한 데이터베이스와 미디어가 다시 나타나야 수정이 입증된 것입니다. 기존 상태가 다시 사라지거나 데이터베이스에서 접근 오류가 아닌 손상이 보고되면 보호된 복사본으로 롤백하고, 마운트 실험을 계속하는 대신 데이터베이스/백업 복구를 진행하세요.

지원 및 팁

더 읽어보기

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.