如果您的智能家居已经变成一堆各自为政的应用，灯一个、冷气一个、门磁传感器又一个，那么 Home Assistant 也许正是把它们串起来的那根线。这篇 Home Assistant 新手指南会说明这个开源平台是什么、为什么有人选它而不选商业中枢、需要什么硬件，以及如何在一般的新加坡组屋或公寓里完成第一套可用的设置。
Home Assistant 是一款免费、由社区驱动的软件，运行在您家中的一台小电脑上。它可以连接许多不同品牌的设备，让您在同一个控制面板上操控并自动化它们，而且很多工作在本地完成，而不是在某家公司的云端。它很适合喜欢折腾的人，但现在入门已经不需要会写程序了。
Home Assistant 与商业中枢有什么不同
Google Home、Amazon Alexa 和 Apple Home 等商业生态系统打磨精良、简单易用，但它们最适合搭配支持自家平台的设备，而且许多自动化依赖云服务。我们的智能家居中枢与网桥指南详细介绍了这些选择。Home Assistant 走的是另一条路：
- 本地控制。许多集成直接通过家庭网络与设备通信，所以即使断网，自动化也能继续运行。
- 不挑品牌。由社区和设备厂商开发的数千个集成，涵盖灯具、插座、冷气控制器、扫地机器人、摄像头、太阳能逆变器等等。
- 隐私。默认情况下，您的数据保存在自己的硬件上。
- 灵活。自动化可以使用条件、定时器、传感器数值和太阳位置，远远超出简单的「如果这样，就那样」规则。
代价是您得自己当系统管理员：负责更新、备份，偶尔还要处理出故障的集成。它也能和商业语音助手和平共处，所以您仍然可以通过智能音箱进行语音控制。
需要什么硬件
Home Assistant 需要一台全天候开机的设备。常见选择：
| 选项 | 是什么 | 适合谁 |
|---|---|---|
| 官方成品主机 | Home Assistant 项目出售的即插即用硬件，预装好软件 | 想最轻松上手的新手 |
| 树莓派（Raspberry Pi） | 小型单板电脑，需要自己安装 Home Assistant OS | 愿意动手做点设置的爱好者；为了稳定，建议用 SSD 而不是存储卡 |
| 迷你电脑或旧笔记本 | 改作他用或小巧的电脑，运行 Home Assistant OS | 需要更强性能来处理摄像头、语音和大量加载项 |
| NAS 或服务器上的虚拟机 | 在您已有的硬件上与其他软件一起运行 | 家里已经有服务器的人 |
对大多数新手来说，官方主机或运行 Home Assistant OS（完整安装方式）的迷你电脑是最顺畅的路线，因为它自带加载项商店和简单的备份功能。推荐硬件和安装方式会不断更新，请到 Home Assistant 官方网站查看最新信息。
您可能还需要一个用于无线协议的无线电适配器（dongle）：
- Zigbee：许多平价传感器、按钮和灯泡都使用它。USB Zigbee 协调器能让 Home Assistant 直接和这些设备通信，不需要每个品牌各自的网桥。
- Thread 和 Matter：较新的标准，目的是让设备能跨生态系统使用。Home Assistant 支持它们，部分官方硬件已内置所需的无线模块。
插 USB 适配器时，请用一根短延长线让它远离电脑，因为 USB 3 接口可能干扰 Zigbee 信号。
第一次设置，一步一步来
- 安装 Home Assistant：按照官方指南安装到您选定的硬件上，尽量用网线把它连到路由器。
- 打开网页界面：在同一网络下的浏览器中打开，创建管理员（owner）账户。请使用强密码。
- 设置位置、时区和单位。这关系到日出日落类自动化；请选择新加坡和公制单位。
- 让它自动发现设备。Home Assistant 通常能检测到网络上兼容的设备，例如智能电视、打印机、音箱和部分 Wi-Fi 插座。把您需要的加进去。
- 添加集成：对没有被自动发现的设备手动添加，例如使用云账户的扫地机器人或空气净化器。
- 在手机上安装配套应用。它能让您远程控制家中设备（需设置好合适的远程访问），还能把手机位置当作「到家」传感器。
- 按区域整理。把每台设备分配到房间：客厅、主卧、厨房。这样做控制面板和自动化都会容易得多。
- 设置自动备份，并把备份副本存放在 Home Assistant 设备以外的地方。
远程访问需要好好考虑。可以选择项目的付费云订阅（同时也支持平台的开发），或者自己搭建安全的 VPN。不要在不了解安全影响的情况下，直接在路由器上开放端口把 Home Assistant 暴露到互联网上。
可以先试试的简单自动化
从小处开始，确认能用，再逐步扩展。适合新加坡家庭的点子：
- 日落时开客厅灯，但仅在有人在家时。
- 全家出门后关冷气，利用手机判断是否在家。如果您的冷气不是智能款，可以用红外遥控器（IR blaster）发送遥控信号。
- 门或闸门传感器提醒：大门开着超过几分钟，就向手机发送通知。
- 漏水提醒：在厨房水槽下或洗衣机旁放一个小型漏水传感器。
- 除湿机或风扇控制：在潮湿的季风月份，根据湿度传感器的读数，通过额定功率适合该电器的智能插座来开关。
- 睡前场景：按一个按钮，关掉公共区域的灯、锁上智能门锁，并把卧室冷气切换到设定模式。
自动化在可视化编辑器中搭建，分三部分：触发器（什么启动它）、条件（必须满足什么）和动作（会发生什么）。社区提供的「蓝图」（blueprints）是现成模板，可以导入后再调整。我们的居家安全智能传感器一文有更多关于哪些传感器值得买的建议。
新加坡家庭的小贴士
- 混凝土墙会阻挡信号。组屋和公寓的墙体会削弱 Wi-Fi 和 Zigbee 信号。插电的 Zigbee 设备（例如插座）可以充当中继，增强网状网络，所以在房间之间放几个。
- 留意电气规格。智能插座和开关应适用于新加坡的 230V 电压和 G 型插座，并带有相应的本地安全认证标志。任何涉及固定线路的工作，例如更换墙壁开关，都应由持牌电工完成。
- 顾及房东。如果您是租房，优先选择插电式设备和用可移除背胶固定的电池传感器，避免改动房屋固定装置。
- 停电。一台小型 UPS（不间断电源）可以保护 Home Assistant 设备及其数据，免受突然断电的影响。
新手常犯的错误
- 还没确认设备有可靠的集成就大量购买。先查一下官方集成列表。
- 用便宜的存储卡运行，几个月不停读写后就坏了。
- 不做备份，一次更新失败就前功尽弃。
- 一口气搭建十几个复杂的自动化，出了问题也不知道是哪一个。
- 大版本发布当天就立刻更新。先读一读更新说明（release notes），可以避免意外。
Home Assistant 有一个庞大而热心的社区论坛，以及详尽的官方文档。一次搞定一个房间，几个周末下来，您就会拥有一个按自己方式运转的智能家居。如果您还在考虑整体方案，不妨先读读如何选择智能家居生态系统。