Immich를 네트워크 공유 폴더에 데이터를 저장해 안정적으로 실행할 수 있나요?

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

마운트, 권한, 지연 시간, 장애 시 동작을 적절히 설계하고 테스트하면 Immich에서 미디어나 외부 라이브러리에 네트워크 공유를 안정적으로 사용할 수 있습니다. 하지만 PostgreSQL 데이터 디렉터리는 일반적인 SMB 또는 NFS 공유가 아니라 지원되는 저지연 스토리지에 두어야 합니다.

데이터라는 말은 서로 다른 워크로드를 가립니다. 원본은 용량이 큰 영구 파일이고, 썸네일은 소규모 작업을 많이 발생시키며, 외부 라이브러리는 읽기 전용일 수 있고, PostgreSQL에는 데이터베이스에 적합한 파일 시스템 특성이 필요합니다. 경로마다 이전 여부를 결정하고, 컨테이너가 시작되기 전에 공유를 마운트하며, 비어 있는 로컬 디렉터리가 NAS인 것처럼 동작하지 않도록 합니다. 호스트 재시작과 통제된 공유 중단을 모두 거쳐 동작을 검증합니다.

이전하기 전에 Immich 경로를 하나씩 분류하세요

업로드 라이브러리, 썸네일 또는 인코딩된 미디어, 외부 라이브러리, 데이터베이스 디렉터리, 모델 캐시, 백업을 각각 나열합니다. 각 경로에 누가 쓰는지와 경로 손실의 영향을 표시합니다. 미디어 공유는 사용할 수 있지만, 모든 볼륨을 서로 바꿔 쓸 수 있다고 취급하면 설계 검증을 통과할 수 없습니다.

실용적인 NFS 안내에서는 공유 스토리지에 있는 Immich 외부 라이브러리를 연결하는 방법을 보여줍니다. 해당 외부 라이브러리 마운트 패턴은 경로와 권한을 계획하는 데 유용하지만, 데이터베이스에 NFS를 사용해야 한다는 근거는 아닙니다.

데이터베이스에 권장되는 스토리지에 PostgreSQL을 두고, 기본 덤프와 백업으로 보호합니다. 로컬 활성 스토리지가 부족하다면 용량을 많이 차지하는 미디어 경로만 측정한 뒤 옮기고, 애플리케이션 상태 전체를 이전하는 대신 경계를 문서화합니다.

원격 마운트 순서를 확실하게 설정

명시적인 자격 증명 또는 내보내기 규칙, 고정 주소, 의도한 읽기-쓰기 모드를 사용해 호스트에 공유를 마운트합니다. Immich를 시작하기 전에 예상한 파일 시스템인지 확인하고, 확인된 마커 파일이 있는지 검증합니다. 이미 마운트된 호스트 경로를 컨테이너에 바인드 마운트합니다.

서비스 관리자를 구성해 Immich가 원격 마운트를 기다리고 비어 있는 대체 디렉터리에서 시작하지 않도록 합니다. 부팅 테스트는 컨테이너 내부에서 마커가 보이고 테스트 파일의 소유자가 예상한 대로일 때만 통과합니다. 디렉터리가 비어 있거나 파일 소유자가 root라면 즉시 중단해야 합니다.

공유를 사용할 수 있는 상태와 유지보수 시간 동안 의도적으로 사용할 수 없는 상태에서 각각 한 번씩 재부팅합니다. 첫 번째 테스트는 Immich가 시작되기 전에 마커가 나타날 때만 통과합니다. 두 번째 테스트는 Immich가 중지되거나 명확한 오류와 함께 실패하고, 비어 있는 로컬 마운트 지점에 파일을 쓰지 않을 때만 통과합니다.

컨테이너 ID 및 공유 권한 확인

서버, 클라이언트, 컨테이너에서 사용자 및 그룹의 숫자형 ID를 일치시킨 다음, 별도의 임시 폴더에서 파일 생성, 이름 변경, 읽기, 삭제를 테스트하세요. 가족 라이브러리를 노출하는 전역 쓰기 권한으로 불일치를 해결하려 하지 마세요.

호스트에서만 테스트하지 말고 Immich 서버 컨테이너 내부에서도 임시 파일 테스트를 반복하세요. NAS에 의도한 숫자형 소유자 ID가 표시되는지, 컨테이너를 다시 만들고 나서도 Immich가 파일을 다시 열 수 있는지 확인하세요. 호스트에서만 테스트를 통과했다고 해서 컨테이너 경로도 정상이라고 입증되는 것은 아닙니다.

사용자 ID나 생성 후 이름 변경 동작이 다르면 중단하고 해당 내보내기 설정, 마운트 또는 컨테이너 매핑을 정확히 수정하세요. 실제 라이브러리를 스캔하기 전에 다시 테스트하세요. 광범위한 권한 변경은 불일치를 가리는 동시에 가족 사진을 무관한 서비스에 노출할 수 있습니다.

지연 시간 측정 및 공유 스토리지 연결 끊김 테스트

대표적인 업로드, 썸네일 생성, 타임라인 탐색, 원본 다운로드, 외부 라이브러리 스캔을 실행하면서 서버 응답 시간과 작업 진행 상황을 측정하세요. 상호작용이 원활하고 대기열이 지속해서 늘어나지 않아야 테스트를 통과한 것입니다. 링크 속도만으로 메타데이터 처리 성능을 입증할 수는 없습니다.

한 배포 환경에서 NFS가 불안정해 데이터베이스와 파일의 일관성이 깨졌다는 Immich 이슈가 보고되었습니다. 범위가 한정된 NFS 장애 사례를 고려해, 쓰기 중 연결 끊김을 복구 위험으로 취급하세요. NFS가 언제나 Immich 데이터를 손상시킨다고 단정하지는 마세요.

백업을 완료한 유지보수 시간에 중요하지 않은 테스트가 실행되는 동안 미디어 공유 스토리지 연결을 끊어 보세요. Immich는 기본 마운트 지점에 파일을 쓰지 말고 오류를 분명히 표시해야 합니다. 공유 스토리지를 복구한 뒤 재시작 루프 없이 테스트 에셋과 데이터베이스 레코드가 서로 일치하는지 확인하세요.

재시작 테스트 후 진행 여부 결정

컨테이너와 호스트를 각각 재시작하세요. 먼저 올바른 공유 스토리지가 마운트되는지, 기존 파일과 새 원본 파일이 열리는지, 외부 라이브러리 스캔으로 에셋이 중복되지 않는지, 새 업로드 하나가 다음 재시작 후에도 남아 있는지 확인하세요. ZimaSpace의 DAS와 NAS 비교에서는 지연 시간과 장애 도메인 간의 절충점을 설명합니다.

이 테스트를 통과하고 연결 끊김, 지연 시간, 공간 부족, inode 압박을 알리는 모니터링을 설정할 수 있다면 공유 스토리지를 사용하세요. 네트워크나 NAS가 필요한 가용성을 충족하지 못하거나 마운트 실패 시에도 계속 진행되는 동작을 방지할 수 없다면 로컬 스토리지나 직접 연결 스토리지를 선택하세요.

Immich가 빈 상태로 시작하거나, root 소유 파일을 만들거나, 중단 후 파일 누락 오류가 발생하면 이전 로컬 경로로 되돌리세요. 프로토콜, 마운트 옵션, 사용자 및 그룹 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.