Zigbee2MQTT 适配预检

买 Zigbee 设备前先看它能不能被 Z2M 接管。市面上常见的 Aqara / 涂鸦 / IKEA 设备覆盖差异超过 50%。

选择设备

设备类型

品牌

电源方式

Z2M 版本

广告位 · 自然位置

Zigbee2MQTT(Z2M)是一个开源项目,目标是把所有 Zigbee 设备统一接入 Home Assistant / MQTT,摆脱厂商 App 限制。它不是协议,是软件网关。

Z2M 支持度的三个真相:

"支持"≠ 100% 功能:Z2M 文档里写 Supported,只是说设备能配对、基本开关能识别。高级功能(电量、温度上报间隔、动态效果)经常要靠社区 PR。
需要刷协调器固件:Zigbee 协调器(SkyConnect / ZBDongle)必须刷成 Z-Stack 3.x 固件。刷错了变砖,刷对了 Z2M 才能识别。
厂商加密设备要 hack:Aqtu A4 / 涂鸦部分设备出厂 Zigbee Key 加密,Z2M 通过 README 连接提取"信号",但偶尔会因固件更新而失败。

为什么我的 Aqara 设备没出现在 Z2M?

常见原因:1) 设备没进入配对模式(很多 Aqara 设备要按住 5 秒直到指示灯快闪);2) Aqara 设备出厂加密,需要在 README 里 reconfigure;3) Z2M 协调器与 Aqara Hub 同处一网会冲突,把 Aqara Hub 关机再试。

涂鸦设备 Z2M 支持率如何?

涂鸦设备 Z2M 支持率约 60-70%。涂鸦 OEM 厂商品牌太多(MOES / Nous / LSC / Brilliant),每个都要社区单独适配。买之前去 z2m.dev 输入厂商搜索。

Hue 灯泡需要 Hue Bridge 吗?

Z2M 可以直连 Hue 灯泡(无需 Hue Bridge),但只支持基础功能(开关、调亮度、调色温)。娱乐同步(Hue Sync)、动态场景会丢失。如果你只用 Hue 当普通灯,Z2M 完全够用。

Z2M 和 Zigbee Home Automation(ZHA)选哪个?

ZHA 内置在 HA,无需额外维护,但设备支持列表比 Z2M 慢 2-3 个月。Z2M 设备支持更广,但要单独维护一个服务(在 Docker 里)。新手建议先用 ZHA,熟练后再切 Z2M。

基于 Zigbee2MQTT 官方设备库数据。结果随项目更新变化。

本地计算,不上传任何输入。

仅供参考,具体兼容性以官方文档为准。