Home Assistant가 IP 주소로는 서비스에 연결할 수 있지만 호스트 이름으로는 연결하지 못하거나, 오류에 이름 확인 또는 DNS 시간 초과가 명시적으로 언급되거나, 서로 다른 네트워크에서 같은 호스트 이름이 다르게 동작한다면 DNS가 유력한 원인일 수 있습니다. 단순한 “연결 실패” 메시지만으로는 입증되지 않습니다.
실제로 실패하는 시스템과 네트워크 경로에서 DNS를 테스트하세요. 노트북에서 호스트 이름이 정상적으로 확인된다고 해서 Home Assistant 호스트, 컨테이너, 모바일 앱 또는 로컬 리졸버에서도 같은 결과를 본다는 의미는 아닙니다.
오류에 표시된 정확한 호스트 이름으로 시작하기
Home Assistant 로그 또는 Companion 오류를 확인하고 통합 이름이 아닌 정확한 호스트 이름을 기록하세요. 연결 거부, TLS 오류, 시간 초과 및 DNS 조회 실패는 서로 다른 계층의 문제입니다.
Home Assistant의 현재 연결 안내에 따르면 라우터, DNS, DHCP, 연결할 수 없는 장치 및 사용할 수 없는 서비스가 연결 오류의 일반적인 원인입니다. 로그의 표현을 바탕으로 다음에 테스트할 분기를 좁혀야 합니다.
오류에 이미 “이름 또는 서비스를 알 수 없음”, “이름 확인 중 일시적인 오류” 또는 DNS 시간 초과가 표시된다면 바로 리졸버 테스트로 넘어가세요. “연결 거부”라고 표시된다면 DNS는 이미 성공했을 수 있으므로 원격 서비스나 포트를 우선 의심하는 것이 좋습니다.
영향을 받는 Home Assistant 경로에서 DNS 테스트 실행하기
Home Assistant 호스트, 컨테이너 또는 동일한 리졸버를 사용하는 다른 시스템에서 dig 또는 nslookup을 사용하세요. 반환된 주소가 해당 호스트 이름이 가리켜야 하는 대상과 일치하는지 비교합니다.
Companion 문제 해결 가이드에서는 Home Assistant가 호스트 이름 조회 중 시간 초과를 보고할 때 dig 및 nslookup을 사용하도록 권장합니다. 영향을 받는 컴퓨터에서 조회가 실패했다는 것은 다른 클라이언트에서 조회가 성공했다는 것보다 훨씬 강력한 근거입니다.
문제가 간헐적으로 발생한다면 테스트를 여러 번 반복하세요. 한 번은 성공하지만 열 번에 한 번씩 시간 초과가 발생하는 리졸버도 통합 기능을 불안정하게 만들 수 있습니다.
호스트 이름 연결과 직접 IP 연결 비교하기
서비스에 적합하고 안전하다면 알려진 IP 주소로 대상에 연결해 보세요. IP 경로는 반복적으로 작동하지만 호스트 이름 경로가 실패한다면 DNS 또는 호스트 이름별 라우팅에 문제가 있을 가능성이 있습니다.
HTTPS 또는 가상 호스트 기반 서비스에서는 이를 절대적인 증거로 간주하지 마세요. 기본 IP에 연결할 수 있더라도 TLS 인증서, 리버스 프록시 및 Host 헤더에는 호스트 이름이 필요할 수 있습니다.
ZimaSpace의 셀프 호스팅 애플리케이션의 간헐적인 DNS 오류 가이드에서는 이 테스트를 확장하여 리졸버 지연, 오래된 응답, 분할 DNS 및 컨테이너별 리졸버 경로를 구분합니다.
A 및 AAAA 응답 모두 확인하기
호스트 이름이 정상적으로 확인되더라도 사용할 수 없는 주소 체계를 선택할 수 있습니다. 예를 들어 AAAA 레코드는 있지만 IPv6 라우팅이 작동하지 않으면 IPv4로 전환되기 전에 오랫동안 대기할 수 있습니다.
Home Assistant의 DNS 진단에서는 DNS 서버 오류와 A 및 AAAA 요청의 잘못된 처리를 명시적으로 지적합니다. Home Assistant OS에서는 동일한 진단 기능을 통해 리졸버 상태와 대체 DNS 옵션도 확인할 수 있습니다.
A 및 AAAA 결과를 각각 비교한 다음, 반환된 주소 체계를 통해 연결을 테스트하세요. 호스트 이름 하나에 문제가 있다는 이유만으로 IPv6을 전체적으로 비활성화하지 말고, 먼저 실패하는 경로를 확인하세요.
위치에 따라 실패가 달라질 때 내부 DNS와 외부 DNS 비교하기
Home Assistant 호스트 이름이 모바일 데이터에서는 작동하지만 가정용 Wi-Fi에서는 작동하지 않거나, LAN 내부에서는 작동하지만 원격에서는 작동하지 않는다면 두 위치에서 DNS 응답을 비교하세요. 분할 DNS는 내부에서는 사설 주소를, 외부에서는 공용 주소 또는 터널 주소를 의도적으로 반환할 수 있습니다.
라우터의 DNS 재정의, Pi-hole 또는 AdGuard 재작성, mDNS 이름, 로컬 검색 도메인, 공용 DNS 레코드 및 오래된 캐시를 확인하세요. 올바른 공용 레코드가 잘못된 내부 재정의를 해결해 주지는 않으며, 올바른 LAN 레코드가 사설 주소를 인터넷에서 연결 가능하게 만들어 주지도 않습니다.
한 번에 하나의 리졸버 변수만 변경하세요. 임시 공용 리졸버는 공용 이름을 진단하는 데 유용할 수 있지만, 해당 호스트 이름이 사설 로컬 서비스로 확인되어야 한다면 공용 DNS를 고정하는 것은 해결책이 아닙니다.
FAQ
Home Assistant가 IP로는 작동하지만 호스트 이름으로는 작동하지 않는다면 DNS가 확실한 원인인가요?
강력한 근거이지만 절대적인 증거는 아닙니다. 호스트 이름을 우회하면 HTTPS 인증서, 리버스 프록시, 가상 호스트 및 라우팅 규칙이 다르게 작동할 수 있습니다. DNS 응답과 애플리케이션 경로를 함께 확인하세요.
Home Assistant를 8.8.8.8 또는 1.1.1.1로 영구적으로 변경해야 하나요?
자동으로 변경해서는 안 됩니다. 공용 리졸버는 공용 이름을 테스트하는 데 유용하지만, 사설 분할 DNS 레코드가 다른 곳에 의도적으로 게시되어 있지 않다면 해당 레코드를 확인할 수 없습니다. 문제가 발생한 이름에 대해 권한을 가져야 하는 리졸버를 수정하세요.
지원 및 팁
더 읽어보기

Home Assistant 데이터베이스에 유지 관리 또는 교체가 필요한 징후
대규모 Home Assistant 데이터베이스에는 일반적으로 보존 기간 관리 또는 정리 작업이 필요하지만, 반복되는 손상이나 무결성 오류는 교체를 고려해야 한다는 더 강력한 신호입니다.

Home Assistant는 느려지기 전에 동시에 몇 명의 사용자를 처리할 수 있나요?
Home Assistant에는 고정된 유용한 사용자 한도가 없습니다. 실제 대시보드와 엔터티 업데이트로 활성 클라이언트를 벤치마크한 다음, 반복적으로 지연 시간이 나타나기 전에 중단하세요.

Home Assistant는 업그레이드를 중단하지 않고 외부 데이터베이스를 사용할 수 있나요?
외부 Recorder 데이터베이스는 업그레이드 후에도 유지될 수 있지만, 자체적인 가용성, 스키마 마이그레이션, 백업, 복원 및 버전 관리 책임이 추가됩니다.

