注重本地控制与隐私的开源智能家居自动化平台，可运行在树莓派或本地服务器上。
9.2万+28 本周3.9万PythonApache-2.0更新于 18小时前
- Star
- 15,755
- Fork
- 2,029
- 未关闭 Issue
- 487
- 最近提交
- 3天前
这是什么？
Zigbee2MQTT 直接与 Zigbee 协调器适配器通信，并通过 MQTT 转发设备事件和状态。用户可以通过 MQTT 主题控制 Zigbee 灯具、传感器、开关等设备，从而将 Zigbee 硬件接入任何已支持 MQTT 的智能家居系统。
项目使用 TypeScript 编写，运行在连接了受支持 Zigbee 适配器的主机上。整体分为三层：zigbee-herdsman 负责适配器通信，zigbee-herdsman-converters 将设备型号映射到对应的 Zigbee 簇，Zigbee2MQTT 本身负责在 Zigbee 消息与 MQTT 消息之间转换。项目还提供基于网页的监控和配置界面。
设备支持情况通过公开的兼容设备列表维护，新设备可通过编写转换器代码添加。文档中包含与 Home Assistant、Homey、Domoticz、Gladys Assistant 和 ioBroker 等平台的集成说明。
核心功能
- 01通过发布和订阅 MQTT 主题控制 Zigbee 设备。
- 02无需厂商专用的 Zigbee 网桥或网关。
- 03提供网页界面用于监控和配置网络。
- 04维护一份涵盖多家厂商的受支持设备列表。
- 05提供与 Home Assistant、Homey、Domoticz 等平台的集成。
适用场景
- 搭建不依赖厂商云端网关的本地智能家居。
- 将 Zigbee 传感器数据接入已有的 MQTT 自动化系统。
- 把 Zigbee 设备接入 Home Assistant 等智能家居平台。
快速上手
- 1
按照官方文档中的入门指南操作
使用前须知
- 采用 GPL-3.0 许可证，这是一种 copyleft 许可证，衍生作品须以相同条款开源。
- 并非所有 Zigbee 设备都受支持，未列出的设备可能需要自行添加支持。
标签
常见问题
- zigbee2mqtt 是什么？
- 将 Zigbee 智能设备接入 MQTT 的桥接工具，无需厂商网关即可使用设备。 Zigbee2MQTT 直接与 Zigbee 协调器适配器通信，并通过 MQTT 转发设备事件和状态。用户可以通过 MQTT 主题控制 Zigbee 灯具、传感器、开关等设备，从而将 Zigbee 硬件接入任何已支持 MQTT 的智能家居系统。
- zigbee2mqtt 可以免费使用吗？用的什么许可证？
- zigbee2mqtt 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
- zigbee2mqtt 还在维护吗？
- 活跃维护中。zigbee2mqtt 最近一次提交是在 2026年10月21日。
- zigbee2mqtt 适合用来做什么？
- 搭建不依赖厂商云端网关的本地智能家居。 将 Zigbee 传感器数据接入已有的 MQTT 自动化系统。 把 Zigbee 设备接入 Home Assistant 等智能家居平台。
- zigbee2mqtt 怎么安装和运行？
- 按照官方文档中的入门指南操作
- 在哪里获取 zigbee2mqtt？
- 源代码和安装说明在 GitHub 上：https://github.com/Koenkk/zigbee2mqtt
概要由 AI 根据项目 README 生成；GitHub 数据每日更新。
相关项目
用 YAML 配置文件控制 ESP32、ESP8266 等微控制器，并接入 Home Assistant 等智能家居系统。
1.2万5742C++Other更新于 18小时前
开源电动车充电控制器与家庭能源管理系统，结合光伏与储能数据优化充电，可本地运行、无需云服务。
7406+4 本周1579GoMIT更新于 19小时前
小米官方提供的 Home Assistant 集成，可将米家智能设备接入 Home Assistant。
2.2万1193PythonOther更新于 26天前
自托管的家庭视频集成平台与 NVR，支持智能检测，并将摄像头画面低延迟推送至 HomeKit、Google Home 和 Alexa。
6021406TypeScriptOther更新于 6天前
用于通过 miIO 和 MIoT 协议控制小米智能家居设备的 Python 库及命令行工具。
4331601PythonGPL-3.0更新于 3个月前