diyHue/core 镜像文档

镜像概述与主要用途

此镜像可帮助您低成本创建个人Philips Hue系统，支持大多数智能灯，并提供额外功能如运动传感器触发时的邮件通知。默认支持基于ESP8266平台的WiFi灯和传感器，可扩展控制ZigBee设备（通过RaspBee模块、IKEA Tradfri网关或原装Philips Hue桥接器），特别优化支持价格亲民且广泛可用的IKEA Tradfri设备。

!Hue Map

核心功能与特性

低成本自建系统：无需昂贵原装设备，即可搭建兼容Philips Hue的智能照明系统
多设备支持：
- 默认兼容ESP8266平台的WiFi灯和传感器
- 可扩展控制ZigBee设备：通过RaspBee模块直接控制（无需额外桥接器），或通过IKEA Tradfri网关、原装Philips Hue桥接器间接控制
- 特别优化支持IKEA Tradfri设备（价格亲民且多国有售）
额外功能：支持运动传感器触发时发送邮件通知等自定义功能

使用场景与适用范围

适用于以下用户场景：

希望低成本构建智能照明系统的个人用户
拥有ESP8266平台WiFi智能设备的DIY爱好者
需要整合控制ZigBee智能设备（如IKEA Tradfri系列）的用户
使用x86架构或ARMv7架构设备（如树莓派2及更高版本）的开发者

安装与使用方法

支持的系统架构

当前镜像已通过测试的系统：

x86架构计算机
ARMv7架构设备（树莓派2及更高版本，优先测试树莓派3b+）

其他ARM架构设备用户可测试并通过项目Slack聊天或issue反馈结果

网络模式配置

镜像支持两种Docker网络模式，可根据需求选择：

Host网络模式（推荐）

特点：配置简单，无需额外端口映射；但对容器网络控制较少
运行命令：

bash
docker run -d --name "diyHue" --network="host" -v '/mnt/hue-emulator/export/':'/opt/hue-emulator/export/':'rw' diyhue/core:latest

Bridge网络模式

特点：可精细控制容器网络流量；需手动指定主机IP、MAC及端口映射（端口不可更改，Hue生态系统依赖固定端口通信）
运行命令：

bash
docker run -d --name "diyHue" --network="bridge" \
  -v '/mnt/hue-emulator/export/':'/opt/hue-emulator/export/':'rw' \
  -e 'MAC=XX:XX:XX:XX:XX:XX' \  # 主机设备MAC地址
  -e 'IP=XX.XX.XX.XX' \          # 主机设备IP地址
  -p 80:80/tcp \                 # 固定端口映射
  -p 443:443/tcp \
  -p 1900:1900/udp \
  -p 2100:2100/udp \
  diyhue/core:latest

镜像版本选择

latest标签：指向最新构建版本，适合测试；但项目提交频繁，可能包含重大变更
Commit Hash标签：每个镜像同时标记commit哈希（如diyhue/core:391cc642072aac70d544fd428864f74bf9eaf636），建议生产环境使用此标签，手动控制更新频率

数据持久化配置

挂载目录说明

挂载路径：/mnt/hue-emulator/export/:/opt/hue-emulator/export/:rw（主机目录可自定义）
作用：
- 自动备份config.json（配置文件）和cert.pem（证书文件）
- 容器重启时自动恢复上述配置文件
- 支持手动修改配置：在主机挂载目录编辑文件后重启容器即可生效

手动导出配置

如需立即备份配置，可访问URL：http://{模拟器IP}/save

若挂载目录为空，容器启动时会自动生成初始配置文件

配置说明

配置文件修改：需在主机挂载目录（如/mnt/hue-emulator/export/）中编辑config.json和cert.pem，修改后重启容器生效
网络参数：bridge模式下必须正确设置主机IP和MAC环境变量，端口映射需严格使用80/tcp、443/tcp、1900/udp、2100/udp（Hue生态系统依赖固定端口通信）