Cómo optimizar las conexiones a la base de datos de Immich para contenedores simultáneos

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Optimiza las conexiones de la base de datos de Immich midiendo la demanda total de sesiones de cada proceso de Immich y de los demás clientes de PostgreSQL, en lugar de aumentar primero max_connections. La base de datos necesita suficientes sesiones para la carga de trabajo real y un margen administrativo, pero una concurrencia excesiva puede aumentar el uso de memoria y la contención sin acelerar las consultas.

En un servidor doméstico con varios contenedores, registra las conexiones activas, inactivas y en espera, junto con la latencia de las consultas, la CPU, la memoria y la latencia del almacenamiento, tanto durante el uso habitual como durante los arranques simultáneos. El error «demasiados clientes» puede deberse a la configuración agregada, a otro servicio o a una avalancha de reinicios, aunque un contenedor de Immich parezca tener una configuración moderada.

Haz un inventario de cada cliente de PostgreSQL antes de cambiar los límites

Enumera cada proceso o réplica del servidor Immich, tarea de migración o mantenimiento, trabajo de copia de seguridad, herramienta de monitorización y aplicación no relacionada que se conecte a la misma instancia de PostgreSQL. Cuando sea práctico, asígnales usuarios de base de datos distintos para que pg_stat_activity muestre quién mantiene las sesiones. Anota el valor actual de max_connections y conserva una vía de acceso administrativo para responder ante incidentes.

Un debate sobre «demasiados clientes» en Immich incluye un comentario del proyecto que indica que, en esa versión, Immich usaba un pool predeterminado de 10. En otro debate de 2026 se señala que varios trabajadores de Immich pueden mantener cada uno su propio pool. Considera estas cifras como contexto de implementación específico de cada versión, no como un número que debas multiplicar a ciegas en futuras versiones. Si la base de datos ya está cerca de su límite de conexiones cuando Immich está inactivo, identifica quién es el propietario de esas sesiones antes de ajustar Immich. Si hay pocas sesiones activas, pero las consultas son lentas, el número de conexiones podría ser un síntoma de la latencia del almacenamiento o de las consultas, y no el principal cuello de botella.

Elabora un presupuesto de conexiones a partir de la concurrencia medida

Reserva sesiones para la administración de la base de datos, las herramientas de copia de seguridad y restauración, las migraciones y la monitorización.

Después, reparte las conexiones restantes de la aplicación entre los procesos de Immich que se ejecutan simultáneamente y las demás aplicaciones. El objetivo es que el pool tenga capacidad suficiente para que el trabajo habitual no espere innecesariamente, pero no más de lo que la base de datos pueda ejecutar de manera eficiente.

Un análisis del dimensionamiento del pool de conexiones de PostgreSQL describe el pool ideal como lo bastante grande para cubrir la demanda habitual y, a la vez, tan pequeño como resulte práctico, porque menos sesiones de backend reducen la contención. Aplica ese principio a la demanda observada de Immich en lugar de copiar el tamaño del pool de un servidor web con otra carga de trabajo.

Si la versión de Immich no ofrece un control compatible del tamaño del grupo de conexiones, no modifiques el código interno solo para alcanzar una cifra objetivo. Controla lo que sí puedes: el número de réplicas de la aplicación, los clientes ajenos a ella, el momento de los reinicios, la coincidencia con las copias de seguridad y la capacidad de la base de datos. Revisa la configuración compatible cuando cambien las versiones.

Reduce la rotación de conexiones y las esperas en la base de datos antes de añadir más sesiones

Escalona el inicio de los contenedores para que Immich, las tareas de analítica y copia de seguridad, y otras aplicaciones no vuelvan a conectarse ni migren todas al mismo tiempo. Usa comprobaciones de salud o disponibilidad que esperen a que PostgreSQL esté operativo, pero evita ciclos de reintentos demasiado frecuentes que provoquen una avalancha de conexiones mientras la base de datos aún se recupera.

La guía de ZimaSpace sobre la seguridad de las bases de datos externas de Immich marca un límite importante: al separar PostgreSQL de la pila predeterminada, las responsabilidades relativas a las versiones, extensiones, permisos, copias de seguridad y reversiones quedan explícitas. No se debe introducir un proxy de conexiones ni un host de base de datos adicional solo para ocultar consultas lentas o almacenamiento saturado.

Si muchas sesiones están inactivas y el número de conexiones de la aplicación es legítimamente alto, un administrador de conexiones puede reducir las sesiones del servidor en algunas arquitecturas de PostgreSQL, pero solo después de probar la versión exacta de Immich, las migraciones, la semántica de las transacciones y el comportamiento de las instrucciones preparadas. La agrupación de conexiones no sustituye la corrección de un cliente descontrolado ni de una base de datos sobrecargada.

Validar con cargas, búsquedas, trabajos y reinicios simultáneos

Crea un pico reproducible: ejecuta cargas móviles representativas, una búsqueda o navegación antigua y la combinación habitual de trabajos en segundo plano mientras están activos los demás contenedores previstos. Registra el número de conexiones por usuario y estado, los errores de adquisición o solicitud, la latencia de las consultas, el uso de CPU y memoria de la base de datos, y la latencia del disco. Luego repite la prueba después de un solo cambio.

Una configuración satisfactoria mantiene las sesiones por debajo del límite que provoca el fallo, con margen para la administración, evita los errores de «demasiados clientes», mantiene la latencia de las consultas dentro del objetivo previsto para el hogar y permite que las colas se vacíen después del pico. Solo se justifican más conexiones cuando hay solicitudes realmente a la espera de una sesión y la base de datos aún dispone de capacidad de CPU, memoria y E/S.

Reinicia una vez la pila de aplicaciones y luego el host para probar el pico máximo de conexiones. Si el fallo aparece solo durante el inicio, corrige el orden de arranque o el comportamiento de los reintentos en lugar de elevar el límite permanente. Si las sesiones se acumulan con el tiempo, registra los usuarios y las consultas responsables y escala ese patrón de fuga junto con las versiones y las pruebas del estado de las conexiones.

Soporte y consejos

Más para leer

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.