Comment optimiser les connexions à la base de données Immich pour des conteneurs simultanés

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Pour optimiser les connexions à la base de données d’Immich, mesurez la demande totale de sessions de chaque processus Immich et autre client PostgreSQL, au lieu d’augmenter d’abord max_connections. La base de données doit disposer d’assez de sessions pour répondre à la charge de travail réelle, avec une marge pour les tâches d’administration, mais une concurrence excessive peut accroître l’utilisation de la mémoire et la contention sans accélérer les requêtes.

Sur un serveur domestique exécutant plusieurs conteneurs, consignez le nombre de connexions actives, inactives et en attente, ainsi que la latence des requêtes, l’utilisation du processeur et de la mémoire et la latence du stockage, en période d’utilisation normale et lors de démarrages simultanés. Une erreur « too many clients » peut être due à une configuration globale, à un autre service ou à une vague de redémarrages, même si un seul conteneur Immich semble peu gourmand.

Répertorier tous les clients PostgreSQL avant de modifier les limites

Répertoriez chaque processus serveur ou réplique Immich, tâche de migration ou de maintenance, tâche de sauvegarde, outil de supervision et application indépendante qui se connecte à la même instance PostgreSQL. Dans la mesure du possible, attribuez-leur des utilisateurs de base de données distincts afin que pg_stat_activity indique qui détient les sessions. Relevez la valeur actuelle de max_connections et préservez une voie d’accès administrative pour la réponse aux incidents.

Une discussion sur « too many clients » concernant Immich comprend un commentaire du projet indiquant qu’Immich utilisait un pool par défaut de 10 dans cette version. Une autre discussion de 2026 précise que plusieurs workers Immich peuvent chacun maintenir un pool. Considérez ces chiffres comme des informations liées à l’implémentation d’une version donnée, et non comme une valeur à multiplier aveuglément pour les prochaines versions. Si la base de données approche déjà de sa limite de connexions alors qu’Immich est inactif, identifiez le propriétaire de ces sessions avant de régler Immich. Si le nombre de sessions actives est faible, mais que les requêtes sont lentes, le nombre de connexions peut être le symptôme d’une latence du stockage ou des requêtes, plutôt que le principal goulot d’étranglement.

Établir un budget de connexions à partir de la concurrence mesurée

Réservez des sessions pour l’administration de la base de données, les outils de sauvegarde et de restauration, les migrations et la supervision.

Répartissez ensuite les connexions applicatives restantes entre les processus Immich exécutés simultanément et les autres applications. L’objectif est d’avoir un pool assez grand pour que les tâches habituelles ne soient pas inutilement mises en attente, sans dépasser la capacité d’exécution efficace de la base de données.

Une analyse du dimensionnement du pool de connexions PostgreSQL décrit le pool idéal comme étant suffisamment grand pour répondre à la demande normale, tout en restant aussi petit que possible, car un nombre réduit de sessions backend limite la contention. Appliquez ce principe à la demande observée d’Immich, au lieu de reprendre la taille d’un pool de serveur web utilisé pour une autre charge de travail.

Si la version d’Immich ne propose pas de réglage pris en charge pour la taille du pool, ne modifiez pas les composants internes dans le seul but d’atteindre un nombre cible. Agissez sur ce que vous pouvez contrôler : nombre de réplicas de l’application, clients sans rapport, calendrier des redémarrages, chevauchement des sauvegardes et capacité de la base de données. Réévaluez les paramètres pris en charge lors des changements de version.

Réduire le renouvellement des connexions et l’attente dans la base de données avant d’ajouter des sessions

Échelonnez le démarrage des conteneurs afin qu’Immich, les analyses, les tâches de sauvegarde et les autres applications ne se reconnectent pas ou ne lancent pas leurs migrations toutes en même temps. Utilisez des vérifications de santé et de disponibilité qui attendent que PostgreSQL soit opérationnel, mais évitez les boucles de nouvelle tentative trop rapprochées, qui provoqueraient une tempête de connexions pendant que la base de données se rétablit.

Le guide ZimaSpace sur la sécurité d’une base de données Immich externe fixe une limite importante : dès que PostgreSQL est séparé de la pile par défaut, les responsabilités liées à la version, aux extensions, aux privilèges, aux sauvegardes et au retour arrière deviennent explicites. Il ne faut pas introduire un proxy de connexion ou un hôte de base de données supplémentaire uniquement pour masquer des requêtes lentes ou un stockage saturé.

Si de nombreuses sessions sont inactives et que le nombre d’applications est réellement élevé, un gestionnaire de pool de connexions peut réduire le nombre de sessions côté serveur dans certaines architectures PostgreSQL, mais uniquement après avoir testé la version exacte d’Immich, les migrations, la sémantique des transactions et le comportement des instructions préparées. Le regroupement des connexions ne remplace pas la correction d’un client incontrôlable ou d’une base de données surchargée.

Valider avec des téléversements, des recherches, des tâches simultanées et un redémarrage

Reproduisez un pic de manière répétable : effectuez des téléversements mobiles représentatifs, une ancienne action de recherche ou de navigation, ainsi que les tâches d’arrière-plan habituelles, pendant que les autres conteneurs prévus sont actifs. Relevez le nombre de connexions par utilisateur et par état, les erreurs d’acquisition ou de requête, la latence des requêtes, l’utilisation du processeur et de la mémoire de la base de données, ainsi que la latence du disque. Répétez ensuite le test après une seule modification.

Une configuration satisfaisante maintient les sessions sous le seuil d’échec tout en conservant une marge pour l’administration, évite les erreurs « trop de clients », maintient la latence des requêtes dans les limites visées pour le foyer et permet aux files d’attente de se vider après le pic. Davantage de connexions ne se justifient que lorsque des requêtes attendent réellement une session alors que la base de données dispose encore de capacités CPU, mémoire et d’E/S.

Redémarrez la pile applicative, puis l’hôte une fois, afin de tester le pic de connexions le plus élevé. Si le problème survient uniquement au démarrage, corrigez l’ordre de démarrage ou le comportement des tentatives plutôt que d’augmenter le plafond permanent. Si les sessions s’accumulent avec le temps, relevez les utilisateurs et les requêtes qui en sont responsables, puis signalez cette fuite en indiquant les versions et les éléments attestant l’état des connexions.

Assistance et conseils

À lire aussi

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.