Home Assistant 智能家居中枢 完整中文文档
关于本站：第三方整理的中文文档站，非官方页面；内容来自公开资料整理，功能与界面以官方最新版为准。
Home Assistant 是什么
Home Assistant 是一个本地优先、隐私为上的开源智能家居自动化平台。它运行在用户自己的硬件上（树莓派、迷你主机、NAS 乃至 x86 台式机），把 Zigbee、Z-Wave、Matter、WiFi、蓝牙 LE 等异构协议的设备全部汇入同一张网络，再通过可视化的自动化引擎和可定制的仪表盘，让用户摆脱米家、Apple HomeKit、Amazon Alexa 等单一生态的束缚，真正掌控自己的智能家居。
产品档案速览
| 项目 | 信息 |
|---|---|
| 项目类型 | 开源智能家居自动化平台 |
| 授权协议 | Apache License 2.0 |
| 开发语言 | Python（核心）、TypeScript（前端）、Go（部分组件） |
| 运行环境 | 本地运行，支持 aarch64 / amd64 |
| 安装方式 | Home Assistant OS / Container（Docker） |
| 集成数量 | 1500+ 官方集成，数千社区集成 |
| 设备协议 | Matter、Thread、Zigbee、Z-Wave、WiFi、Bluetooth LE |
| 官方硬件 | Home Assistant Green、Connect ZBT-1/ZBT-2/ZWA-2、Voice Preview Edition |
| 语音助手 | Assist（本地优先，可选 Nabu Casa 云服务） |
| 能源监控 | 内置 Energy Dashboard |
| 社区生态 | HACS（社区商店）、Node-RED、ESPHome |
| 移动端 | 官方 Companion App（iOS 16.4+ / Android 6+） |
| 隐私架构 | 默认本地存储、本地执行逻辑、零云依赖 |
为什么选择 Home Assistant
Home Assistant 的核心主张可以浓缩为三句话：
- 本地控制 — 所有状态、实体、自动化逻辑全部在本地执行，断网时家照样运转。
- 隐私第一 — 默认不向云端发送任何数据；即使使用 Nabu Casa 云服务做远程访问，云端也无权读取你的实例。
- 生态中立 — 支持 1500+ 种设备和服务，不绑定任何厂商，可以自由混搭小米、飞利浦 Hue、三星 SmartThings、Aqara、Sonoff 等品牌。
结构导览
本站点覆盖 Home Assistant 的完整使用链路，按以下分组组织：
| 分组 | 核心内容 |
|---|---|
| 平台定位 | 产品定义、本地优先理念、适用人群、安装变体对比 |
| 部署指南 | 硬件选型、Home Assistant OS 刷写、Docker 容器化、首次引导向导 |
| 仪表盘配置 | Lovelace 卡片类型、拖拽布局、HACS 自定义卡片、主题美化 |
| 自动化编排 | 可视化编辑器、触发器、条件、动作、蓝图、YAML 进阶 |
| 设备互联 | Matter/Thread 新协议、Zigbee/Z-Wave USB 适配器、WiFi/BLE 设备 |
| 能源管理 | 太阳能发电、电池存储、电网交互、EV 充电桩监控 |
| 语音控制 | Assist 语音助手、本地 Pipeline 搭建、AI 人格定制、硬件选型 |
| 扩展生态 | HACS 社区商店、Node-RED 流程编辑器、ESPHome DIY 设备、Jinja2 模板 |
| 架构运维 | 实体/服务/状态模型、事件总线、备份恢复、远程访问方案 |
| 移动端 | Companion App 功能全景、位置追踪 Presence、推送通知 |
| 故障排查 | 设备离线、配对失败、自动化不触发等常见问题定位与修复 |