—— 硬件选型、系统安装、设备接入、自动化场景配置全攻略
【文档说明】本文档面向希望搭建家庭智能家居系统但没有经验的读者。从最基础的硬件选型开始，到HomeAssistant系统安装、各类设备接入、传感器配置、自动化场景搭建、语音助手集成、远程访问等全流程。中文写作，全程手把手教学。全文约16000字。
第一章：HomeAssistant是什么？
1.1 为什么需要HomeAssistant？
HomeAssistant（简称HA）是一个开源的家庭自动化平台，它的核心理念是"将所有智能设备统一到一个平台上控制"。你家里可能已经有一些智能设备——小米智能灯、Yeelight吸顶灯、美的空调、天猫精灵、智能门锁、传感器等。但这些设备通常各自有自己的App，无法互相联动。小米的设备不能控制美的空调，天猫精灵无法读取小米传感器的数据。HomeAssistant解决了这个问题——它支持超过2000个品牌和设备的集成，可以在一个界面中统一管理和自动化所有设备。
HomeAssistant的主要功能包括：统一控制面板（在一个Web界面或手机App中控制所有智能设备）、自动化和场景联动（"当室外温度超过35度且家中无人时，自动关闭窗帘和窗户"）、语音助手集成（通过"小爱同学"或Amazon Alexa控制）、本地化运行（所有自动化逻辑在本地运行，即使断网也能正常工作）、强大的自定义能力（通过YAML配置或可视化编辑器创建复杂的自动化逻辑）。
1.2 主流智能家居平台对比
平台 | 价格 | 本地化 | 设备支持数 | 复杂度 | 开放性 |
HomeAssistant | 完全免费 | 完全本地 | 2000+品牌 | 中等 | 完全开源 |
HomeKit | 免费（需苹果设备） | 本地化 | 有限 | 低 | 封闭生态 |
米家App | 免费 | 云端为主 | 大量小米生态 | 低 | 半封闭 |
天猫精灵 | 免费 | 云端 | 中量 | 低 | 封闭 |
Google Home | 免费 | 云端 | 中量 | 低 | 封闭 |
1.3 HA的三种安装方式
HomeAssistant有几种不同的安装方式，适合不同的硬件和技术水平：
第一种：HA OS（推荐新手）。直接安装HA操作系统到树莓派或x86小主机上，系统自带所有功能，管理最简单。适合：专门用一台设备运行HA。安装便捷度最高，但硬件利用率单一。
第二种：HA Container（Docker部署）。在已有的Linux系统上通过Docker运行HA。适合：已经在运行家庭服务器的用户。资源利用率高，可以与其他服务共存。但需要一定Docker基础。Docker命令：docker run -d --name homeassistant --restart unless-stopped -v /opt/ha/config:/config --network=host ghcr.io/home-assistant/home-assistant:stable
第三种：HA Core（纯Python）。直接在操作系统上安装HA Python程序。适合：熟悉Linux的高级用户。灵活性最高但安装最为复杂。
对于没有技术背景的用户，强烈推荐第一种方式（HA OS）。
第二章：硬件选型与系统安装
2.1 运行HA的硬件选择
运行HA需要一台24小时开机的设备。不同的硬件方案各有优劣：
硬件方案 |
