Immich 데이터베이스 연결을 최적화하려면 먼저 max_connections를 늘리지 말고 모든 Immich 프로세스와 다른 PostgreSQL 클라이언트의 전체 세션 수요를 측정하세요. 데이터베이스에는 실제 워크로드를 처리할 만큼의 세션과 관리 작업을 위한 여유 공간이 필요하지만, 동시성을 지나치게 높이면 쿼리 속도는 빨라지지 않고 메모리 사용량과 경합만 늘어날 수 있습니다.
여러 컨테이너를 사용하는 홈 서버에서는 일반 사용 중과 동시 시작 중에 활성, 유휴, 대기 연결을 쿼리 지연 시간, CPU, 메모리, 스토리지 지연 시간과 함께 기록하세요. Immich 컨테이너 하나의 설정이 적절해 보여도 “too many clients” 오류는 전체 설정, 다른 서비스 또는 재시작 폭주 때문에 발생할 수 있습니다.
제한을 변경하기 전에 모든 PostgreSQL 클라이언트 파악하기
같은 PostgreSQL 인스턴스에 연결하는 각 Immich 서버 프로세스 또는 복제본, 마이그레이션/유지보수 작업, 백업 작업, 모니터링 도구 및 관련 없는 애플리케이션을 나열하세요. 가능하면 각각 별도의 데이터베이스 사용자를 지정해 pg_stat_activity에서 세션 보유자를 확인할 수 있게 하세요. 현재 max_connections 값을 기록하고, 사고 대응을 위한 관리 경로를 하나 확보해 두세요.
Immich의 “too many clients” 토론에는 해당 릴리스에서 Immich가 기본 풀 크기 10을 사용했다는 프로젝트 댓글이 있습니다. 2026년의 별도 토론에서는 여러 Immich 워커가 각각 풀을 유지할 수 있다고 언급합니다. 이 수치는 버전에 따라 달라지는 구현 정보로 취급하고, 향후 릴리스에도 무작정 곱해 적용하지 마세요. Immich가 유휴 상태인데도 데이터베이스 연결 수가 이미 한도에 가까우면 Immich를 조정하기 전에 해당 세션의 소유자를 확인하세요. 활성 세션은 적지만 쿼리가 느리다면 연결 수가 주된 병목이 아니라 스토리지 또는 쿼리 지연의 증상일 수 있습니다.
측정된 동시 사용량을 바탕으로 연결 예산 세우기
데이터베이스 관리, 백업/복원 도구, 마이그레이션, 모니터링을 위해 세션을 확보해 두세요.
그런 다음 남은 애플리케이션 연결을 동시에 실행되는 Immich 프로세스 수와 다른 애플리케이션에 배분하세요. 일반적인 작업이 불필요하게 대기하지 않을 만큼 풀을 충분히 크게 설정하되, 데이터베이스가 효율적으로 처리할 수 있는 크기를 넘지 않는 것이 목표입니다.
PostgreSQL 연결 풀 크기 분석에서는 이상적인 풀이 일반적인 수요를 처리할 만큼 충분히 크면서도 가능한 한 작아야 한다고 설명합니다. 백엔드 세션이 적을수록 경합이 줄어들기 때문입니다. 다른 워크로드의 웹 서버 풀 크기를 그대로 가져오는 대신, 관찰된 Immich 수요에 이 원칙을 적용하세요.
Immich 릴리스에서 지원되는 풀 크기 설정을 제공하지 않는다면, 목표 수치에 맞추려고 내부 코드를 패치하지 마세요. 애플리케이션 복제본 수, 관련 없는 클라이언트, 재시작 시점, 백업 중복 실행, 데이터베이스 용량 등 제어 가능한 요소를 조정하세요. 버전이 변경되면 지원되는 설정이 있는지 다시 확인하세요.
세션을 더 늘리기 전에 연결 churn과 데이터베이스 대기 줄이기
Immich, 분석 작업, 백업 작업 및 다른 앱이 동시에 다시 연결되거나 마이그레이션을 실행하지 않도록 컨테이너 시작 시점을 분산하세요. PostgreSQL을 사용할 수 있을 때까지 대기하는 상태 확인 및 준비 상태 확인을 사용하되, 데이터베이스가 아직 복구 중일 때 연결 폭주를 일으키는 짧은 재시도 간격은 피하세요.
ZimaSpace의 외부 Immich 데이터베이스 안전성 가이드는 중요한 기준입니다. PostgreSQL을 기본 스택에서 분리하면 버전, 확장 기능, 권한, 백업, 롤백에 대한 책임이 명확해집니다. 느린 쿼리나 스토리지 포화 문제를 감추기 위해서만 연결 프록시나 추가 데이터베이스 호스트를 도입해서는 안 됩니다.
유휴 세션이 많고 애플리케이션 수가 실제로 많다면, 일부 PostgreSQL 아키텍처에서는 연결 풀러로 백엔드 세션 수를 줄일 수 있습니다. 단, 정확한 Immich 버전, 마이그레이션, 트랜잭션 의미, 준비된 문장의 동작을 테스트한 후에만 사용하세요. 풀링은 폭주하는 클라이언트나 과부하된 데이터베이스를 바로잡는 대안이 아닙니다.
동시 업로드, 검색, 작업 및 재시작으로 검증
반복 가능한 피크 부하를 만드세요. 예상되는 다른 컨테이너가 활성화된 상태에서 대표적인 모바일 업로드, 이전 검색 또는 탐색 작업, 일반적인 백그라운드 작업 조합을 실행하세요. 사용자 및 상태별 연결 수, 연결 확보 또는 요청 오류, 쿼리 지연 시간, 데이터베이스 CPU, 메모리, 디스크 지연 시간을 기록하세요. 그런 다음 한 가지 변경 사항을 적용한 후 다시 실행하세요.
정상적으로 작동하는 구성은 세션 수를 장애 한도보다 낮게 유지하면서 관리 작업을 위한 여유를 확보하고, “클라이언트가 너무 많습니다” 오류를 방지하며, 쿼리 지연 시간을 가정 내 목표 범위로 유지하고, 피크 이후 대기열이 비워지도록 합니다. 데이터베이스에 CPU, 메모리, I/O 용량이 남아 있는데도 세션을 기다리는 요청이 실제로 있을 때만 연결 수를 늘리는 것이 타당합니다.
최대 연결 폭주를 테스트하려면 애플리케이션 스택을 재시작한 다음 호스트도 한 번 재시작하세요. 시작 중에만 문제가 발생한다면 영구적인 한도를 높이는 대신 실행 순서와 재시도 동작을 수정하세요. 세션이 시간이 지나면서 누적된다면 세션을 소유한 사용자와 쿼리를 기록하고, 버전 정보와 연결 상태 증거를 함께 첨부해 해당 누수 패턴을 에스컬레이션하세요.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



