diyhue/diyHue

这是什么？

核心功能

• 01模拟飞利浦 Hue 网桥，供兼容 Hue 的应用和智能家居系统使用。
• 02支持 ZigBee、米家灯泡、WS2812B/SK6812 灯带和基于 ESP8266 的灯具。
• 03支持分组、场景和 Hue 娱乐模式等功能。
• 04完全本地运行，无需连接云端。
• 05可在树莓派等小型设备或 Docker 中运行。

适用场景

• 在官方 Hue 应用或 Hue Essentials 中控制非 Hue 的灯带或灯泡。
• 在树莓派上搭建本地、无云依赖的灯光中枢，与 Home Assistant 配合使用。
• 将 ZigBee 或米家灯具接入 Alexa 等兼容 Hue 的系统。

快速上手

1. 1

   安装 requirements.txt 中列出的 Python 模块

   pip install -r requirements.txt
2. 2

   或使用 Docker 运行 diyHue 镜像

   docker pull diyhue/core
3. 3

   阅读文档中的完整安装说明

使用前须知

• !需要在树莓派等小型设备上全天候运行。
• !需要额外安装 coap-client 和 faketime 等系统包，或使用 Docker。
• !不支持远程 API 访问等部分功能。
• !许可证元数据为 NOASSERTION，复用前请查看 LICENSE 文件。

标签

常见问题

diyHue 是什么？

一个用 Python 模拟飞利浦 Hue 网桥的工具，让兼容 Hue 的应用和智能家居系统本地控制多种非 Hue 灯具。 diyHue 模拟飞利浦 Hue 网桥，使原本只能对接 Hue 网桥的应用和智能家居系统，也能控制其他来源的灯具。它可以通过 Raspbee、Deconz 或宜家 Trådfri 网关驱动 ZigBee 灯具，也支持米家（MiLight）灯泡、WS2812B 和 SK6812 灯带，以及刷入自定义固件的 ESP8266 灯泡和开关。

diyHue 可以免费使用吗？用的什么许可证？

diyHue 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

diyHue 还在维护吗？

活跃维护中。diyHue 最近一次提交是在 2026年10月23日。

diyHue 适合用来做什么？

在官方 Hue 应用或 Hue Essentials 中控制非 Hue 的灯带或灯泡。 在树莓派上搭建本地、无云依赖的灯光中枢，与 Home Assistant 配合使用。 将 ZigBee 或米家灯具接入 Alexa 等兼容 Hue 的系统。

diyHue 怎么安装和运行？

安装 requirements.txt 中列出的 Python 模块: pip install -r requirements.txt 或使用 Docker 运行 diyHue 镜像: docker pull diyhue/core 阅读文档中的完整安装说明

在哪里获取 diyHue？

源代码和安装说明在 GitHub 上：https://github.com/diyhue/diyHue