Skip to content
DroidFlight Wiki

Home Assistant 开源智能家居平台

概念速览

  • Home Assistant (HASS)：由 Nabu Casa 主导的开源家庭自动化平台，强调 本地优先、隐私优先
  • 核心组件：Core (Python) + Supervisor (Docker) + OS (HAOS) + Add-ons

安装形态

形态适用难度
HAOSx86 / RPi / VM 整盘⭐
Container (Docker)已有 NAS / 服务器⭐⭐
Core (venv)Linux 高级用户⭐⭐⭐

核心概念

  • Entity：设备抽象（light.kitchen_ceiling、binary_sensor.door）
  • Device：1 个物理设备可包含 N 个 entity
  • Area：房间
  • Automation：触发器 + 条件 + 动作
  • Scene：一次性设置多个 entity 状态

自动化 (YAML)

alias: 回家开灯
trigger:
  - platform: state
    entity_id: person.alice
    to: home
action:
  - service: light.turn_on
    target:
      entity_id: light.living_room
    data:
      brightness: 200
      color_temp: 300

LLM 集成

  • OpenAI Conversation / Anthropic Conversation：内置集成，可让 LLM 控制 entity
  • Home Assistant Cloud (Nabu Casa)：可选远程访问 + 语音
  • Extended OpenAI Conversation：支持 Function Calling 风格的 entity 调用

⛔ 别这么做 (Anti-patterns)

经验证的坑 —— 跳过 = 至少浪费半天，严重的烧板 / 锁机。

❌ 错误做法💥 后果⚠️ 风险范围
不要在断电前直接拔 Valetudo 改装中的 USB-TTL刷机中途断电 = 变砖。先 dmesg 确认串口没掉再操作。🟡智米扫拖一体 / Roborock S5 Max
不要把米家设备 token 上传到任何第三方云token = 设备控制权，泄漏 = 任何人可远程开门。🔴所有米家 / Aqara 设备
不要在生产 HA 配置里直接编辑 configuration.yaml 后 check_config 不通过就 reload错的 reload 会让 HA 启动失败 → 所有自动化停摆。用 configuration.yaml 备份 + git 版本化。🟢Home Assistant
不要给 Frigate 摄像头内网用 admin/admin 默认密码RTSP / ONVIF 默认账号 = 局域网裸奔。先改密码。🟡海康 / 大华摄像头
不要在 ESPHome 设备上直接 OTA 升级到主版本 (major)主版本常改 NVS 分区。OTA 升级后启动失败 = 拆壳刷机。先 flash USB 一次。🟡ESP32-S3 语音卫星 / 智能开关
不要在智能家居自动化里写死设备 IPDHCP 重启后 IP 变 = 自动化失效。用 hostname / mDNS / 静态租约。🟢Home Assistant / Hubitat
不要在 Matter 设备首次配对时关掉手机蓝牙Matter 配对 = BLE → WiFi handover，全程需要蓝牙。🟢Aqara M3 / Apple Home

🚨 风险总览 (Risk Matrix)

风险等级含义例子
🟢 低改错可回滚 / 几分钟恢复pip 全局装包、DHCP IP 写死
🟡 中需要重新刷机 / 重装 / 1-2 小时恢复装错 ROS 2 版本、没 OTA 升级看版本
🔴 高不可逆 / 烧板 / 安全风险电池反接、micro-ROS 没看门狗、刷机中途断电

参考资料