Zigbee2MQTT Home Assistant 官方插件
hassio-zigbee2mqtt
项目简介
Official Zigbee2MQTT Home Assistant add-on
hassio-zigbee2mqtt 是 Zigbee2MQTT 官方为 Home Assistant 打造的集成应用，旨在让用户通过 Home Assistant 的插件系统（App Store）快速部署和管理 Zigbee2MQTT，从而实现对 Zigbee 智能设备的统一控制。该项目解决了在 Home Assistant 环境中手动配置 Zigbee 网关的繁琐问题，用户无需深入理解 Docker 或 Linux 命令行，只需在 Home Assistant 的 App Store 中添加仓库并点击安装，即可完成部署。它提供了两个版本：稳定版（Zigbee2MQTT）和 Edge 版（Zigbee2MQTT Edge），前者追踪正式发布版本，适合大多数用户；后者追踪开发分支，适合需要尝鲜新功能或修复的用户。技术栈上，它基于 Home Assistant 的 Supervisor 插件系统，后端依赖 Zigbee2MQTT 核心库和 MQTT 协议（通常配合 Mosquitto broker 使用），前端则提供 Web UI 进行配置和设备管理。该应用特别适合智能家居爱好者，尤其是那些希望将大量不同品牌的 Zigbee 设备（如灯、传感器、开关）接入 Home Assistant 并实现跨品牌联动的用户。它支持通过 USB 适配器（如 CC2531、CC2652 等）连接 Zigbee 网络，并自动检测适配器类型和端口，简化了硬件配置过程。此外，项目还提供了从独立安装环境迁移数据的详细指南，确保用户升级到 Home Assistant 插件版时不会丢失已有的设备配对信息。整体而言，hassio-zigbee2mqtt 是 Home Assistant 生态中部署 Zigbee2MQTT 最便捷、最官方的方式，显著降低了智能家居网关的搭建门槛。
标签
项目特点
技术规格
| 平台 | |
|---|---|
| 依赖 | |
| 硬件要求 | |
| 适配器支持 | |
| 版本类型 | |
| 配置方式 | |
| 日志查看 |
项目资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| 运行 Home Assistant 的设备（如 Raspberry Pi 4） | 1 | — | 最低要求 Pi 4 |
| Zigbee USB 适配器（如 CC2531, CC2652, ZZH! 等） | 1 | — | 需与 Zigbee2MQTT 兼容 |
| Home Assistant OS / Supervised | 1 | — | 已安装并运行 |
| Mosquitto MQTT Broker（可选但推荐） | 1 | — | 可从 Home Assistant 商店安装 |
所需工具
| 工具 | 用途 | 是否必需 |
|---|---|---|
| Home Assistant | 运行插件的平台 | ✅ 是 |
| SSH 客户端 | 用于数据迁移或调试（可选） | ▢ 推荐 |
| Docker CLI | 用于本地测试插件修改 | ▢ 推荐 |
能力画像
项目图库
