O início de sessão no Immich falha após o reinício do proxy inverso

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Se o início de sessão no Immich só falhar depois de reiniciar o proxy inverso, comece por confirmar se o percurso através do proxy falhou, apesar de a aplicação Immich e a conta continuarem a funcionar por acesso direto.

Um reinício pode revelar endereços desatualizados do serviço a montante, falta de pertença à rede partilhada, alterações nos cabeçalhos, comportamento dos cookies ou um processo de proxy que voltou a funcionar antes de as dependências estarem acessíveis. Teste a mesma conta através do ponto final local do Immich e do nome de anfitrião público habitual e, depois, siga a primeira camada em que os dois percursos divergem.

Use o acesso direto para distinguir problemas de autenticação de falhas do proxy

Teste uma conta conhecida no servidor Immich através de uma rota local fidedigna que contorne o proxy inverso. Se o início de sessão direto for bem-sucedido, mas o nome de anfitrião público ficar a carregar, redirecionar ou devolver um erro do serviço a montante, é provável que o registo do utilizador e o percurso de autenticação principal estejam intactos. Continue a investigação no proxy, no TLS, no encaminhamento e no estado do navegador.

Um caso da comunidade em que o acesso direto funcionava, mas o início de sessão através do proxy falhava ilustra este método de isolamento. O relato é específico de uma versão, por isso use-o para justificar a comparação entre percursos, em vez de presumir que a causa de fundo é a mesma.

Se o início de sessão falhar tanto diretamente como através do proxy, pare de alterar as definições do proxy. Verifique antes o estado do serviço Immich, a conectividade da base de dados, o estado da conta e os registos do servidor. O reinício do proxy ter ocorrido perto da falha pode ser uma coincidência; o teste de acesso direto evita que essa coincidência seja transformada num diagnóstico sem fundamento.

Verifique se o proxy consegue aceder ao serviço Immich atual a montante

Depois de reiniciar o proxy, confirme que este consegue resolver e estabelecer ligação ao serviço Immich a montante a partir do seu próprio espaço de nomes de rede. No Docker, um serviço a montante identificado pelo nome do serviço numa rede partilhada definida pelo utilizador é, regra geral, mais estável do que um endereço IP de contentor copiado manualmente, que muda quando o contentor é recriado.

Uma discussão sobre uma falha do proxy envolvendo a conectividade entre o proxy e o Immich mostra por que motivo se deve verificar a acessibilidade do serviço a montante e o suporte de WebSockets no proxy antes de tentar recuperar a conta. Considere a configuração exata como um caso isolado, não como um modelo para todos os proxies.

Reinicie apenas o proxy duas vezes e verifique se, de cada vez, consegue resolver o mesmo serviço a montante. O teste é bem-sucedido se a ligação for estabelecida imediatamente, sem alterar endereços. Se a resolução de nomes, a pertença à rede ou a porta de destino mudar após a recriação, corrija a definição da rede no Compose, em vez de reiniciar repetidamente a stack.

Inspecione os cabeçalhos encaminhados, o TLS e o comportamento dos cookies

O início de sessão pode falhar mesmo quando o proxy apresenta a página do Immich, porque a autenticação depende do percurso HTTP completo. Compare a configuração do proxy antes e depois do reinício, incluindo o encaminhamento do anfitrião e do esquema, a terminação HTTPS, os redirecionamentos, eventuais alterações aos cookies e se um segundo proxy ou túnel também está a modificar a resposta.

Uma discussão da comunidade Immich documenta um caso de início de sessão com cookies duplicados em que o tratamento dos cookies pelo proxy provocou um bloqueio durante o início de sessão. Trata-se de um caso específico, mas é um lembrete útil para inspecionar a resposta do browser e os cookies, em vez de presumir que credenciais válidas garantem uma sessão através do proxy bem-sucedida.

Não elimine todas as contas nem reinicie a base de dados só porque a sessão do browser parece bloqueada. Depois de registar os cookies e a resposta originais, use uma janela privada ou um segundo browser. Se um cliente sem dados anteriores funcionar, limpe apenas os dados do site afetado e corrija a regra do proxy que criou o cookie ou redirecionamento inválido.

Consulte os registos de acesso e de erros do proxy relativos à hora do pedido falhado

Reproduza uma tentativa de início de sessão e registe a hora exata, o nome de anfitrião público, o cliente e o estado devolvido. Em seguida, consulte os registos de acesso e de erros do proxy relativos a esse pedido. Distinga um pedido que nunca chegou ao proxy, um erro 4xx ou 5xx gerado pelo proxy, uma falha de ligação ao upstream e um pedido que chegou ao Immich, mas recebeu uma resposta da aplicação.

O fluxo de trabalho de resolução de problemas dos registos do NGINX mostra como o estado, os erros do upstream, a temporização dos pedidos e o registo direcionado fornecem indicações muito mais fiáveis do que atualizar repetidamente a página de início de sessão. Aplique o mesmo princípio ao Caddy, ao Traefik ou a outro proxy.

Se o registo do proxy mostrar uma resposta bem-sucedida do upstream enquanto o browser não consegue concluir o início de sessão, verifique os redirecionamentos, os cookies, o TLS e o estado do cliente. Se o proxy não conseguir ligar-se ao upstream, corrija o encaminhamento ou a prontidão do serviço. Se o próprio Immich devolver o erro, consulte o registo correspondente do servidor em vez de atribuir a causa ao proxy.

Comprove que a correção resiste ao reinício que causou originalmente a falha

Depois de corrigir a causa confirmada, repita o acionador exato: reinicie apenas o proxy inverso, aguarde pela verificação do estado e inicie sessão através do nome de anfitrião público. Em seguida, abra um recurso existente, carregue um ficheiro pequeno e mantenha a sessão ativa durante tempo suficiente para verificar o funcionamento normal da API.

O guia ZimaSpace para percursos de acesso remoto controlado estabelece os limites mais abrangentes: o proxy é apenas uma camada do acesso remoto, pelo que o DNS, o TLS, a autenticação e o upstream privado têm de ser intencionais e observáveis.

Aprovar apenas quando a sessão de início de sessão sobreviver a dois reinícios do proxy e a mesma configuração arrancar sem problemas após um reinício completo de toda a stack. Reverta as alterações recentes ao proxy se uma nova regra de cabeçalho ou cookie tiver causado a falha. Escale o problema com a diferença da configuração do proxy, o estado do pedido, o erro do upstream, a data e hora do registo do servidor e o resultado do teste direto versus através do proxy.

Assistência e dicas

Mais para ler

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.