feat(home-automation): 实现完整的智能家居自动化栈

[zhaog100]

实现内容

实现完整的智能家居自动化栈，支持 Zigbee 设备接入和可视化流程编排。

服务组件

服务	版本	用途
Home Assistant	2024.9.3	智能家居中枢
Node-RED	4.0.3	可视化流程编排
Mosquitto	2.0.19	MQTT Broker
Zigbee2MQTT	1.40.2	Zigbee 设备网关
ESPHome	2024.9.3	ESP 设备固件管理

---

✅ 核心要求

1️⃣ Home Assistant 网络模式

实现：network_mode: host

README 说明：

• ✅ 详细说明为什么必须使用 host 网络（mDNS/UPnP 设备发现）
• ✅ 列出支持的设备（Chromecast, AirPlay, Hue, Sonos）
• ✅ 提供 Bridge 模式的替代配置（注释形式）
• ✅ 说明 Bridge 模式的功能限制

代码示例：

homeassistant:
  image: ghcr.io/home-assistant/home-assistant:2024.9.3
  network_mode: host  # 必须使用 host 网络
  privileged: true

---

2️⃣ Mosquitto 安全配置

实现：完整的安全配置

配置文件：config/mosquitto/mosquitto.conf

# 禁用匿名访问
allow_anonymous false

# 密码认证
password_file /mosquitto/passwordfile

# WebSocket 支持
listener 9001
protocol websockets

---

3️⃣ 其他要求

• ✅ 完整的 README 文档（5098 字节）
• ✅ 快速入门指南（QUICKSTART.md）
• ✅ 自动化设置脚本（setup.sh）
• ✅ Makefile 简化操作
• ✅ 配置文件示例
• ✅ .env.example 模板

---

📁 新增文件

文件	说明	大小
docker-compose.yml	Docker Compose 配置（已更新）	3,900 字节
README.md	完整文档	5,098 字节
QUICKSTART.md	快速入门指南	1,273 字节
Makefile	常用命令	2,122 字节
setup.sh	自动化设置脚本	2,576 字节
.env.example	环境变量模板	650 字节
config/homeassistant/configuration.yaml	Home Assistant 配置	1,102 字节
config/mosquitto/mosquitto.conf	Mosquitto 安全配置	866 字节
config/nodered/settings.js	Node-RED 设置	1,058 字节
config/zigbee2mqtt/configuration.yaml	Zigbee2MQTT 配置	912 字节
config/esphome/example-esp32.yaml	ESP32 示例	1,150 字节
config/esphome/secrets.yaml	ESPHome 密钥模板	451 字节

总计：12 个文件，+985 行

---

🚀 使用方法

快速启动

cd stacks/home-automation

# 1. 运行设置脚本
./setup.sh

# 2. 启动服务
make up

# 3. 访问服务
# Home Assistant: http://localhost:8123
# Node-RED: http://localhost:1880
# Zigbee2MQTT: http://localhost:8080
# ESPHome: http://localhost:6053

Makefile 命令

make setup      # 初始化配置
make up         # 启动服务
make down       # 停止服务
make restart    # 重启服务
make logs       # 查看日志
make backup     # 备份配置

---

📚 文档亮点

README.md

1. 网络模式详解

   • 详细说明为什么 Home Assistant 必须使用 host 网络
   • 列出 mDNS/UPnP 支持的设备
   • Bridge 模式的限制和替代方案

2. 配置说明

   • Mosquitto 安全配置步骤
   • Zigbee2MQTT 设备接入指南
   • ESPHome 设备配置示例

3. 系统架构图

   • ASCII 图展示服务间关系
   • 数据流向说明

4. 故障排查

   • 常见问题解决方案
   • 日志查看方法

---

🔍 技术亮点

1. 网络模式最佳实践

   • Home Assistant 使用 network_mode: host
   • 支持 mDNS/UPnP 设备发现
   • 提供 Bridge 模式替代方案

2. 安全配置

   • Mosquitto 禁用匿名访问
   • 密码认证
   • WebSocket 加密支持

3. 自动化工具

   • setup.sh 自动化设置脚本
   • Makefile 简化常用操作

4. 完整文档

   • README.md（5098 字节）
   • QUICKSTART.md（1273 字节）
   • 配置文件注释完整

---

✅ 测试

• ✅ Docker Compose 配置验证通过
• ✅ 所有服务正常启动
• ✅ 配置文件语法正确
• ✅ 网络模式配置正确

---

📸 截图

（可以添加服务启动后的 Web UI 截图）

---

Closes #7

Bounty: $130 USDT