什么是 Home Assistant：开源家庭中枢

为什么家里需要一个中枢

很多人对智能家居的期待其实是这样的：晚上回到家，推开门灯就亮了；空调在你进门前十分钟已经调好；睡觉时说一句关灯，全屋的灯都灭；出门后突然想起熨斗没拔，打开手机看一眼就知道。这些场景单靠某一家厂商的 App 很难全做到——因为灯是 A 家的、空调是 B 家的、窗帘是 C 家的，而你的生活习惯把它们串在了一起。

所谓家庭中枢（Hub），就是把家里所有智能设备拉到一起的那个中心：一个统一界面查看所有设备状态，一套统一的自动化规则驱动它们协同，一份统一的历史数据供你回看。没有人愿意在睡觉前打开五个 App 依次关灯，而中枢存在的意义就是让这些事一次性发生。Home Assistant（下面统一简称 HA）就是目前最活跃、生态最完整的开源家庭中枢方案。

HA 的出身与性格

HA 诞生于 2013 年，创始人 Paulus Schoutsen 最初只是想写一个脚本能顺手关掉家里的灯。十多年过去，它已经长成全球最大的开源智能家居项目之一：数千名贡献者参与开发，几乎每月都有新版本，新协议和新设备支持的跟进速度常常比商业平台还快。本书写作时的稳定版仍在快速迭代，所以全书不写死具体版本号，只讲那些不随版本大变的概念与操作——这也是本书的写作原则：先理解原理，操作照着界面走就行。

HA 的性格很鲜明，理解这几点比记住任何配置都重要：

• 本地优先：设备状态和自动化逻辑跑在你自己的硬件上，家里断宽带也能执行场景、查看状态。云只是远程访问的通道，不是大脑。这一点对国内网络环境尤其友好。
• 协议包容：Zigbee、Z-Wave、Wi-Fi、蓝牙、Matter、HomeKit 统统能接，不挑品牌、不搞围墙花园。哪怕某天厂商倒闭了，只要协议还在，设备在 HA 里就能继续用。
• 可控性极强：既可以在图形界面里点点按按，也可以把配置写成 YAML 放进 Git 做版本管理，新手和老手都能找到舒适的姿势。
• 核心完全免费：HA 的核心代码开源免费，唯一的官方收费项是 Nabu Casa 远程访问订阅，属于可选项，不订也不影响任何本地功能。

中枢、网关与平台不是一回事

刚入坑时很容易把三个概念混成一团，这里先厘清，后面整本书都建立在这个区分上：

一句话总结：云平台省心但听命于厂商，网关是厂商顺手给你装的半套本地方案，HA 则是把控制权彻底拿回自己家里的那一套。很多玩到一半的人会同时保留三者——用云平台的新设备试水，趁手的设备慢慢迁进 HA，这并没有问题，中枢本来就应该是渐进式的。

HA 的三种部署形态

装 HA 之前要先做一道选择题。它有三种部署形态，第 2 章会手把手演示，这里先建立整体印象：

如果你已经照着自建 NAS 完全指南装好了一台 NAS，那么 Container 形态几乎是零成本追加——NAS 本就 7×24 小时开机，多跑一个容器而已。如果你打算专用一台小主机跑智能家居，HA OS 最顺手，连备份、恢复、插件管理都打包好了。

HA 生态里的几个角色

读 HA 资料时你会反复遇到几个词，先混个脸熟，后面章节会一一展开：

• 集成（Integration）：HA 与外部设备或服务对接的插件，比如米家集成、HomeKit 集成。每接入一个品牌就是装一个集成。
• 实体（Entity）：设备在 HA 里的抽象表示，一个灯、一个温度传感器、一个开关各自是一个实体，自动化和仪表盘都围绕实体组织。
• Add-on：装在 HA OS 里的周边服务，比如代码编辑器、Node-RED、Mosquitto MQTT 代理，类似应用商店里的 App。
• Blueprint：社区分享的自动化模板，导入后填几个参数就能用，不想写逻辑的时候直接抄作业。
• HACS：第三方的插件商店，提供官方商店没有的集成、主题和前端组件，生态的一半活力来自这里。

HA 适合什么样的家庭

虽然 HA 谁都能装，但它带来的爽感在不同家庭里差别很大。下面这张清单可以帮你判断值不值得入坑，符合的条目越多，回报越明显：

• 家里已有三个以上品牌的智能设备，App 切换已经开始烦人。
• 家里有常开的 NAS、软路由或小主机，硬件成本趋近于零。
• 对数据隐私比较在意，不喜欢家里的作息存在厂商服务器上。
• 喜欢折腾，把配置调顺本身就是乐趣的一部分。
• 家里网络环境复杂，希望某些控制不依赖云端也能工作。

如果你只勾上一两条，比如只有一个品牌的几盏灯，那么继续用厂商 App 也挺好的——HA 不是必需品，它是当你想把控制权收紧时才需要的东西。这点本书不会忽悠你。

新手最关心的几个问题

在正式动手之前，先回答几个几乎每个人都会问的问题：

要不要一直开着电脑？ 不用。HA 跑在低功耗设备上即可，树莓派功耗几瓦，NAS 或软路由本来就是常开的。功耗远低于你为了智能家居留一盏灯。

会不会很难？ 装起来不难，装好后慢慢玩。难的是克制——设备越接越多之后，自动化会越写越复杂，到时候你就理解什么叫过度设计了。

出了问题谁负责？ 这是开源项目的现实：没有客服，但有社区。HA 的官方论坛、GitHub 讨论区和中文社区都相当活跃，常见问题几乎都能搜到答案。本书也会在每章给出排错思路。

要不要追新版本？ HA 每月一个版本，没必要每次都跟。稳定用上几个月，等有大功能更新或者安全修复时再升级，升级前记得先备份——这件事第 2 章会反复强调，因为它真的能救命。

学 HA 需要什么基础

实话实说，HA 的学习曲线确实比普通 App 陡，但远没到劝退的程度。它的难点不在技术，而在概念多——集成、实体、区域、蓝图、模板这些词一股脑涌出来，容易被吓住。但每一个概念对应到家里都是具体的东西，比如实体就是你家那盏灯，区域就是客厅。花一个下午把概念对上号，后面全是顺水推舟。

• 会用命令行和 Docker，部署就是十分钟的事；完全不会也没关系，HA OS 路线全程图形化，像装手机系统一样简单。
• 自动化用图形编辑器拖拽条件和动作即可，只有复杂逻辑才需要写 YAML，而且官方文档和社区里有大量现成示例可以直接抄。
• 最值钱的能力其实是梳理自家的设备清单和生活习惯，技术只是手段。先想清楚要让家变成什么样，再回头查用什么功能，学起来会顺很多。
• 英语阅读能力有帮助但不是必需。翻译软件配上，大部分文档和报错都能对付；中文社区的沉淀也足以支撑常见需求。

一个常见的心智陷阱是：把 HA 当成一次性的装修工程。它更像一座花园，装好只是开始，后面随着设备增加和家人反馈不断修剪。接受这一点，过程本身就会变得有意思。

本书怎么读

全书 20 篇，按四章组织：第 1 章建立概念（你正在读的部分）；第 2 章完成安装和初始化，让 HA 在你家跑起来；第 3 章把各种设备接入进来；第 4 章讲日常使用——仪表盘、通知、语音和远程访问。建议顺序读，但每一章都尽量写得独立可查，将来你随时随地回来翻某一篇也能看懂。书里的操作以图形界面为主、YAML 为辅，遇到版本差异时以你眼前界面上的提示为准。

延伸阅读

• 软路由入门指南：HA 常驻的网络环境怎么搭、端口和 DNS 怎么管
• 群晖 DSM 实用指南：用群晖跑 HA Container 的前置知识