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

에바 왕

IceWhale author

에바 왕 는 기술 작가 그리고 이자 ZimaSpace의 상주 장인입니다. 평생을 기술에 열정을 가진 사람으로서 홈랩과 오픈소스 소프트웨어에 열정을 가지고 있으며,복잡한 기술 개념을 쉽게 이해할 수 있는 실습 가이드로 번역하는 데 전문성을 가지고 있습니다.에바는 셀프 호스팅이 어렵지 않고 재미있어야 한다고 믿습니다. 그녀의 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 신비를 풀도록돕고 있습니다. 첫 NAS 구축부터 Docker 컨테이너 마스터링까지.

How to Configure Immich External Libraries as Read-Only Sources - Zima Store Online

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

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

소스와 관리 스토리지를 별도로 매핑하기

기존 아카이브의 호스트 경로를 선택하고 /external/family-photos와 같이 구분되는 컨테이너 경로를 지정합니다. 외부 자산과 관리되는 자산은 수명 주기 규칙이 다르므로 Immich 업로드 스토리지 아래에 배치하지 마세요.

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

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

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

Compose 또는 컨테이너 관리자에서 읽기 전용 플래그를 사용해 아카이브를 바인드 마운트로 추가합니다. 일반적인 방식은 호스트의 /srv/photos/archive를 컨테이너의 /external/archive에 :ro와 함께 매핑하는 것입니다.

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

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

파일럿 외부 라이브러리 추가 및 스캔

Immich 사용자를 생성하거나 선택하고, 외부 라이브러리를 추가한 다음 컨테이너에서 볼 수 있는 가져오기 경로를 입력합니다. 전체 아카이브를 지정하지 말고 복사본이나 중요하지 않은 원본이 들어 있는 디렉터리부터 시작하세요.

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

호스트에서 스캔 전후 파일럿 소스의 수정 시간이나 해시를 비교합니다. 또한 컨테이너 내부에서 마운트된 경로에 파일을 생성해 보세요. 읽기는 정상적으로 수행되면서 파일 생성 작업은 실패해야 합니다.

-15% OFF

ZimaBoard 2 - 당신의 큰 아이디어를 위한 미니 홈 서버

Single board computer zimaboard2

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

호스트 소스에 파일 하나를 추가하고 재스캔을 실행한 뒤 해당 파일이 표시되는지 확인합니다. 그런 다음 파일럿 파일 하나를 소스 밖으로 임시 이동하고 재스캔하여 설치된 Immich 버전이 자산 레코드를 어떻게 표시하거나 제거하는지 확인한 후, 실제 데이터에서 같은 작업을 반복하세요.

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

통과 조건은 Immich가 아카이브를 인덱싱하고 렌더링할 수 있으며, 해당 아카이브에 쓸 수 없고, 외부 소스를 관리되는 업로드로 취급하지 않은 상태에서 다시 구축할 수 있는 것입니다. 원본 옆에 생성된 파일이 나타나거나 누락된 마운트가 빈 라이브러리로 잘못 인식되면 중지하세요.