Porque é que o início de sessão no Home Assistant falha após reiniciar um 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 não conseguir iniciar sessão no Home Assistant apenas após reiniciar um proxy inverso, teste primeiro o início de sessão direto na LAN e mantenha a base de dados de utilizadores inalterada até isolar o problema no percurso pelo proxy.

Um reinício do proxy pode alterar o endereço do contentor, as informações encaminhadas sobre o cliente, o tratamento de WebSocket, o destino DNS ou o backend upstream sem alterar qualquer palavra-passe do Home Assistant. Por isso, eliminar contas e repor todas as sessões não são boas primeiras medidas. Compare o URL direto do Home Assistant com o nome de anfitrião normalmente utilizado através do proxy, guarde os erros do navegador e do proxy e determine se a falha ocorre antes da autenticação, durante o pedido de início de sessão ou quando o frontend abre a ligação persistente.

Comece por separar a autenticação do Home Assistant do percurso pelo proxy

Use a mesma conta válida tanto no endereço local direto do Home Assistant como através do nome de anfitrião público ou interno do proxy. Se o início de sessão direto funcionar, mas o percurso pelo proxy falhar, é provável que a conta e o estado de autenticação do Core estejam suficientemente saudáveis para não lhes mexer. Se ambos os percursos falharem, retome a investigação no Home Assistant, no estado restaurado ou nas próprias credenciais.

Num caso de início de sessão através de um proxy inverso, o comportamento direto diferia do percurso pelo Apache até serem corrigidos os detalhes de WebSocket e do proxy. Este tipo de comparação entre o acesso direto e o acesso através do proxy é mais útil para diagnosticar o problema do que alterar repetidamente as palavras-passe.

Registe o código de estado HTTP, a cadeia de redirecionamento, o erro na consola do navegador, a resposta do upstream do proxy e a marca temporal correspondente no registo do Home Assistant antes de alterar a configuração. Um erro 400 causado por um proxy não fidedigno, uma falha de WebSocket, um redirecionamento para o esquema errado e uma palavra-passe inválida são falhas diferentes, mesmo que o ecrã apresente a mesma mensagem genérica de impossibilidade de ligação.

As quatro causas do lado do proxy deixam sinais distintos

As causas mais comuns são a alteração do endereço de origem do proxy, que deixa de corresponder à regra de proxy fidedigno, mudanças nos cabeçalhos encaminhados ou no esquema, falhas no tratamento da atualização de WebSocket e encaminhamento para o backend errado do Home Assistant. A recriação de um contentor de proxy pode alterar um destes elementos, enquanto a instância do Home Assistant permanece estável.

Um caso recente de resolução de problemas com proxy inverso mostra o Home Assistant a rejeitar tráfego encaminhado até o proxy imediato ser incluído no intervalo de confiança correto. Essa verificação da identidade do proxy de confiança é mais segura do que alargar permanentemente o intervalo: verifique que endereço de proxy chega efetivamente ao Home Assistant e confie apenas nesse limite.

Use os sinais abaixo e altere um ramo de cada vez. Não mantenha um intervalo amplo de proxies de confiança após os testes; isso elimina uma proteção importante contra a falsificação de endereços encaminhados de clientes.

Causa 1: O reinício alterou o endereço de origem do proxy

  • Sinal: os pedidos são rejeitados de imediato e os registos do Home Assistant identificam um proxy inverso não fidedigno.
  • Verifique: compare a sub-rede/o endereço do contentor do proxy com o intervalo de confiança configurado.
  • SE-ENTÃO: se restaurar o intervalo de confiança restrito correto resolver o início de sessão, mantenha inalterados a conta e o estado da sessão.

Causa 2: O anfitrião ou esquema encaminhado deixou de corresponder à origem pública

  • Sinal: os redirecionamentos alternam entre HTTP/HTTPS ou nomes de anfitrião alternativos, ou os cookies parecem estar associados a uma origem inesperada.
  • Verifique: compare o anfitrião e o esquema encaminhados antes e depois do reinício.
  • SE-ENTÃO: se corrigir esses valores resolver o ciclo de redirecionamento/início de sessão, a falha deveu-se à identidade de entrada e não aos utilizadores do Home Assistant.

Causa 3: A página de início de sessão carrega, mas a atualização WebSocket falha

  • Sinal: a interface estática carrega, mas depois a interface frontal desliga-se ou não consegue concluir a inicialização.
  • Verifique: inspecione o pedido WebSocket do navegador e os cabeçalhos de atualização do proxy.
  • SE-ENTÃO: se o acesso direto mantiver a ligação WebSocket aberta e o nome do anfitrião não, mantenha-se na camada do proxy.

Causa 4: O proxy aponta para outro servidor de origem ou para um servidor acabado de configurar

  • Sinal: o servidor parece estar configurado de novo, os utilizadores conhecidos desaparecem ou o estado específico do servidor é diferente através do proxy.
  • Verifique: compare o endereço do servidor de origem, a identidade da instância e o caminho de configuração.
  • SE-ENTÃO: se o proxy encaminhar para o contentor ou instância restaurada errados, corrija o encaminhamento antes de alterar os dados de autenticação.

Use o comportamento do WebSocket para evitar classificar erradamente uma falha do frontend como uma falha de início de sessão

O frontend do Home Assistant depende de uma ligação WebSocket persistente após a troca HTTP inicial. Por isso, um proxy pode apresentar a página de início de sessão com sucesso, mas falhar momentos depois, quando a ligação é atualizada ou se mantém aberta. Os utilizadores descrevem muitas vezes essa sequência como uma falha de início de sessão, por ocorrer imediatamente após o envio das credenciais.

Uma configuração de proxy inverso do Home Assistant na Synology chegou à página de início de sessão, mas continuou a falhar até ser corrigido o tratamento da atualização de WebSocket. Verificar o comportamento da atualização de WebSocket através do proxy evita perder tempo a repor utilizadores quando o percurso de início de sessão HTTP já está a funcionar corretamente.

Se a ligação falhar, valide o tratamento da atualização para HTTP/1.1, os tempos limite, a terminação TLS, o nome de anfitrião e qualquer middleware de CDN ou autenticação à frente do proxy. Mantenha as alterações limitadas. Não adicione cabeçalhos sem relação com o problema, copiados de outra configuração de proxy, a menos que o pedido que falhou demonstre a sua necessidade.

Valide a correção com dois reinícios do proxy e um cliente limpo

Depois de aplicar a correção correspondente, inicie e termine sessão através do nome de anfitrião habitual, abra um painel durante tempo suficiente para confirmar que a ligação WebSocket se mantém estável e repita o teste numa janela de navegação privada ou noutro cliente. Em seguida, reinicie o proxy duas vezes e reinicie o anfitrião do proxy se o endereço do contentor ou a rede fizerem parte da causa suspeita.

A comparação da ZimaSpace entre os percursos do Home Assistant na rede local e remotamente aplica o mesmo princípio de isolamento: manter o percurso saudável da aplicação local enquanto se testam as camadas adicionais de DNS, TLS, proxy e encaminhamento usadas remotamente.

Considere a verificação aprovada quando tanto o acesso direto como o acesso através do proxy chegarem à mesma instância do Home Assistant, o endereço restrito esperado do proxy for considerado de confiança, os redirecionamentos mantiverem o esquema e o anfitrião pretendidos, a ligação WebSocket se mantiver estável durante a utilização normal e um reinício do proxy não alterar o resultado. Só encaminhe o caso para a autenticação do Home Assistant se a mesma conta comprovadamente válida também falhar no acesso direto.

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.