用途:管理 Zigbee2MQTT 桥接服务,包括协调器设置、设备配对、网络配置、OTA 固件更新、MQTT 集成与故障排查。
主要能力:查看服务状态与日志、开启/关闭配对、列出与移除设备、重命名设备、查看协调器信息、强制设备重新访谈、触发与执行 OTA 更新、备份配置、检查 MQTT 连接与健康状态。
使用方式:服务单元为 zigbee2mqtt.service,或 Docker 容器 zigbee2mqtt;配置位于 /opt/zigbee2mqtt/data/configuration.yaml(裸机)或 ./data/configuration.yaml(Docker 卷)。常用命令包括 systemctl status zigbee2mqtt、journalctl -u zigbee2mqtt -f、mosquitto_pub -t zigbee2mqtt/bridge/request/permit_join -m '{"value": true, "time": 254}'、mosquitto_sub -t zigbee2mqtt/bridge/devices -C 1 等。前端需在配置中显式启用 frontend.enabled: true,访问 http://<host>:8080。依赖 Mosquitto 等 MQTT broker,须先于 Z2M 启动。
适用场景:Zigbee 设备接入与维护、固件升级、MQTT 集成调试、服务健康检查与故障定位。
限制与注意:串口路径建议使用 /dev/serial/by-id/... 以保持稳定;适配器类型须与硬件匹配(zstack、ezsp、deconz、zigate);Zigbee 信道 11–26 与 WiFi 2.4GHz 重叠,建议使用 15、20 或 25;Docker 需 --device 透传 USB;部分设备需恢复出厂设置才能配对;permit_join 长期开启存在安全风险,正常运行时应为 false;用户需加入 dialout 组。具体价格、平台支持范围等资料暂未提供。