Se l’accesso a Immich non riesce solo dopo il riavvio del reverse proxy, verifica innanzitutto se il percorso del proxy si è interrotto mentre l’applicazione Immich e l’account funzionano ancora direttamente.
Un riavvio può far emergere indirizzi upstream obsoleti, l’assenza di una rete condivisa, modifiche alle intestazioni, il comportamento dei cookie o un processo proxy riavviato prima che le sue dipendenze fossero raggiungibili. Prova lo stesso account tramite l’endpoint Immich locale e il normale nome host pubblico, quindi individua il primo livello in cui i due percorsi divergono.
Usa l’accesso diretto per distinguere i problemi di autenticazione da quelli del proxy
Prova ad accedere con un account verificato al server Immich attraverso un percorso locale attendibile che bypassa il reverse proxy. Se l’accesso diretto riesce mentre il nome host pubblico resta in caricamento, reindirizza o restituisce un errore upstream, probabilmente il record utente e il flusso di autenticazione principale funzionano. Concentra l’indagine sul proxy, su TLS, sull’instradamento e sullo stato del browser.
Un caso segnalato dalla community in cui l’accesso diretto funzionava mentre quello tramite proxy non riusciva illustra questo metodo di isolamento. La segnalazione riguarda una versione specifica, quindi usala per motivare il confronto tra i percorsi, senza presumere che la causa principale sia la stessa.
Se non riesci ad accedere né direttamente né tramite proxy, smetti di modificare le impostazioni del proxy. Controlla invece lo stato del servizio Immich, la connettività del database, lo stato dell’account e i log del server. Il riavvio del proxy avvenuto in prossimità del problema potrebbe essere una coincidenza; il test di bypass evita di considerare quella tempistica una diagnosi non supportata.
Verifica che il proxy possa raggiungere l’upstream Immich attuale
Dopo il riavvio del proxy, verifica che possa risolvere e raggiungere l’upstream Immich dal proprio namespace di rete. In Docker, un upstream basato sul nome del servizio su una rete condivisa definita dall’utente è generalmente più stabile di un IP del container copiato manualmente, che cambia quando il container viene ricreato.
Una discussione su un’interruzione del reverse proxy relativa alla connettività tra proxy e Immich mostra perché è opportuno verificare la raggiungibilità dell’upstream e il supporto WebSocket del proxy prima di recuperare l’account. Considera la configurazione specifica una testimonianza aneddotica, non un modello valido per ogni proxy.
Riavvia il proxy da solo due volte e verifica se ogni volta raggiunge lo stesso servizio upstream. Il test è superato se la connessione riesce subito, senza modificare gli indirizzi. Se la risoluzione dei nomi, l’appartenenza alla rete o la porta di destinazione cambiano dopo la ricreazione, correggi la definizione della rete Compose anziché riavviare ripetutamente lo stack.
Controlla le intestazioni Forwarded, TLS e il comportamento dei cookie
L’accesso può non riuscire anche quando il proxy restituisce la pagina di Immich, perché l’autenticazione dipende dall’intero percorso HTTP. Confronta la configurazione del proxy prima e dopo il riavvio, inclusi l’inoltro di host e schema, la terminazione HTTPS, i reindirizzamenti, eventuali modifiche ai cookie e la presenza di un secondo proxy o tunnel che modifica anch’esso la risposta.
Una discussione della community di Immich documenta un caso di login bloccato da cookie duplicati in cui la gestione dei cookie da parte del proxy ha causato il blocco. Si tratta di un caso circoscritto, ma ricorda di controllare la risposta e i cookie nel browser invece di dare per scontato che credenziali valide garantiscano una sessione tramite proxy funzionante.
Non eliminare tutti gli account né reimpostare il database solo perché la sessione del browser sembra bloccata. Dopo aver registrato i cookie e la risposta originali, prova in una finestra privata o con un secondo browser. Se con un client pulito funziona, cancella solo i dati del sito interessato e correggi la regola del proxy che ha generato il cookie o il reindirizzamento errato.
Esamina i log di accesso e degli errori del proxy all’orario della richiesta non riuscita
Ripeti un tentativo di login e annota l’orario esatto, il nome host pubblico, il client e lo stato restituito. Poi controlla i log di accesso e degli errori del proxy relativi a quella richiesta. Distingui tra una richiesta che non ha mai raggiunto il proxy, una risposta 4xx o 5xx generata dal proxy, un errore di connessione all’upstream e una richiesta arrivata a Immich che ha ricevuto una risposta dell’applicazione.
Il flusso di lavoro per la risoluzione dei problemi dei log NGINX mostra come lo stato, gli errori upstream, i tempi delle richieste e il logging mirato forniscano indicazioni molto più utili del semplice aggiornare ripetutamente la pagina di login. Applica lo stesso principio a Caddy, Traefik o a un altro proxy.
Se il log del proxy mostra una risposta upstream riuscita, ma il browser non completa il login, controlla reindirizzamenti, cookie, TLS e stato del client. Se il proxy non riesce a connettersi all’upstream, correggi il routing o la disponibilità del servizio. Se è Immich a restituire l’errore, consulta il relativo log del server invece di attribuire la causa al proxy.
Verifica che la correzione regga al riavvio che aveva causato il problema
Dopo aver corretto la causa confermata, ripeti esattamente la procedura che ha attivato il problema: riavvia solo il reverse proxy, attendi il controllo dello stato e accedi tramite il nome host pubblico. Poi apri un contenuto esistente, carica un file di piccole dimensioni e mantieni attiva la sessione abbastanza a lungo da verificare il normale traffico API.
La guida ZimaSpace sui percorsi di accesso remoto controllato definisce il quadro più ampio: il proxy è solo uno dei livelli dell’accesso remoto, quindi DNS, TLS, autenticazione e upstream privato devono essere configurati intenzionalmente e restare monitorabili.
Considerala superata solo quando il login continua a funzionare dopo due riavvii del proxy e la stessa configurazione si avvia senza problemi dopo il riavvio completo dello stack. Ripristina le modifiche recenti al proxy se una nuova regola per header o cookie ha causato il problema. In caso di escalation, allega il diff della configurazione del proxy, lo stato della richiesta, l’errore upstream, l’orario del log del server e l’esito del test diretto rispetto a quello tramite proxy.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



