Koenkk/zigbee2mqtt

어떤 프로젝트인가요?

핵심 기능

• 01MQTT 토픽을 게시하고 구독해 Zigbee 기기를 제어합니다.
• 02제조사 전용 Zigbee 브리지나 게이트웨이 없이 사용할 수 있습니다.
• 03네트워크 모니터링 및 설정을 위한 웹 인터페이스를 제공합니다.
• 04여러 제조사의 지원 기기 공개 목록을 관리합니다.
• 05Home Assistant, Homey, Domoticz 등과의 연동 방법을 문서로 제공합니다.

활용 사례

• 클라우드 전용 제조사 허브에 의존하지 않는 로컬 스마트 홈을 운영합니다.
• Zigbee 센서 데이터를 기존 MQTT 기반 자동화 시스템에 전달합니다.
• 제조사가 지원하지 않는 Zigbee 기기를 Home Assistant 같은 플랫폼에 추가합니다.

빠른 시작

1. 1

   공식 문서의 시작하기 가이드를 따르세요

사용 전 알아둘 점

• !GPL-3.0 라이선스로 제공됩니다. 이는 파생 저작물도 동일한 조건으로 오픈소스화하도록 요구하는 카피레프트 라이선스입니다.
• !모든 Zigbee 기기를 지원하는 것은 아니므로, 목록에 없는 기기에는 새롭게 지원 기능을 추가해야 할 수 있습니다.

토픽

자주 묻는 질문

zigbee2mqtt은(는) 무엇인가요?

Zigbee 스마트 홈 기기를 MQTT에 연결해 제조사 전용 허브나 게이트웨이 없이 사용할 수 있게 해주는 브리지입니다. Zigbee2MQTT는 Zigbee 코디네이터 어댑터와 직접 통신하고, 기기 이벤트와 상태를 MQTT로 다시 전달합니다. 사용자는 MQTT 토픽을 통해 Zigbee 조명, 센서, 스위치 및 기타 기기를 제어할 수 있어, MQTT를 지원하는 기존 홈 자동화 시스템에 Zigbee 기기를 연결할 수 있습니다.

zigbee2mqtt은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

zigbee2mqtt은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

zigbee2mqtt은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. zigbee2mqtt의 마지막 커밋은 2026년 10월 21일입니다.

zigbee2mqtt은(는) 어디에 사용할 수 있나요?

클라우드 전용 제조사 허브에 의존하지 않는 로컬 스마트 홈을 운영합니다. Zigbee 센서 데이터를 기존 MQTT 기반 자동화 시스템에 전달합니다. 제조사가 지원하지 않는 Zigbee 기기를 Home Assistant 같은 플랫폼에 추가합니다.

zigbee2mqtt는 어떻게 설치하나요?

공식 문서의 시작하기 가이드를 따르세요

zigbee2mqtt은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Koenkk/zigbee2mqtt