Zigbee2MQTT란?
Zigbee2MQTT는 Zigbee 프로토콜을 사용하는 스마트홈 기기들을 MQTT를 통해 Home Assistant와 연동시켜주는 오픈소스 브리지입니다. 다양한 제조사의 Zigbee 기기들을 하나의 허브 없이 통합해 사용할 수 있어 스마트홈 구성에 매우 유용합니다.
설치 전 준비사항
- Home Assistant 설치 환경 (라즈베리파이, 시놀로지 NAS 등)
- CC2652P 기반의 Zigbee USB 동글
- Supervisor 기반의 Home Assistant
- MQTT 브로커 (Mosquitto broker 추천)
⚙️ MQTT 브로커 연결 설정
Zigbee2MQTT는 MQTT를 통해 Zigbee 기기와 통신하므로, 먼저 MQTT 브로커를 설치해야 합니다. Home Assistant에서는 Mosquitto broker 애드온을 많이 사용합니다.
애드온 스토어에서 Mosquitto broker를 선택해 설치합니다.
설치 후, 관련 문서를 참고해 사용자 계정 정보를 YAML 형식으로 입력합니다.
이제 구성 탭에서 직접 username과 password를 입력합니다:
설정 저장 후 애드온을 시작합니다.
정상적으로 시작되었다면, 로그 탭에서 다음과 같은 메시지를 확인할 수 있습니다:
🧩 Zigbee2MQTT 애드온 설치하기
처음에는 애드온 목록에 Zigbee2MQTT가 보이지 않을 수 있습니다. 이 경우, 사용자가 직접 저장소를 추가해주어야 합니다.
Supervisor > Add-on Store로 이동한 뒤, 우측 상단의 점 세 개 아이콘(옵션 메뉴)을 클릭해 저장소 항목을 선택합니다.
아래 저장소 주소를 입력한 후, 추가 버튼을 클릭합니다:
저장소가 성공적으로 등록되면, 애드온 목록에 'Zigbee2MQTT'가 나타납니다. 이를 클릭하여 설치를 진행합니다.
설치가 완료되면, '구성' 탭으로 이동하여 MQTT 브로커 정보와 Zigbee 동글 정보를 설정합니다.
MQTT 설정은 Mosquitto broker의 주소와 계정 기반으로 다음과 같이 입력합니다:
server: mqtt://core-mosquitto:1883
user: 사용자명
password: 비밀번호
Serial 포트는 /dev/ttyUSB0 또는 시놀로지 VMM에서 설정한 장치 경로를 확인해야 합니다.
모든 정보를 정확히 입력한 후 '저장하기' 버튼을 클릭하면 설정이 완료됩니다.
🔗 Zigbee 기기 페어링
Zigbee2MQTT 설치가 완료되면, 다음과 같이 실행 설정을 마무리합니다. 자동 시작은 기본적으로 활성화되어 있고, 필요시 사이드바에 표시 기능을 켜두는 것도 추천드립니다.
이제 좌측 메뉴에 Zigbee2MQTT가 표시되며, 클릭하면 장치 관리 UI가 나타납니다.
상단 우측의 '연결 허용(전체)'을 클릭하면 Zigbee 기기 페어링 모드가 활성화됩니다. 이 상태에서 연결할 기기를 페어링 모드로 전환하면, 자동으로 목록에 추가됩니다.
등록된 장치는 Zigbee2MQTT UI 상에서 이름 변경, 제조사 확인, 신호 세기(LQI) 확인 등 다양한 정보 확인이 가능합니다.
🏁 마무리 정리
이 글에서는 MQTT 브로커 설치, Zigbee2MQTT 애드온 설정, Zigbee 기기 페어링까지의 과정을 안내드렸습니다.
이제 Zigbee 기기들을 자유롭게 추가하고, Home Assistant에서 자동화에 활용해보세요. 하나의 통합 플랫폼으로 스마트홈을 더욱 편리하게 구성할 수 있습니다.