Zigbee2MQTT 설치 완벽 가이드: 스마트홈 자동화를 위한 첫걸음

 

스마트홈을 처음 구축하려는 많은 사용자들이 ‘Zigbee’를 선택하는 데는 분명한 이유가 있습니다. Wi-Fi에 비해 전력 소모가 훨씬 적고, 장치 간 직접 연결로 형성되는 메시 네트워크 덕분에 센서 간 통신이 안정적이며 확장성도 뛰어나기 때문입니다. 특히 하나의 허브에서 다양한 제조사의 Zigbee 장치를 통합 제어할 수 있다는 점에서, Zigbee 생태계는 스마트홈 자동화의 실질적인 표준으로 자리잡아가고 있습니다.

이러한 흐름 속에서 주목받고 있는 도구가 바로 Zigbee2MQTT 설치입니다. 줄여서 Z2M이라 불리는 이 오픈소스 프로젝트는 Zigbee 장치를 MQTT를 통해 Home Assistant 같은 스마트홈 플랫폼과 연동해주는 핵심 솔루션으로, 제조사에 상관없이 다양한 장치를 하나의 시스템으로 통합할 수 있는 자유도 높은 환경을 제공합니다. 이 글에서는 초보자도 손쉽게 따라할 수 있도록, 지그비 코디네이터 구입부터 Zigbee2MQTT 설치, 장치 페어링, 그리고 Home Assistant와의 연동 방법까지 차근차근 안내해드리겠습니다.

 

Zigbee2MQTT 설치의 첫걸음은 바로 지그비 코디네이터를 준비하는 일입니다. 이 장치는 Zigbee 네트워크의 중심이 되는 하드웨어로, USB 포트에 연결해 사용하는 형태가 일반적입니다. 가장 많이 사용되는 모델은 Sonoff Zigbee 3.0 USB Dongle Plus이며, CC2652P 칩셋을 기반으로 우수한 수신 성능과 다수의 장치 지원을 자랑합니다. 이외에도 Electrolama의 zzh!, 또는 실내 수신 감도를 강화한 SLZB-06M, TubeZB 등의 모델도 추천할 만합니다. 중요한 점은 Home Assistant가 설치된 장비에 USB로 직접 연결해야 하므로, 포트 위치와 장치 인식을 반드시 확인해두는 것이 좋습니다.

지그비 코디네이터를 준비했다면, 이제 Home Assistant 내에서 MQTT 브로커를 설치해야 합니다. Zigbee2MQTT 설치 과정에서 MQTT는 Zigbee 데이터를 주고받는 통신 채널 역할을 합니다. Home Assistant에 접속한 후, Settings 메뉴에서 Add-ons를 열고 Add-on Store에서 “Mosquitto broker”를 검색하여 설치합니다. 설치가 완료되면 ‘Start’를 눌러 브로커를 활성화하고, 자동 시작도 함께 설정해줍니다. 초기 설정 없이도 기본값으로 작동하지만, 사용자 인증을 위해 별도의 계정을 하나 만들어두는 것을 추천드립니다. 이는 나중에 Zigbee2MQTT와 연결할 때 중요한 인증 수단이 됩니다.

다음은 가장 핵심적인 단계인 Zigbee2MQTT 설치입니다. 마찬가지로 Add-on Store에서 우측 상단 점 3개를 눌러 Repositories에 아래 주소를 추가합니다:

https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

저장소를 등록한 후, ‘Zigbee2MQTT’를 검색해 설치하면 됩니다. 설치가 완료되면 Configuration 탭에서 몇 가지 필수 설정을 입력해야 합니다. 가장 먼저 Serial Port 설정이 필요한데, 일반적으로는 /dev/ttyUSB0이지만, 사용자의 시스템 환경에 따라 다를 수 있으니 Supervisor > System 메뉴에서 실제 포트를 확인해야 합니다. 다음으로는 MQTT 설정인데, 앞서 만든 사용자 정보를 기반으로 다음과 같이 입력합니다:

 

mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://core-mosquitto
  user: your_mqtt_user
  password: your_mqtt_password

 

추가로 permit_join: true를 설정하여 장치 페어링을 허용하고, homeassistant: true를 활성화하여 Home Assistant와의 자동 연동이 가능하도록 설정합니다. 모든 설정을 마친 후에는 저장을 누르고 Start를 클릭하여 실행합니다.

이제 실제 Zigbee 장치를 연결해보는 페어링 단계입니다. Zigbee2MQTT 웹 UI에 접속하려면 기본적으로 http://homeassistant.local:8080 주소를 사용하며, 포트는 설정에 따라 달라질 수 있습니다. 인터페이스 좌측 상단에 있는 ‘Permit Join’ 버튼을 클릭하면 페어링 모드가 활성화됩니다. 이후 연결하고자 하는 Zigbee 장치의 페어링 버튼을 누르면 장치가 자동으로 인식되며, 웹 UI에서 해당 장치를 확인하고 이름이나 기능도 설정할 수 있습니다.

이 단계에서 주의할 점은 지그비 채널이 Wi-Fi 채널과 겹치지 않도록 설정해야 한다는 점입니다. 채널 간 간섭이 생기면 연결이 끊기거나 반응 속도가 느려질 수 있으므로, Zigbee 채널은 15, 20, 25번 중 하나를 사용하는 것이 일반적입니다.

마지막으로는 Home Assistant와의 연동 확인입니다. Zigbee2MQTT 설정에서 homeassistant: true 옵션이 활성화되어 있다면, Home Assistant는 자동으로 새 Zigbee 장치를 인식합니다. Settings → Devices & Services → MQTT 메뉴를 통해 장치 등록 여부를 확인할 수 있으며, 등록된 장치는 Lovelace 대시보드에 카드 형식으로 추가하거나 자동화 트리거로 바로 활용할 수 있습니다.

 

 

결론적으로, Zigbee2MQTT 설치는 스마트홈 자동화를 위해 반드시 짚고 넘어가야 할 핵심 과정입니다. 과거에는 비교적 복잡한 CLI 기반의 설정이 필요했지만, 현재는 Home Assistant의 Add-on 시스템 덕분에 초보자도 쉽게 설치할 수 있도록 환경이 개선되었습니다. 특히 CC2652P 기반의 지그비 코디네이터를 활용하면 장치 수용량과 신호 안정성이 뛰어나므로, 실사용에서도 높은 만족도를 느낄 수 있습니다. 다양한 제조사의 장치를 통합 관리하고자 한다면, 지금 바로 위 내용을 참고하여 Zigbee2MQTT 설치에 도전해보세요. 생각보다 어렵지 않으며, 스마트홈의 진정한 자유로움을 경험하는 계기가 될 것입니다.