Si Immich se detiene después de una actualización de ZimaOS y el registro del servidor muestra getaddrinfo EAI_AGAIN immich-postgres, el fallo inmediato está en la resolución de nombres entre contenedores. Esto no demuestra que el volumen de datos de PostgreSQL esté dañado.
En el hilo original de la versión 1.6.1, el cambio de nombre de las rutas de almacenamiento afectó a varias aplicaciones, pero MariaDB, Plex y Nextcloud se recuperaron después de corregir sus rutas. Immich era diferente: PostgreSQL estaba funcionando correctamente, mientras que immich-server no podía resolver el nombre de host immich-postgres.
Interpreta literalmente el error de Immich
EAI_AGAIN indica un fallo temporal de resolución DNS. El servidor intentaba conectarse a un host de base de datos llamado immich-postgres, mientras que el propio contenedor de la base de datos indicaba que estaba listo para aceptar conexiones.
Por eso, la red de Docker y el descubrimiento de servicios son la primera capa que debes comprobar. No empieces eliminando la base de datos ni recreando la biblioteca de fotos.
Verifica que los servicios de Immich compartan una red de Compose
La guía de redes de Compose de Docker explica que los servicios conectados a la misma red de Compose pueden comunicarse entre sí mediante el nombre del servicio. Las direcciones IP de los contenedores pueden cambiar después de recrearlos, mientras que el nombre del servicio permanece estable.
Comprueba que immich-server, PostgreSQL y Redis estén conectados a la red compartida prevista y que el nombre de host de la base de datos en Immich siga coincidiendo con el nombre del servicio de Compose. Evita sustituir el nombre de host por una IP fija del contenedor como solución permanente.
Trata el cambio de nombre del volumen como una comprobación de migración independiente
La actualización también cambió algunos nombres de almacenamiento al sustituir los espacios por guiones bajos en el entorno de este usuario. Corregir esas rutas del host era necesario para otras aplicaciones, así que revisa también todos los montajes de enlace de Immich, especialmente las rutas de la biblioteca, las cargas y la base de datos.
La guía de rutas de almacenamiento de Immich y la guía de migración de datos de aplicaciones pueden ayudarte a separar los problemas de rutas de almacenamiento de los problemas de red.
Recrea la pila solo después de hacer una copia de seguridad de la configuración
Después de confirmar el archivo de Compose y las rutas, recrear la pila de Immich puede reconstruir la red de Docker prevista y las entradas DNS. Conserva el volumen de la base de datos y las rutas de la biblioteca de Immich; no uses un restablecimiento destructivo como prueba de red.
Posteriormente, ZimaOS 1.7.1 incluyó mejoras en la configuración de la red de Docker y la compatibilidad de la migración de aplicaciones en sus notas de la versión 1.7.1. Es una razón para actualizar, pero el registro de cambios no afirma específicamente que se haya corregido este caso exacto de EAI_AGAIN de Immich.
En resumen
Cuando PostgreSQL funciona correctamente, pero Immich muestra EAI_AGAIN immich-postgres, primero diagnostica el DNS del nombre del servicio y las redes compartidas de Docker. Después, verifica por separado todas las rutas de volúmenes del host que hayan cambiado de nombre con la actualización de ZimaOS.
