홈어시스턴트(Home Assistant) 매터브릿지(MatterBridge) 에드온 사용해서 구글홈(Google Home)에 장치 연동하기

728x90

구글 홈에서도 Home Assistant 기기를 로컬로 제어한다면?

스마트홈의 핵심은 단순한 제어를 넘어서, 속도와 안정성, 그리고 플랫폼 간 호환성에 있습니다. 특히 Home Assistant(이하 HA)를 중심으로 구성한 스마트홈 환경에 구글 홈(Google Home)이나 스마트싱스(SmartThings)를 연동하려는 사용자라면, MatterBridge 애드온을 주목할 필요가 있습니다.

이 애드온은 HA에 등록된 구성요소들을 Matter 호환 기기로 변환하여, Google Home 또는 SmartThings와 **로컬 기반 제어(Local Control)**가 가능하도록 중계 역할을 수행합니다.

1. MatterBridge 애드온이란?

MatterBridge 애드온은 Home Assistant에서 Matter 표준을 기반으로 외부 플랫폼과의 통합을 지원하는 로컬 브릿지 서버입니다.

구글홈/스마트싱스 등에서 HA 장치를 Matter 디바이스로 인식하게 만들며,
클라우드를 거치지 않기 때문에 속도와 안정성에서 탁월한 성능을 발휘합니다.

MatterBridge는 다양한 플러그인을 지원하는 오픈소스 서버이며, 이 중 matterbridge-home-assistant 플러그인이 HA 애드온 형태로 제공되고 있습니다.

2. 설치 및 설정 방법

2-1. 애드온 설치

Home Assistant → 설정 → 애드온 → 애드온 스토어 진입
우측 상단 메뉴 "..." 클릭 → "저장소" 선택
다음 GitHub 저장소 주소 입력 후 추가
https://github.com/t0bst4r/matterbridge-home-assistant-addon
저장소 추가 후 새로고침(F5) → "Matterbridge" 애드온 선택 → 설치

2-2. 애드온 구성 설정

설치 후 "구성" 탭에서 Include Labels 항목에 아래처럼 설정반드시 소문자로 입력해야 합니다.
matterbridge
설정 저장

3. 구성요소 레이블링 (Matter 등록 대상 지정)

3-1. 레이블 생성

설정 → 영역 및 지역 → 레이블 → "+ 레이블 추가"
이름: matterbridge (소문자 필수)

3-2. 구성요소에 레이블 부여

설정 → 장치 및 서비스 → 통합/도우미/구성요소 중 대상 선택
설정(톱니바퀴) → "레이블 추가"에서 matterbridge 선택
저장(업데이트) 클릭

단, 구성요소 단위로만 등록이 가능하며, 장치 단위는 지원하지 않습니다.

4. Matterbridge 애드온 시작 및 QR코드 확인

레이블을 업데이트 했다면 애드온 화면으로 이동 → "시작" 또는 "재시작" 클릭
30초 정도 대기 후 "웹 UI 열기" 클릭
- 기본 접속 주소: http://<로컬IP>:8283
- 포트포워딩이 필요한 경우: http://xxxxx.duckdns.org:8283

스마트폰만 사용하는 경우, QR코드 대신 Manual pairing code를 메모해두세요.

5. Google Home에 기기 등록하기 (안드로이드 필요)

Google Home 앱 → "기기" 탭 → + 추가 → Matter 지원 기기
QR 코드 스캔 또는 Manual Pairing Code 입력
안내에 따라 기기 설정 완료
원하는 방에 기기 배치
“헤이 구글, 선풍기 켜줘” 등 음성 명령 테스트

중요: 구글홈앱과 스마트싱즈앱 중에 메인으로 사용할 앱을 선택해야 합니다.

홈어시스턴트(구글네스트스피커)만 사용한다면 5번 과정만 하시고

스마트싱즈(갤럭시홈미니스피커)만 사용한다면 6번 과정만 하세요

AI 스피커를 구글 네스트 스피커와 삼성 빅스비 스피커 2개를 동시에 사용한다면 8번 과정을 참고하세요.

iOS는 등록 불가. 안드로이드에서 등록 후, iOS 기기에서도 사용 가능

6. SmartThings 연동하기

스마트싱스 앱 → "+" → 기기 추가 → QR 코드 스캔
또는
제휴사 기기 추가 → Matter 선택 → Manual 코드 입력
"계속" 진행 후 기기 등록

이미 홈어시스턴트에 연동 하였다면 매터브릿지는 1개만 사용 가능하므로 6번 과정을 생략하고 8번 과정으로 넘어가시길 바랍니다.

기기들은 "Matterbridge aggregator" 아래에 함께 표시되며, 원하는 방에 배치 가능

장치가 잘 등록되면 구글홈에서 장치를 제어할수도 있고, 구글 네스트 스피커로도 제어 할 수 있게 됩니다.

등록후에 매터브리지 웹콘솔에 들어가면 장치가 잘 등록된것을 볼 수 있습니다.

지원 도메인 (등록 가능한 구성요소)

light.: 밝기, 색상 제어 포함
switch., input_boolean., script., scene., automation.: 단순 on/off
sensor.: 온도, 습도
binary_sensor.: 상태값 on/off
lock.: 잠금/해제
cover.: 블라인드 등 창 커버
fan.: 다이얼식 조광 장치로 인식됨
climate.: 일부 기기에서 정상 동작 안 될 수 있음
media_player.: on/off만 지원

button, device 단위, 일부 climate/fan 장치는 비정상 동작 가능

7. 장치 추가/삭제 및 재설정

새 기기 추가 시: 구성요소 레이블 부여 후 애드온 재시작
삭제하려면: 구성요소 레이블 제거 후 애드온 재시작
전체 삭제: "Matterbridge aggregator" 삭제 시 모든 기기가 제거됨

8. 구글홈과 스마트싱스 동시 연동 팁

Google Home에서 Matterbridge aggregator 기기 선택
"연결된 Matter 앱 및 서비스" → "SmartThings" 추가
SmartThings 앱에서 HA 구성요소 자동 연동

단, 구글홈과 스마트싱스가 Google 호환기기를 통해 이미 연결되어 있다면 중복 등록이 발생할 수 있습니다. 이 경우 SmartThings를 다른 ‘홈(Home)’으로 분리 구성하세요.
추천 구성은 어차피 AI 스피커는 1개만 사용하는게 좋으므로, 앱 및 서비스 연결 기능은 추천 드리지 않습니다.
구글 스피커에서 제어를 자주하신다면 구글에서만 등록하고 빅스비를 자주 사용하신다면 빅스피 스피커를 사용하세요

빠르고 안정적인 로컬 스마트홈, MatterBridge로 완성하다

MatterBridge 애드온은 HA 기반 스마트홈을 Google Home이나 SmartThings에 로컬 기반으로 확장하고자 할 때 최고의 솔루션입니다. 복잡한 클라우드 연동 없이도 빠른 응답과 높은 신뢰성을 유지할 수 있으며, 다양한 구성요소와 연동 가능한 점에서 스마트홈 전문가나 파워 유저에게도 충분한 매력을 제공합니다.

매터브릿지는 클라우드 방식이 아닌 로컬 방식이므로 빠르고 편리합니다.

앞으로는 스마트싱즈 SASM을 사용해서 빅스피 스피커를 더 멋지게 활용할 수 있는 방법과 홈어시스턴트 노드레드를 사용해서 구글 네스트 스피커를 더 멋지게 활용할 수 있는 방법도 포스팅 하려고 합니다. 저의 블로그에 방문하셔서 좋은 정보 얻어가세요^^

부록: 자주 묻는 질문(FAQ)

Q1. Google Home 등록 후 오프라인 상태가 지속될 때?
→ Nest Hub 또는 Google Home Mini 재부팅
Q2. WiFi가 5GHz일 경우 등록이 안 되는 문제
→ 반드시 2.4GHz로 연결
Q3. 기존 레이블 이름 변경 시 동작 오류
→ 삭제 후 새로 추가하는 것이 안정적
Q4. 미지원 기기 등록은 불가능한가요?
→ 스크립트를 생성한 후 해당 스크립트에 레이블 등록으로 우회 가능

alias: 공동 현관문
sequence:
  - service: button.press
    target:
      entity_id: button.open_door
mode: single

위 스크립트 등록 후 “헤이 구글, 현관문 켜줘”로 제어 가능