Immich 캐시 및 임시 저장소 구성 방법

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

먼저 영구 보관할 라이브러리 상태를 생성된 파생 데이터, 재사용 가능한 모델 캐시, 실제로 폐기해도 되는 컨테이너 임시 데이터와 구분한 뒤 Immich의 캐시 및 임시 저장소를 구성하세요.

Immich에서 썸네일과 인코딩된 동영상을 다시 만들 수 있으므로 캐시처럼 느껴질 수 있지만, 이들은 크기가 커지고 재생성 비용이 높아질 수 있는 영구 작업 데이터입니다. 모델 다운로드에는 다른 수명 주기가 적용되며, 로그와 쓰기 가능한 레이어의 임시 데이터가 부팅 디스크를 몰래 차지해서는 안 됩니다. 역할에 따라 저장소를 배정한 다음 정리 및 재시작 동작을 테스트하세요.

이동하기 전에 각 저장 역할을 분류하기

최소한 다음 네 가지 유형으로 목록을 작성하세요. 원본 및 필수 애플리케이션 상태, 생성된 썸네일 및 미리보기, 생성된 인코딩 동영상, 모델·로그·임시 런타임 데이터입니다. 각 유형에 대해 현재 경로, 크기, 증가 속도, 백업 정책, 재생성 비용, 그리고 데이터를 기록하는 서비스를 적으세요.

생성된 썸네일 및 동영상의 저장 공간 증가에 관한 사용자 보고는 썸네일과 인코딩된 동영상의 크기를 따로 측정해야 하는 이유를 보여줍니다. 미디어 구성과 처리 설정에 따라 생성되는 데이터 양이 달라지므로, 개별 비율이 보편적으로 적용되지는 않습니다.

공간이 확보된다는 이유만으로 디렉터리에 “캐시”라는 이름을 붙이지 마세요. 해당 데이터가 사라지면 며칠씩 재생성해야 하거나, 재생 중인 콘텐츠가 끊기거나, 복구 계획상 유지해야 할 상태가 없어지는 경우라면 애플리케이션에서 기술적으로 다시 만들 수 있더라도 명시적인 영구 저장 역할을 부여해야 합니다.

자주 변경되는 생성 데이터는 지연 시간과 내구성에 맞는 저장소에 배치하기

썸네일과 미리보기는 대화형 탐색에 사용되며 작은 크기의 읽기 작업이 많은 반면, 인코딩된 동영상은 훨씬 더 큰 순차적 저장 용량을 차지할 수 있습니다. 빠른 SSD는 파생 데이터 사용량이 많을 때 작업 성능을 높일 수 있지만, 데이터 이동으로 측정된 대기 시간이 줄어들어야 하며 예상치 못하게 가득 차는 또 다른 작은 볼륨을 만들어서는 안 됩니다.

ZimaSpace의 썸네일 저장 공간 증가 설명은 다른 환경에도 적용할 수 있는 저장 공간 관련 교훈을 제공합니다. 원본이 다른 곳에 있어도 앱의 활성 저장 공간은 가득 찰 수 있습니다. Immich의 구체적인 경로는 다르지만, 실제 쓰기 역할을 모니터링해야 한다는 점은 같습니다.

대용량 미디어는 HDD나 NAS 저장소에 두고 파생 데이터는 SSD로 옮기는 경우, 두 저장 공간의 여유 용량 하한을 모두 모니터링하고 재시작 후 각 마운트를 확인하세요. 빠른 파생 데이터 계층은 일반적인 증가량을 감당할 만큼 충분히 크고, 장애가 발생해도 권위 있는 원본을 잃은 것으로 오인되지 않을 때만 유용합니다.

모델 캐시는 의도적으로 유지하되 다시 만들 수 있는 데이터로 취급하기

머신러닝 모델은 반복 추론에 사용하기 위해 다운로드하거나 준비하며, 상당한 저장 공간을 차지할 수 있습니다. 모델 캐시를 유지하면 불필요한 다운로드와 시작 작업을 피할 수 있어 특히 연결 속도가 느릴 때 유용하지만, 복구 계층 구조에서 데이터베이스나 가족 원본과 혼동해서는 안 됩니다.

Immich 저장소 아키텍처에 관한 커뮤니티 토론은 운영자가 캐시처럼 빠르게 사용하는 데이터와 대량의 사진 저장 공간을 분리하는 이유를 보여 줍니다. 이러한 구성은 참고용으로만 활용하고, 무엇이든 옮기기 전에 자신의 Compose 정의에서 현재 경로와 마운트를 확인하세요.

모델 캐시가 사라진 경우, 서비스가 필요한 소스에 접근할 수 있고 디스크 공간이 충분하다면 일반적으로 캐시를 다시 만들거나 다운로드하는 것으로 복구할 수 있습니다. 백업 도구가 대용량의 재생성 가능한 캐시를 실수로 부족한 오프사이트 저장 공간에 백업하지 않도록 이 동작을 문서화하세요.

쓰기 가능 레이어, 로그 및 스크래치 공간의 사용량 제한

컨테이너의 쓰기 가능 레이어를 영구 파생 파일, 임시 트랜스코딩 파일 또는 대용량 로그의 비공식 저장소로 사용해서는 안 됩니다. Docker 디스크 사용량과 컨테이너 마운트를 확인해 용량이 커지는 모든 경로가 의도적으로 영구 저장되거나, 언제든 삭제할 수 있도록 설정되어 있는지 확인하세요. 설명되지 않는 쓰기 가능 레이어의 급증은 기본적으로 정리 대상이 아니라 구성 문제의 징후입니다.

2026년 Docker HQ의 안전한 Docker 디스크 정리 작업 방식은 정리 전에 감사하고 데이터베이스가 들어 있을 수 있는 볼륨을 보호하는 것을 강조합니다. 여기에도 같은 주의를 적용하세요. 각 볼륨과 레이어의 소유권을 확인하기 전에는 프로덕션 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.