Inloggen bij Immich mislukt nadat de reverseproxy opnieuw is opgestart

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Als inloggen bij Immich alleen mislukt nadat de reverseproxy opnieuw is gestart, controleer dan eerst of het proxypad is uitgevallen terwijl de Immich-applicatie en het account rechtstreeks nog werken.

Een herstart kan verouderde upstreamadressen, ontbrekende verbinding met een gedeeld netwerk, gewijzigde headers, cookiegedrag of een proxyproces aan het licht brengen dat weer is gestart voordat zijn afhankelijkheden bereikbaar waren. Test hetzelfde account via het lokale Immich-eindpunt en de gebruikelijke openbare hostnaam en onderzoek vervolgens de eerste laag waarop de twee paden uiteenlopen.

Gebruik rechtstreekse toegang om authenticatieproblemen te onderscheiden van proxyproblemen

Test een bekend account via een vertrouwde lokale route die de reverseproxy omzeilt om in te loggen op de Immich-server. Als rechtstreeks inloggen lukt, maar de openbare hostnaam blijft laden, omleidt of een upstream-fout teruggeeft, zijn het gebruikersrecord en het centrale authenticatiepad waarschijnlijk in orde. Richt het onderzoek op de proxy, TLS, routering en browserstatus.

Een praktijkgeval uit de community waarin rechtstreekse toegang werkte, maar inloggen via de proxy niet laat deze isolatiemethode zien. Het rapport geldt voor een specifieke versie, dus gebruik het als reden om de paden te vergelijken en ga er niet van uit dat de hoofdoorzaak hetzelfde is.

Stop met het wijzigen van proxyinstellingen als zowel rechtstreeks inloggen als inloggen via de proxy mislukt. Controleer in plaats daarvan de status van de Immich-service, de databaseverbinding, de accountstatus en de serverlogboeken. Een proxyherstart rond het moment van de storing kan toeval zijn; met de omleidingstest voorkom je dat je op basis van die timing een ongefundeerde diagnose stelt.

Controleer of de proxy de huidige Immich-upstream kan bereiken

Controleer na het herstarten van de proxy of deze vanuit zijn eigen netwerknaamruimte de Immich-upstream kan vinden en ermee kan verbinden. In Docker is een upstream met servicenaam op een gedeeld, door de gebruiker gedefinieerd netwerk doorgaans stabieler dan een handmatig gekopieerd container-IP-adres dat verandert wanneer een container opnieuw wordt aangemaakt.

Een discussie over een storing in een reverseproxy rond de verbinding tussen de proxy en Immich laat zien waarom je eerst de bereikbaarheid van de upstream en proxyondersteuning voor WebSockets moet controleren voordat je accountherstel probeert. Beschouw de exacte configuratie als een anekdotisch voorbeeld, niet als een sjabloon voor elke proxy.

Herstart de proxy zelf tweemaal en controleer of de upstream elke keer naar dezelfde service verwijst. De test slaagt als de verbinding direct tot stand komt zonder adressen te wijzigen. Als naamomzetting, netwerkverbindingen of de doelpoort na het opnieuw aanmaken veranderen, herstel dan de Compose-netwerkdefinitie in plaats van de stack steeds opnieuw te herstarten.

Controleer doorgestuurde headers, TLS en cookiegedrag

Inloggen kan mislukken, zelfs wanneer de proxy de Immich-pagina terugstuurt, omdat authenticatie afhankelijk is van het volledige HTTP-pad. Vergelijk de proxyconfiguratie vรณรณr en na de herstart, inclusief het doorsturen van host en schema, HTTPS-beรซindiging, omleidingen, eventuele cookieherschrijvingen en of een tweede proxy of tunnel het antwoord ook wijzigt.

In een communitydiscussie over Immich wordt een aanmeldprobleem door dubbele cookies beschreven, waarbij de cookieafhandeling van de proxy ervoor zorgde dat het aanmelden bleef hangen. Dit is een specifiek geval, maar het herinnert eraan de browserrespons en cookies te controleren in plaats van aan te nemen dat geldige inloggegevens een geslaagde sessie via de proxy garanderen.

Verwijder niet alle accounts en reset de database niet omdat een browsersessie vast lijkt te zitten. Gebruik een privรฉvenster of een tweede browser nadat je de oorspronkelijke cookies en respons hebt vastgelegd. Als een schone client wel werkt, wis dan alleen de status van de betreffende site en corrigeer de proxyregel die de ongeldige cookie of omleiding heeft veroorzaakt.

Single board computer zimaboard2

Lees de toegangs- en foutlogboeken van de proxy rond het tijdstip van de mislukte aanvraag

Reproduceer รฉรฉn aanmeldpoging en noteer het exacte tijdstip, de openbare hostnaam, de client en de geretourneerde status. Controleer vervolgens de toegangs- en foutlogboeken van de proxy rond die aanvraag. Maak onderscheid tussen een aanvraag die de proxy nooit heeft bereikt, een door de proxy gegenereerde 4xx- of 5xx-status, een upstream-verbindingsfout en een aanvraag die Immich heeft bereikt maar waarop de applicatie heeft gereageerd.

De NGINX-workflow voor het oplossen van problemen met logboeken laat zien hoe status, upstream-fouten, aanvraagtijdstippen en gerichte logboekregistratie veel meer inzicht bieden dan het aanmeldingsscherm steeds opnieuw laden. Pas hetzelfde principe toe op Caddy, Traefik of een andere proxy.

Als het proxylogboek een geslaagde upstream-respons toont terwijl de browser de aanmelding niet voltooit, controleer dan omleidingen, cookies, TLS en de clientstatus. Als de proxy geen verbinding kan maken met de upstream, herstel dan de routering of zorg dat de service gereed is. Als Immich zelf de fout retourneert, volg dan het bijbehorende serverlogboek in plaats van de proxy als oorzaak aan te wijzen.

Bewijs dat de oplossing de herstart doorstaat die de storing oorspronkelijk veroorzaakte

Herhaal na het corrigeren van de bevestigde oorzaak exact de handeling die de storing veroorzaakte: herstart alleen de reverse proxy, wacht tot de statuscontrole is geslaagd en meld je aan via de openbare hostnaam. Open vervolgens een bestaand bestand, upload een klein bestand en houd de sessie lang genoeg actief om normaal API-verkeer te controleren.

De ZimaSpace-gids voor gecontroleerde externe toegangspaden biedt een bredere afbakening: de proxy is slechts รฉรฉn laag van externe toegang, dus DNS, TLS, authenticatie en de private upstream moeten bewust worden ingesteld en controleerbaar blijven.

Laat de test alleen slagen als de aanmelding na twee proxyherstarts behouden blijft en dezelfde configuratie na een volledige stackherstart zonder problemen opstart. Draai recente proxywijzigingen terug als een nieuwe header- of cookieregel de storing heeft veroorzaakt. Escaleer met het verschil in de proxyconfiguratie, de aanvraagstatus, de upstream-fout, het tijdstempel van het serverlogboek en het resultaat van de directe test versus de test via de proxy.

Ondersteuning en tips

Meer om te lezen

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.