Immich의 메모리 제한은 얼마로 설정해야 할까요?

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

보편적인 GB 수치 하나로 Immich 메모리 제한을 정하지 마세요. 호스트의 RAM 목표치와 컨테이너별 상한은 서로 다른 문제를 해결합니다. 호스트는 전체 스택을 감당할 수 있어야 하고, 컨테이너 제한은 정당한 Immich 작업을 중단시키지 않으면서 호스트를 보호해야 합니다.

처리가 끝난 라이브러리를 둘러볼 때는 메모리 사용량이 적어 보여도, 시스템을 한동안 사용하지 않은 뒤 머신러닝을 시작하거나 대량 가져오기, 썸네일 생성, 얼굴 분석 또는 동영상 작업을 수행하면 훨씬 많은 메모리를 사용할 수 있습니다. 실제로 필요한 작업 중 부하가 가장 큰 경우를 측정하고, PostgreSQL과 운영 체제를 위한 여유 공간을 확보하세요. OOM 종료가 반복된다면 이를 정상적인 제한 작동이 아니라 한도 설정 실패로 보세요.

제한을 정하기 전에 메모리 압박을 측정하세요

세 가지 상태에서 메모리를 기록하세요. 유휴 상태로 둘러보기, 일반적인 일일 업로드, 그리고 예정된 백그라운드 작업 중 가장 부하가 큰 경우입니다. 컨테이너 사용량, 호스트의 사용 가능 메모리, 스왑 활동, OOM 이벤트, 작업이 계속 진행되는지 여부를 기록하세요. Linux 메모리 집계에는 회수 방식이 서로 다른 여러 종류의 메모리가 포함되므로, docker stats에서 확인한 단일 최고값만으로는 충분하지 않습니다.

유용한 Docker cgroup 메모리 분석은 전체 수치를 똑같이 위험한 것으로 취급하는 대신 익명 메모리, 파일 기반 캐시, 슬랩 메모리를 구분합니다. 호스트에 여유 메모리가 충분하고 파일 캐시가 안정적인 경우는 익명 메모리가 꾸준히 증가하거나, 스왑 압박이 발생하거나, 동일한 Immich 작업 중 cgroup OOM 카운터가 증가하는 경우와 다릅니다.

반복 가능한 최대 사용량을 식별하고, 대부분 회수 가능한 캐시인지 현재 작업 메모리인지 설명할 수 있을 때 이 단계를 통과하세요. 변경되지 않은 작업 부하에서도 사용량이 계속 증가하거나, 컨테이너가 반복적으로 OOM 종료되거나, 호스트에서 스왑 사용량이 급증하기 시작하면 해당 실행 결과를 기준으로 용량을 산정하지 말고 먼저 비정상적인 증가 원인을 진단하세요.

유효한 Immich 작업 부하 중 가장 높은 수준에 맞춰 상한을 설정하세요

한도를 적용한 뒤에도 지원해야 하는 작업 부하를 선택하세요. 어떤 가정에서는 휴대폰 네 대가 업로드하는 동안 Smart Search와 얼굴 인식 작업을 따라잡는 상황일 수 있고, 다른 가정에서는 대량의 초기 가져오기 작업이 끝난 뒤 일반적으로 탐색하는 상황일 수 있습니다. 한도가 명확하게 정의된 서비스 목표를 반영하도록 측정하는 동안 데이터 세트, 모델, 동시 실행 설정, 기타 컨테이너를 동일하게 유지하세요.

짧은 시간 동안의 급격한 증가에 대비해 측정 가능한 여유분을 두고, 회수 불가능한 메모리 사용량의 최고치보다 하드 상한을 높게 설정하세요. 동시에 PostgreSQL, 파일 시스템 캐시, 컨테이너 런타임, 관련 없는 서비스에 필요한 호스트 메모리도 확보해야 합니다. 로컬 AI 리소스 경고 신호에 관한 ZimaSpace 체크리스트가 유용한 이유는 발열, 스와핑, 갑작스러운 재시작처럼 Immich만의 그래프로는 놓칠 수 있는 호스트 수준의 부담을 보여 주기 때문입니다. “컨테이너가 한 번 한도에 도달했다”는 사실만으로 RAM이 더 필요하다고 판단하지 마세요. 중요한 실패 기준은 동일한 유효 작업 부하에서 속도가 크게 떨어지거나, 작업이 유실되거나, 지속적으로 스와핑이 발생하거나, OOM으로 종료되는지 여부입니다. 반대로 Immich의 자체 cgroup 한도에 도달하기 전에 Immich가 데이터베이스나 호스트의 리소스를 고갈시킬 수 있다면 한도가 너무 높게 설정된 것입니다.

비정상적인 메모리 증가에 대응할 때는 한도를 높이기 전에 작업량을 줄이세요

제안한 상한이 특정 유형의 백그라운드 작업 중에만 문제를 일으킨다면, 상한을 높이기 전에 해당 작업의 동시 실행 수를 줄이거나 처리 단계를 격리하세요. 머신러닝, 썸네일 생성, 동영상 처리, 데이터베이스 작업은 메모리 사용 패턴이 서로 다를 수 있습니다. 활성 배치의 크기를 줄이면 처리 속도는 느려질 수 있지만, 집 안에서 사용하는 인터페이스의 응답성을 유지하고 호스트를 복구할 수 있는 상태로 둘 수 있습니다.

버전별 실패도 중요합니다. Immich v3.0.3 메모리 보고서에 따르면 로캘 관련 비정상 조건이 발생한 후 머신러닝 워커의 메모리 사용량이 계속 증가해 cgroup 한도에 도달하면서 OOM이 발생했습니다. 이 사례가 일반적인 Immich RAM 사용량을 보여 주는 것은 아닙니다. 원인을 알 수 없는 사용량 증가가 발생하면 호스트 메모리 예산을 영구적으로 늘리기 전에 소프트웨어나 구성 문제의 가능성을 먼저 살펴봐야 한다는 점을 보여 줍니다.

동시성, 모델 또는 버전 변수를 하나 변경한 후 동일한 워크로드를 다시 실행하세요. 메모리 사용 양상과 원래 작업이 모두 예상한 방향으로 개선되는 경우에만 변경 사항을 유지하세요. 안정적인 정점에 가까워지지 않은 채 메모리 사용량이 계속 증가한다면 로그와 버전 세부 정보를 보존하고, 하드 한도를 계속 더 큰 수치로 높이는 대신 문제를 상위 단계로 전달하세요.

콜드 재시작 및 바쁜 주기 후 한도 검증

호스트를 재시작해 캐시와 모델이 알려진 콜드 상태에서 시작하도록 하세요. 일반적인 로그인 및 탐색 확인을 수행한 다음, 대표적인 업로드와 백그라운드 워크로드를 실행하세요. 익명 메모리 최고 사용량, 캐시, 스왑, OOM 카운터, 데이터베이스 응답, 대기열 처리 시간, 다른 주요 컨테이너의 응답성을 기록하세요.

통과한 한도는 콜드 스타트와 평상시 가장 바쁜 주기 모두에서 OOM 종료, 지속적인 스왑 스래싱, 반복되는 컨테이너 재시작, 멈춰서 더 이상 줄어들지 않는 대기열 없이 유지되어야 합니다. 또한 Immich가 바쁠 때 데이터베이스 덤프나 관리자 로그인 같은 복구 작업을 처리할 수 있도록 호스트에 충분한 여유를 남겨야 합니다.

정의된 가정용 워크로드는 모두 통과하고 인위적인 스트레스 테스트만 실패한다면, 필요하지 않은 상황을 위해 RAM을 구매하는 대신 허용 가능한 경계를 문서화하세요.

실제 워크로드가 호스트 자원을 고갈시키지 않고는 통과할 수 없다면 동시성을 낮추거나, 머신러닝을 격리하거나, 메모리를 추가하거나, 경합하는 서비스를 옮기세요. 그런 다음 새 한도가 안전하다고 선언하기 전에 동일한 검증을 반복하세요.

지원 및 팁

더 읽어보기

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.