라우터 변경 후 Home Assistant가 로컬에서는 열리지만 원격에서는 작동하지 않음

라우터를 변경한 후에도 로컬 네트워크에서 Home Assistant가 계속 열리면 Core와 기본 LAN 경로는 정상일 가능성이 높습니다. 문제는 새 라우터의 주소 할당, NAT 규칙, 공인 IP, DNS 레코드, VPN 또는 터널 경로, 리버스 프록시 경로에 있을 가능성이 큽니다.

원격 접속만 실패한다고 Home Assistant를 재설치하지 마세요. 먼저 로컬 주소를 확인한 다음, 한 번에 하나의 경계씩 바깥으로 이동하며 새 네트워크가 기존 원격 접속 설계와 더 이상 일치하지 않는 첫 지점을 찾으세요.

새 라우터가 Home Assistant의 LAN 주소를 변경하지 않았는지 확인하기

새 라우터는 다른 서브넷을 사용하거나 Home Assistant에 다른 DHCP 임대 주소를 할당할 수 있습니다. 따라서 기존 라우터에서 복사한 포트 포워딩 규칙이 더 이상 Home Assistant 호스트에 속하지 않는 주소를 가리킬 수 있습니다.

새 라우터의 클라이언트 목록이나 Home Assistant 네트워크 설정에서 현재 주소를 확인한 다음, LAN에 연결된 기기에서 해당 주소를 직접 열어 보세요. 로컬 접속이 된다면 NAT 또는 리버스 프록시 라우팅을 위해 고정된 내부 대상을 사용해야 하는 경우 DHCP 예약을 설정하세요.

라우터를 교체한 후 첫 번째 경계를 확인하려면 ZimaSpace의 LAN IP 변경과 공인 IP 및 DNS 변경을 구분하는 방법 가이드를 참고하세요.

새 라우터에 맞게 원격 접속 경로 다시 구성하기

직접 포트 포워딩을 사용한다면 새 라우터에서 규칙을 다시 만들고, 대상이 현재 Home Assistant LAN 주소와 수신 대기 포트로 설정되어 있는지 확인하세요. VPN이나 아웃바운드 터널을 사용한다면 커넥터가 온라인 상태인지, 새 라우터가 필요한 아웃바운드 또는 반환 경로를 차단하고 있지 않은지 확인하세요.

Home Assistant의 원격 접속 안내에서는 Home Assistant Cloud, VPN, 리버스 프록시, 포트 포워딩 경로를 구분합니다. 라우터 교체가 각 방식에 미치는 영향은 다르므로, 실제로 사용하는 방식을 기준으로 문제를 해결하세요. VPN 기반 설정에 기존 NAT 규칙을 그대로 복사하지 마세요.

셀룰러 데이터나 실제 외부 네트워크에서 테스트하세요. 동일한 LAN 내부에서 공인 호스트 이름으로 테스트하면 NAT 루프백이나 분할 DNS 동작 때문에 결과가 혼동될 수 있습니다.

공인 IP 또는 CGNAT 환경이 변경되었는지 확인하기

새 라우터 설치는 WAN 임대 갱신, 모뎀 재부팅 또는 ISP 프로비저닝 변경과 함께 이루어지는 경우가 많습니다. 공인 IPv4가 변경되었는데 동적 DNS가 업데이트되지 않았다면 호스트 이름이 여전히 이전 연결을 가리킬 수 있습니다.

라우터에 표시된 WAN 주소와 인터넷에서 확인되는 공인 주소를 비교하세요. 라우터가 공인 IPv4가 아닌 사설 주소나 공유 통신사 주소를 받는다면 ISP의 CGNAT가 상위에 있기 때문에 직접 인바운드 포트 포워딩이 더 이상 작동하지 않을 수 있습니다.

새 라우터가 공인 NAT 경계를 담당하지 않는다면 Home Assistant 설정을 계속 수정하지 마세요. 대신 Home Assistant Cloud, 메시 VPN, 리버스 터널을 사용하거나 ISP에 공인 IP를 요청하세요.

Featured

ZimaCube 2 개인용 클라우드 홈 NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

DNS와 Home Assistant 외부 URL을 별도로 확인하기

원격 접속에 사용하는 정확한 호스트 이름을 조회하여 현재 의도한 공인 주소나 터널 주소를 반환하는지 확인하세요. 그런 다음 가능한 경우 대상에 직접 접속해 테스트하세요. DNS가 정상이라고 해서 프록시나 포트가 올바르다는 뜻은 아니며, 포트가 작동한다고 해서 호스트 이름이 올바르게 확인된다는 뜻도 아닙니다.

Companion 앱은 서로 다른 내부 및 외부 경로를 사용할 수 있습니다. 현재 네트워크 문서에서는 내부 URL, 외부 URL, DNS, IPv4/IPv6, 리버스 프록시 동작을 다룹니다. 기존 네트워크가 우연히 설정과 일치하는 동안에는 드러나지 않던 오래된 설정이 라우터 변경으로 노출될 수 있습니다.

앱은 실패하지만 셀룰러 환경의 브라우저에서는 작동한다면 서버를 건드리기 전에 앱이 사용하는 URL과 네트워크 프로필을 비교하세요.

프록시 경로가 변경된 경우에만 리버스 프록시 신뢰 설정을 다시 확인하기

새 라우터는 Docker 서브넷, 프록시 주소 또는 TLS를 종료하는 시스템을 변경할 수도 있습니다. 이제 요청이 다른 리버스 프록시를 통해 들어온다면 새 프록시를 신뢰하도록 설정할 때까지 Home Assistant가 전달된 헤더를 거부할 수 있습니다.

HTTP 통합은 X-Forwarded 헤더를 보내는 기존 리버스 프록시에 대한 신뢰할 수 있는 프록시 설정을 요구합니다. 오류를 없애기 위해 신뢰할 네트워크를 전체 LAN으로 넓히지 마세요. 실제 프록시의 출처만 신뢰하도록 설정하세요.

이제 문제는 잘못된 LAN 대상, 누락된 NAT 또는 터널 경로, 변경된 공인 주소, CGNAT, 오래된 DNS 또는 프록시 신뢰 설정 중 하나의 계층에 해당해야 합니다.

FAQ

라우터를 변경했다는 이유만으로 새 TLS 인증서가 필요한가요?

대개는 필요하지 않습니다. 동일한 호스트 이름에 대한 인증서는 라우터 변경만으로 무효화되지 않습니다. 인증서 문제는 호스트 이름, 챌린지 경로, 프록시, DNS 또는 TLS 종료 지점이 변경되었을 때 발생합니다.

모바일 데이터에서는 원격 URL이 작동하지만 집 Wi-Fi에서는 왜 실패하나요?

이는 일반적인 원격 접속 장애가 아니라 헤어핀 NAT나 분할 DNS 같은 내부 전용 라우팅 또는 DNS 문제를 가리킵니다. 내부 DNS 응답과 프록시 경로를 별도로 테스트하세요.