La connexion à Immich échoue après le redémarrage du proxy inverse

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.

Si la connexion à Immich échoue uniquement après le redémarrage du proxy inverse, vérifiez d’abord si le chemin passant par le proxy est en panne alors que l’application Immich et le compte fonctionnent toujours en accès direct.

Un redémarrage peut révéler des adresses de services en amont obsolètes, l’absence d’appartenance à un réseau partagé, des changements d’en-têtes, un comportement des cookies ou un processus proxy qui a redémarré avant que ses dépendances ne soient accessibles. Testez le même compte via le point de terminaison Immich local et le nom d’hôte public habituel, puis repérez la première couche où les deux chemins divergent.

Utiliser l’accès direct pour distinguer un problème d’authentification d’une panne du proxy

Testez un compte connu auprès du serveur Immich via une route locale fiable qui contourne le proxy inverse. Si la connexion directe réussit alors que le nom d’hôte public tourne en boucle, redirige ou renvoie une erreur en amont, l’enregistrement utilisateur et le chemin d’authentification principal sont probablement intacts. Concentrez l’enquête sur le proxy, TLS, le routage et l’état du navigateur.

Un cas rapporté par la communauté, où l’accès direct fonctionnait, mais la connexion via le proxy échouait, illustre cette méthode d’isolation. Le signalement concerne une version précise ; utilisez-le pour justifier la comparaison des chemins d’accès, plutôt que de supposer que la cause première est la même.

Si la connexion échoue à la fois directement et via le proxy, cessez de modifier les paramètres du proxy. Vérifiez plutôt l’état du service Immich, la connectivité à la base de données, l’état du compte et les journaux du serveur. Le redémarrage du proxy survenu à peu près au moment de la panne peut être une coïncidence ; le test de contournement évite d’en faire une cause non étayée.

Vérifier que le proxy peut joindre le service Immich actuel

Après le redémarrage du proxy, vérifiez qu’il peut résoudre et joindre le service Immich en amont depuis son propre espace de noms réseau. Dans Docker, une adresse de service en amont utilisant le nom du service sur un réseau défini par l’utilisateur partagé est généralement plus stable qu’une adresse IP de conteneur copiée manuellement, qui change lorsqu’un conteneur est recréé.

Une discussion sur une panne de proxy portant sur la connectivité entre le proxy et Immich montre pourquoi il faut vérifier l’accessibilité du service en amont et la prise en charge des WebSockets par le proxy avant de tenter de récupérer un compte. Considérez la configuration exacte comme un témoignage anecdotique, et non comme un modèle valable pour tous les proxys.

Redémarrez le proxy seul deux fois et vérifiez si son service en amont est résolu de la même façon à chaque fois. Le test est réussi si la connexion s’établit immédiatement, sans modifier les adresses. Si la résolution de noms, l’appartenance au réseau ou le port cible change après la recréation, corrigez la définition du réseau Compose au lieu de redémarrer la pile à répétition.

Inspecter les en-têtes transférés, TLS et le comportement des cookies

La connexion peut échouer même si le proxy renvoie la page Immich, car l’authentification dépend de l’ensemble du chemin HTTP. Comparez la configuration du proxy avant et après le redémarrage, notamment la transmission de l’hôte et du schéma, la terminaison HTTPS, les redirections, toute réécriture des cookies et la présence éventuelle d’un second proxy ou tunnel qui modifie également la réponse.

Une discussion de la communauté Immich documente un cas de connexion bloquée par des cookies en double, dans lequel la gestion des cookies par le proxy a provoqué un blocage de la connexion. Ce cas est spécifique, mais il rappelle utilement qu’il faut examiner la réponse du navigateur et les cookies, plutôt que de supposer que des identifiants valides garantissent le bon fonctionnement d’une session via le proxy.

Ne supprimez pas tous les comptes et ne réinitialisez pas la base de données parce qu’une session du navigateur semble bloquée. Après avoir relevé les cookies et la réponse d’origine, essayez une fenêtre de navigation privée ou un deuxième navigateur. Si un client vierge fonctionne, effacez uniquement les données du site concerné et corrigez la règle du proxy qui a créé le cookie ou la redirection défectueux.

Consulter les journaux d’accès et d’erreur du proxy à l’horodatage de l’échec de la requête

Reproduisez une tentative de connexion et notez l’heure exacte, le nom d’hôte public, le client et le statut renvoyé. Consultez ensuite les journaux d’accès et d’erreur du proxy autour de cette requête. Distinguez une requête qui n’a jamais atteint le proxy, une erreur 4xx ou 5xx générée par le proxy, un échec de connexion au serveur en amont et une requête qui a atteint Immich mais a reçu une réponse de l’application.

Le processus de dépannage des journaux NGINX montre comment le statut, les erreurs en amont, le temps de traitement des requêtes et la journalisation ciblée fournissent des indications bien plus fiables que d’actualiser sans cesse la page de connexion. Appliquez le même principe à Caddy, Traefik ou à un autre proxy.

Si le journal du proxy indique une réponse réussie du serveur en amont alors que le navigateur ne parvient pas à terminer la connexion, vérifiez les redirections, les cookies, TLS et l’état du client. Si le proxy ne peut pas se connecter au serveur en amont, corrigez le routage ou la disponibilité du service. Si Immich renvoie lui-même l’erreur, consultez le journal serveur correspondant au lieu d’incriminer le proxy.

Vérifier que le correctif résiste au redémarrage à l’origine du problème

Après avoir corrigé la cause confirmée, reproduisez exactement le déclencheur : redémarrez uniquement le proxy inverse, attendez la vérification de son état de santé, puis connectez-vous via le nom d’hôte public. Ouvrez ensuite un fichier existant, téléversez un petit fichier et laissez la session active assez longtemps pour vérifier que le trafic API fonctionne normalement.

Le guide ZimaSpace sur les accès contrôlés à distance définit le cadre général : le proxy n’est qu’une couche de l’accès à distance. Le DNS, TLS, l’authentification et le service en amont privé doivent donc rester configurés délibérément et être observables.

Ne validez le correctif que si la connexion fonctionne encore après deux redémarrages du proxy et que la même configuration démarre correctement après le redémarrage complet de la pile. Annulez les modifications récentes du proxy si une nouvelle règle d’en-tête ou de cookie a provoqué le problème. Pour l’escalade, fournissez le diff de configuration du proxy, le statut de la requête, l’erreur en amont, l’horodatage du journal serveur et le résultat du test direct par rapport au test via le proxy.

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.