Home Assistant를 Docker 컨테이너로 돌릴 때, 장치 자동 탐지(특히 Google Home Mini, Chromecast 계열, IoT 장치)가 잘 안 되는 이유는 대개 mDNS/Zeroconf/SSDP 같은 로컬 네트워크 탐지 패킷이 컨테이너 격리 때문에 제대로 보이지 않기 때문입니다. Home Assistant는 mDNS/Zeroconf와 SSDP 기반 탐지를 지원하고, Google Cast 장치는 Home Assistant와 같은 서브넷에 있어야 자동 발견이 가능하며, mDNS 패킷은 서브넷을 넘어서 라우팅되지 않는다고 문서에 명시돼 있습니다.
즉, 핵심은 “컨테이너 네트워크가 무엇이냐”보다 “Home Assistant 프로세스가 실제로 붙어 있는 네트워크가 LAN 장치와 같은 브로드캐스트 도메인이냐”입니다. Docker의 일반 bridge 네트워크는 기본적으로 호스트/LAN과 분리되어 있어서, 로컬 탐지 패킷을 직접 받는 데 불리합니다. 반면 Docker의 host 네트워크는 호스트 네트워크를 그대로 공유하므로, 호스트에서 오가는 패킷을 컨테이너가 직접 보게 됩니다.
“host 모드”를 쓸 때와 안 쓸 때의 차이
host 모드 사용 시
Docker host 네트워크를 쓰면 컨테이너가 호스트 네트워크를 그대로 사용하므로, 로컬 네트워크 탐지에 유리합니다. Docker 공식 문서도 host networking은 호스트와 컨테이너 간 양방향 접근이 가능하고 TCP/UDP를 모두 지원한다고 설명합니다.
이 방식은 Home Assistant처럼 mDNS/SSDP로 장치를 찾는 서비스에는 가장 단순하고 성공률이 높습니다. Home Assistant Cast 문서도 같은 서브넷을 전제로 자동 탐지가 동작한다고 설명하고, 같은 네트워크가 아니면 자동 탐지는 지원되지 않는다고 밝힙니다.
host 모드 없이 bridge 모드만 쓸 때
bridge 모드에서는 컨테이너가 독립 네트워크에 있으므로, LAN 장치 탐지가 잘 안 될 수 있습니다. Docker의 기본 브리지 네트워크는 자동으로 생성되며, 컨테이너는 그 격리된 네트워크에 붙습니다.
이때는 장치 자동 탐지를 기대하기보다, 네트워크 레벨 해결 또는 컨테이너를 LAN에 직접 붙이는 방식으로 우회해야 합니다. Home Assistant 개발 문서에서도 mDNS/Zeroconf와 SSDP가 네트워크 기반 탐지의 핵심이라고 설명합니다.
“다른 컨테이너에서 HA 접근” 문제
Home Assistant를 host 모드로 바꾸면, 다른 컨테이너가 예전처럼 http://homeassistant:8123처럼 컨테이너 이름으로 바로 접근하는 방식은 깨집니다. 대신 호스트 IP를 써야 합니다. Docker host 네트워크는 호스트와 컨테이너가 같은 네트워크를 공유하는 구조이기 때문에, 다른 컨테이너에서는 http://<호스트IP>:8123 형태로 접근하는 게 맞습니다.
- bridge 모드: 컨테이너 이름으로 상호 접근이 쉬움
- host 모드: 컨테이너 이름 기반 DNS는 기대하기 어렵고, 호스트 IP 기반 접근으로 바뀜
그래서 “다른 컨테이너도 문제없나?”에 대한 답은, 문제는 없지만 접근 방식이 바뀐다는 뜻입니다. 즉, 네트워크 구조를 바꾸면 호출 주소도 바뀝니다.
host 모드 없이 가려면 무엇을 써야 하나
macvlan / ipvlan
host 모드 없이도 컨테이너를 LAN에 직접 붙인 것처럼 만들고 싶다면 macvlan 또는 ipvlan이 대표적입니다. Docker 공식 문서는 macvlan이 컨테이너에 MAC 주소를 부여해서 물리 네트워크에 직접 연결된 것처럼 보이게 한다고 설명합니다. 또한 IPvlan은 MAC 주소 사용 제약이 있는 환경에서 고려할 수 있다고 Docker 문서가 안내합니다.
이 방식의 장점
- Home Assistant가 LAN 상에서 독립 IP를 갖게 됨
- host 모드처럼 호스트 전체를 노출하지 않음
- 브리지 네트워크보다 로컬 장치 탐지에 유리함
다만 단점도 있습니다. Docker 문서에 따르면 macvlan은 호스트와 직접 통신이 안 되는 제약이 있습니다. 즉, HA가 LAN에서는 보이지만, 호스트에서 HA로 직접 붙는 경로는 별도로 설계해야 합니다.
mDNS/SSDP 릴레이
만약 장치가 다른 VLAN/서브넷에 있다면, 컨테이너 문제가 아니라 멀티캐스트 중계 문제일 가능성이 큽니다. Home Assistant Cast는 같은 서브넷을 전제로 자동 탐지하고, 서브넷을 넘어가는 mDNS는 자동으로 안 됩니다. 이 경우는 mDNS forwarding이나 SSDP/mDNS relay를 네트워크 장비 또는 호스트에 두는 방식이 필요합니다.
네트워크가 분리되어 있다면
- 같은 VLAN으로 통합하거나
- mDNS reflector/forwarder를 두거나
- known hosts 같은 수동 등록을 쓰는 식으로 해결합니다.
Google Home Mini “로컬화”의 의미와 조건
“구글 홈 미니 스피커 로컬화”를 Home Assistant 관점에서 해석하면, 보통은 클라우드 의존도가 높은 제어를 줄이고, 같은 LAN에서 직접 발견/제어되게 만드는 것을 말합니다. Home Assistant의 Google Cast 통합은 같은 서브넷에서 자동 발견되는 것을 기본으로 하고, mDNS 패킷이 서브넷을 넘지 못하므로 같은 네트워크 조건이 중요합니다.
같은 네트워크가 아니라도 가능한가?
- 자동 탐지는 어렵거나 불가능한 경우가 많습니다. Home Assistant Cast 문서는 다른 서브넷에 대한 자동 발견을 지원하지 않는다고 적고 있습니다.
- 수동 등록이나 mDNS forwarding을 쓰면 우회 가능할 수 있습니다.
지금처럼 HA 호스트가 192.168.0.x 대역이면?
- Google Home Mini도 같은 192.168.0 대역에 있다면, 컨테이너 내부 네트워크가 따로 있더라도 HA가 호스트 네트워크에서 탐지할 수 있으므로 로컬 제어 가능성이 높습니다.
- 반대로 HA가 bridge에 갇혀 있으면 탐지가 막힐 수 있습니다.
즉, “컨테이너 네트워크가 아니라 호스트 네트워크가 192.168.0 대역에 붙어 있다”는 말은 매우 중요합니다. 이 경우에는 Google Home Mini가 같은 서브넷 안에 있기만 하면, HA가 로컬 장치로 다룰 가능성이 높습니다.
운영 관점에서의 권장 구조
제가 이 상황에서 권하는 구조는 다음 순서입니다.
가장 단순한 구조
- Home Assistant는 host 모드 또는 macvlan/ipvlan
- 나머지 애플리케이션 컨테이너는 기존 bridge 유지
- 다른 컨테이너는 HA를 호스트 IP로 호출하거나 reverse proxy를 통해 접근
host 모드가 싫다면
- Home Assistant를 macvlan/ipvlan으로 LAN에 직접 붙이기
- 같은 서브넷이 아니면 mDNS/SSDP relay 추가
- 필요한 장치만
known hosts등으로 수동 관리
VLAN이 섞여 있으면
- “컨테이너 문제”로 보기보다 네트워크 설계 문제로 봐야 합니다.
- 자동 탐지의 핵심은 결국 같은 브로드캐스트 도메인과 mDNS/SSDP 전달 가능성입니다.
보안 관점에서 꼭 봐야 할 점
host 모드는 편하지만 격리가 약해집니다. Docker 공식 문서의 host network는 호스트와 컨테이너가 네트워크를 공유하는 구조이므로, 포트 충돌이나 노출 범위를 더 엄격하게 관리해야 합니다. macvlan은 host 모드보다 격리 측면에서 낫지만, LAN에 직접 IP를 주는 구조이므로 HA 관리 포트(보통 8123)는 내부망만 허용하는 식의 방화벽 제어가 중요합니다. Docker는 macvlan이 물리 네트워크에 직접 붙는 것처럼 동작한다고 설명하므로, 외부 노출이 쉬워질 수 있다는 점을 전제로 관리해야 합니다.
체크포인트
- HA 관리 포트는 내부망 제한
- 외부 공개가 필요하면 VPN 또는 reverse proxy 뒤로 숨김
- 다른 컨테이너가 HA에 접근하는 경로를 고정
- 장치 탐지를 위해 network-wide multicast를 열었다면, 그 범위를 최소화
결론 요약
- Home Assistant의 장치 탐지는 mDNS/Zeroconf/SSDP에 크게 의존합니다.
- Google Cast 계열 장치는 같은 서브넷에서 자동 발견되는 것이 기본입니다. 다른 서브넷은 자동 탐지가 지원되지 않습니다.
- bridge 모드 컨테이너는 LAN 탐지에 불리합니다.
- host 모드를 쓰면 가장 쉽지만, 다른 컨테이너는
homeassistant:8123이 아니라 호스트 IP로 접근해야 합니다. - host 모드 없이 가려면 macvlan/ipvlan 또는 mDNS/SSDP relay가 현실적인 대안입니다.
- HA 호스트가 192.168.0 대역에 있고 Google Home Mini도 같은 대역이면, 컨테이너 네트워크가 별도여도 로컬 제어는 충분히 가능성이 높습니다.
댓글