待补充
itavero/homebridge-z2m
智能家居
3/5
🧩 软硬件结合
已发布
项目简介
Expose your Zigbee devices to HomeKit with ease, by integrating 🐝 Zigbee2MQTT with 🏠 Homebridge.
homebridge-z2m 是一个专为智能家居爱好者设计的开源插件，它巧妙地桥接了 Zigbee2MQTT 与 Homebridge 两大生态，让用户能够轻松地将 Zigbee 设备接入苹果 HomeKit 系统。该项目由社区开发者 itavero 维护，并获得了 Homebridge 官方“已验证”标识，稳定性和兼容性有保障。
标签
项目特点
**自动设备发现**：自动从 Zigbee2MQTT 读取设备列表，无需手动添加每个设备。
**原生 HomeKit 支持**：将 Zigbee 设备暴露为 HomeKit 配件，支持灯、开关、传感器、窗帘等常见类型。
**MQTT 桥接**：通过 MQTT 协议与 Zigbee2MQTT 通信，实时同步设备状态和控制指令。
**官方验证**：获得 Homebridge 官方“已验证”标识，插件质量、安全性和兼容性有保障。
**配置简单**：只需填写 Zigbee2MQTT 的 MQTT 服务器地址和基础主题，即可快速启用。
**持续维护**：由社区开发者 itavero 维护，定期更新以支持新设备和修复问题。
技术规格
| 插件类型 | |
|---|---|
| 依赖服务 | |
| 通信协议 | |
| 支持的 Homebridge 版本 | |
| 支持的 Node.js 版本 | |
| 设备同步方式 | |
| 设备类型支持 | |
| 配置项 | |
| 许可证 |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Homebridge | 1 | — | 需预先安装并运行 |
| Zigbee2MQTT | 1 | — | 需预先安装并运行，负责 Zigbee 设备通信 |
| MQTT Broker (如 Mosquitto) | 1 | — | 通常由 Zigbee2MQTT 自带或独立部署 |
| 运行 Homebridge 的设备 | 1 | — | 如 Raspberry Pi、NAS、Docker 容器等 |
| Zigbee 协调器 | 1 | — | 如 CC2531、CC2652 等，需与 Zigbee2MQTT 配合 |
| Zigbee 终端设备 | 若干 | — | 如灯、传感器、开关等，需已配对到 Zigbee2MQTT |
能力画像
**记忆与知识检索**：3/5 — 需要理解 MQTT 协议、Zigbee2MQTT 配置和 Homebridge 插件机制，但文档和社区资源较丰富。
**动手与操作**：4/5 — 涉及硬件连接 (Zigbee 协调器)、软件安装 (Homebridge、Zigbee2MQTT) 和网络配置，动手环节较多。
**编程与算法**：2/5 — 无需编写代码，但需要修改配置文件 (JSON)，具备基础命令行操作能力即可。
**设计与建模**：1/5 — 不涉及硬件设计或建模，主要是系统集成和配置。
**实验与调试**：3/5 — 可能遇到设备不兼容、MQTT 连接失败等问题，需要查看日志和调试配置。
**协作与分享**：2/5 — 可通过 GitHub Issues 提交问题或贡献代码，但主要是个人使用。
**学习与研究**：4/5 — 需要学习 Zigbee 协议基础、MQTT 工作原理、Homebridge 插件体系，适合智能家居入门者。
**系统集成**：5/5 — 核心能力就是集成 Zigbee2MQTT 和 Homebridge 两大系统，打通 Zigbee 设备到 HomeKit 的链路。
项目图库
所需技能
基础 Linux 命令行操作 (安装软件、编辑文件)
了解 MQTT 协议基本概念 (主题、发布/订阅)
熟悉 Homebridge 安装和配置
了解 Zigbee2MQTT 的基本使用和设备配对
能够阅读英文文档和日志
具备简单的网络故障排查能力
适用场景
已有 Zigbee2MQTT 环境，想将 Zigbee 设备接入苹果 HomeKit 的用户
希望用 Siri 或家庭 App 控制 Zigbee 灯、传感器、开关的智能家居爱好者
不想购买 HomeKit 专用 Zigbee 桥接器 (如 Aqara Hub) 的 DIY 玩家
需要将多种 Zigbee 设备统一到 HomeKit 进行自动化控制的家庭
对 Homebridge 插件生态感兴趣，想尝试官方验证插件的开发者