Repolode
Koenkk

Koenkk/zigbee2mqtt

Zigbeeスマートホーム機器をMQTTに接続し、メーカー純正のハブやゲートウェイなしで使えるブリッジ。

代替できる製品:Philips Hue Bridge

スター
15,755
フォーク
2,029
未解決の Issue
487
最終コミット
3 日前

これは何?

Zigbee2MQTTはZigbeeコーディネーターアダプターと直接通信し、デバイスのイベントや状態をMQTT経由で再配信します。MQTTトピックを通じてZigbeeの照明、センサー、スイッチなどを操作できるため、MQTTに対応した既存のホームオートメーションシステムにZigbee機器を接続できます。

このプロジェクトはTypeScriptで実装されており、対応するZigbeeアダプターを接続したホスト上でサービスとして動作します。3つのレイヤーで構成され、zigbee-herdsmanがアダプターとの通信を担い、zigbee-herdsman-convertersがデバイスモデルをZigbeeクラスターに対応付け、Zigbee2MQTT本体がZigbeeメッセージとMQTTの間を変換します。監視や設定に使えるWebインターフェースも備えています。

対応デバイスは公開されている互換ハードウェアの一覧で管理され、新しいデバイスはコンバーターコードを記述して追加できます。Home Assistant、Homey、Domoticz、Gladys Assistant、ioBrokerとの公式連携についてもドキュメントが用意されています。

主な機能

  • 01MQTTトピックの発行と購読を通じてZigbeeデバイスを操作できます。
  • 02メーカー独自のZigbeeブリッジやゲートウェイなしで動作します。
  • 03ネットワークの監視や設定に使えるWebインターフェースを備えています。
  • 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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト