프록시 또는 DNS 변경 후 Home Assistant에서 세션이 끊기는 이유는 무엇인가요?

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

프록시 또는 DNS 변경 후 세션이 끊기는 경우는 대개 클라이언트가 사용하는 URL 출처와 현재 Home Assistant가 인식하는 경로가 일치하지 않기 때문이지, 사용자 계정이 손상되었기 때문은 아닙니다.

브라우저에는 이전 호스트 이름의 쿠키와 프런트엔드 상태가 남아 있는 반면 휴대폰에서는 새 주소가 확인될 수 있습니다. 또는 프록시가 로그인 페이지는 제공하지만 인증된 WebSocket 연결에 실패할 수도 있습니다. 시크릿 브라우저 창 하나와 직접 LAN 연결 테스트 하나로 시작하고, 각 결과의 정확한 스킴과 호스트 이름을 기록한 뒤 실패한 계층을 파악하기 전에는 모든 세션을 삭제하지 마세요.

한 클라이언트의 상태 문제와 공유 경로 장애 구분하기

최종적으로 사용할 URL로 시크릿 창에서 Home Assistant를 열고, 문제가 발생한 브라우저 및 모바일 앱과 비교하세요. 로그인이 완료되는지, 대시보드가 5분 동안 연결 상태를 유지하는지, 페이지를 새로 고쳐도 세션이 유지되는지 기록하세요. 이 되돌릴 수 있는 비교를 통해 서버를 변경하지 않고 오래된 클라이언트 상태를 검사할 수 있습니다.

프록시가 로그인 페이지를 반환하더라도 인증된 프런트엔드에서 나중에 연결할 수 없다고 표시될 수 있습니다. 이러한 로그인 성공 후 연결 실패는 HTML이 렌더링된다고 해서 전체 세션 경로가 작동한다는 뜻은 아님을 보여 줍니다.

이전 브라우저에서만 실패하고 시크릿 창에서는 안정적으로 작동한다면, 해당 클라이언트에서 이전 및 새 Home Assistant 출처의 사이트 데이터를 삭제한 다음 다시 로그인하세요. 프록시 URL에서 모든 클라이언트가 실패하지만 직접 LAN 접속은 작동한다면, 클라이언트 상태는 그대로 두고 프록시 경로를 확인하세요.

WebSocket 및 Forwarded-Origin 처리 확인

로그인 중 브라우저 네트워크 보기 또는 프록시 로그를 확인하고 WebSocket 업그레이드, 상태, 연결 해제 시점, 전달된 스킴, 전달된 호스트, 클라이언트 주소를 살펴보세요. 중요한 구분은 HTTP 페이지가 로드되는지와 인증된 연결이 업그레이드되어 열린 상태로 유지되는지입니다.

Home Assistant 리버스 프록시 문제를 해결할 때 일반 HTTP 프록시와 별개의 요구 사항으로 WebSocket 전달이 반복해서 언급됩니다. 이 메커니즘은 업그레이드 경로를 파악하는 용도로만 사용하고, 특정 Nginx 설정이 모든 프록시에 적합하다는 증거로 여기지 마세요.

업그레이드에 실패하면 로그에서 잘못된 것으로 확인된 프록시 경로, 업그레이드 헤더, 전달된 스킴 또는 신뢰할 수 있는 프록시 경계만 수정하세요. 업그레이드가 성공하고 연결이 유지되면 프록시는 그대로 두고 DNS와 클라이언트 원본 상태를 조사하세요.

DNS 응답 및 최종 URL 비교

실패하는 클라이언트, 정상 작동하는 클라이언트, 프록시 호스트에서 Home Assistant 호스트 이름을 확인하세요. IPv4, IPv6, 분할 DNS 응답, 인증서 이름, 리디렉션 대상, 컴패니언 앱에 저장된 URL을 비교하세요. 클라이언트가 동일한 표준 호스트 이름을 통해 의도한 엔드포인트에 도달해야 DNS 변경이 완료된 것입니다.

검색, 이름 확인, 라우팅 간의 전반적인 관계는 Home Assistant 연결성 모델에 정리되어 있습니다. 이를 활용해 오래된 DNS 응답과 세션 계층 오류를 구분하세요.

클라이언트마다 서로 다른 엔드포인트로 연결된다면 문서화된 TTL만큼 기다리거나 영향을 받은 클라이언트와 로컬 리졸버의 캐시만 지우세요. 임시 호스트 이름을 여러 개 만들지 마세요. 새 원본이 추가될 때마다 쿠키와 리디렉션 경계가 하나씩 더 생깁니다.

원래 세션 경로 재테스트 및 범위를 좁혀 상위 지원팀에 전달

최종 공개 URL 또는 비공개 URL로 로그인하고 대시보드를 계속 열어 둔 다음, 중첩된 뷰를 새로고침하세요. 원격 액세스가 설계에 포함되어 있다면 네트워크를 한 번 전환하고, 클라이언트를 한 번 재시작한 후 다시 테스트하세요. 동일한 표준 URL, 안정적인 WebSocket, 그리고 원래 문제가 발생한 상황에서도 세션이 유지되어야 통과입니다.

클린 클라이언트는 통과하지만 기존 클라이언트 하나에서 계속 실패하면 해당 클라이언트 프로필이나 앱 연결만 복구하세요. 모든 프록시 클라이언트에서 동일한 업그레이드 또는 리디렉션 증거와 함께 실패한다면, 다른 변경을 시도하기 전에 마지막 프록시 또는 DNS 변경을 롤백하고 로그를 보존하세요.

실패하는 정확한 URL 유형, DNS 응답, 프록시 상태 코드, WebSocket 결과, 타임스탬프, 클라이언트 비교 결과를 포함해 상위 지원팀에 전달하세요. 서로 다른 클라이언트 두 대에서 새로고침과 재연결 후에도 세션이 유지되면 중단하세요. 이후 쿠키나 프록시를 추가로 변경해도 진단에 도움이 되지 않고 위험만 커집니다.

지원 및 팁

더 읽어보기

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.