Immich 외부 라이브러리를 읽기 전용 소스로 구성하는 방법

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

Immich 외부 라이브러리는 관리형 업로드 트리 외부에 이미 저장된 사진을 색인합니다. 소스를 읽기 전용으로 마운트하면 애플리케이션이나 운영자의 실수로부터 원본을 보호할 수 있지만, Immich에는 여전히 썸네일, 인코딩된 동영상, 프로필 데이터, 데이터베이스 상태를 위한 쓰기 가능 저장소가 필요합니다.

따라서 설정에는 변경 불가능한 소스 폴더와 쓰기 가능한 생성 데이터라는 두 가지 신뢰 영역이 있습니다. 대규모 보관 폴더를 추가하기 전에 소규모 파일럿 라이브러리로 검색, 메타데이터, 썸네일, 재스캔, 제거 테스트를 통과해야 합니다. 동일한 파일럿으로 컨테이너 경로, 소유권, 복구 계획이 서로 일치하는지도 확인할 수 있습니다.

소스 저장소와 관리형 저장소를 별도로 매핑

기존 보관 폴더의 호스트 경로와 /external/family-photos와 같은 별도의 컨테이너 경로를 선택하세요. 외부 자산과 관리형 자산은 수명 주기 규칙이 다르므로 Immich 업로드 저장소 아래에 두지 마세요.

Immich 외부 라이브러리 워크플로에서는 서버가 사용자에게 할당할 경로를 볼 수 있어야 합니다. 관리자가 호스트 전용 경로를 애플리케이션에 붙여 넣지 않도록 마운트의 양쪽 경로를 기록하세요.

업로드, 썸네일, 인코딩된 동영상, 데이터베이스 데이터 등 Immich의 쓰기 가능 위치가 정상적으로 백업되고 여유 공간 모니터링을 받는지 확인하세요. 원본을 읽기 전용으로 설정해도 생성된 데이터나 라이브러리를 사용할 수 있게 해주는 자산 기록은 보호되지 않습니다.

읽기 전용 컨테이너 마운트 적용

Compose 또는 컨테이너 관리자에서 보관 폴더를 읽기 전용 플래그와 함께 바인드 마운트로 추가하세요. 일반적인 설정은 호스트의 /srv/photos/archive를 컨테이너의 /external/archive에 :ro를 붙여 매핑하는 것입니다.

컨테이너 프로세스가 모든 상위 디렉터리를 탐색하고 읽을 수 있는 권한을 부여하세요. 읽기 전용이라고 권한이 필요 없는 것은 아닙니다. 디렉터리에 실행 권한이 없으면 개별 파일을 읽을 수 있더라도 파일을 찾을 수 없습니다.

소스가 네트워크 공유인 경우 컨테이너가 시작되기 전에 호스트 마운트를 안정화하세요. Immich 네트워크 공유 안정성 가이드에서는 사용 가능한 경로와 신뢰할 수 있는 애플리케이션 종속 항목의 차이를 설명합니다.

Pilot 외부 라이브러리를 추가하고 스캔하기

소유할 Immich 사용자를 만들거나 선택하고 외부 라이브러리를 추가한 다음, 컨테이너에서 접근할 수 있는 가져오기 경로를 입력하세요. 전체 아카이브를 지정하는 대신 복사본이나 중요도가 낮은 원본이 들어 있는 디렉터리부터 시작하세요.

스캔을 실행하고 예상한 사진 및 동영상 개수가 표시되는지 확인하세요. 중첩 폴더의 에셋을 열어 날짜와 위치를 살펴보고, 썸네일과 인코딩된 미리보기가 원본 옆이 아닌 관리형 저장소에 기록되는지 확인하세요.

호스트에서 스캔 전후 테스트용 원본의 수정 시간을 비교하거나 해시를 확인하세요. 컨테이너 내부에서 마운트된 경로에 파일을 생성하는 것도 시도해 보세요. 읽기는 성공해야 하지만 파일 생성은 실패해야 합니다.

재스캔, 누락된 파일 및 복구 테스트

호스트 소스에 파일 하나를 추가하고 다시 스캔하여 나타나는지 확인하세요. 그런 다음 테스트용 파일을 소스에서 잠시 옮기고 다시 스캔한 뒤, 실제 데이터에 적용하기 전에 설치된 Immich 버전에서 해당 에셋 레코드가 어떻게 표시되거나 삭제되는지 확인하세요.

일반적인 복구 계획에 따라 데이터베이스와 쓰기 가능한 Immich 데이터를 백업하세요. 읽기 전용 애플리케이션 마운트는 디스크 오류, 호스트 측 삭제 또는 손상으로부터 보호해 주지 않으므로 외부 원본도 별도로 백업해야 합니다.

Immich가 아카이브를 인덱싱하고 표시할 수 있고, 아카이브에는 쓸 수 없으며, 외부 소스를 관리형 업로드로 취급하지 않고도 재구축할 수 있어야 합니다. 생성된 파일이 원본 옆에 나타나거나 마운트 누락을 빈 라이브러리로 잘못 판단하면 중단하세요.

자주 묻는 질문

읽기 전용 마운트를 사용하면 Immich가 원본을 삭제하지 못하나요? 해당 컨테이너 마운트를 통한 쓰기는 차단됩니다. 하지만 호스트 측 삭제, 다른 쓰기 가능한 공유, 파일 시스템 오류 또는 관리자가 마운트 모드를 변경하는 경우까지 막아 주지는 않습니다.

외부 라이브러리의 썸네일은 어디에 저장되나요? 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.