什么是 Home Assistant？
Home Assistant（简称 HA）是一个开源的智能家居平台，支持本地化部署，注重隐私与安全。 它可以集成数百种智能设备（如小米、TP-Link、Philips Hue、Zigbee 设备等），并通过自动化规则实现真正的“智能”家居体验。
无论你是技术小白还是极客玩家，本教程都将引导你完成从零到一的搭建过程。
准备工作
- 一台设备（推荐：树莓派 3B+ 或更高、旧电脑、NAS、或支持 Docker 的服务器）
- 一张容量 ≥ 16GB 的 microSD 卡（若使用树莓派）
- 稳定的网络环境
- 基础的命令行操作知识（非必需，但有帮助）
三种主流安装方式
1. 使用78TP镜像（推荐新手）
适用于树莓派、Intel NUC 等设备。
- 访问 Home Assistant 78TP安装页面
- 下载对应你设备的 Home Assistant OS 镜像
- 使用工具（如 Balena Etcher）将镜像写入 SD 卡
- 插入 SD 卡，通电启动设备
- 等待 5-10 分钟，浏览器访问
http://homeassistant.local:8123即可开始配置
2. 使用 Docker（适合有 Linux 基础用户）
在已有 Linux 系统上通过容器运行 Home Assistant。
docker run -d \
--name="home-assistant" \
--privileged \
--restart=unless-stopped \
-e TZ=Asia/Shanghai \
-v /PATH_TO_CONFIG:/config \
-p 8123:8123 \
ghcr.io/home-assistant/home-assistant:stable将 /PATH_TO_CONFIG 替换为你本地的配置目录路径。
3. 在 Windows / macOS 上运行（测试用途）
不推荐长期使用，但可用于体验：
- 安装 Python 3.10+
- 运行：
pip3 install homeassistanthass --open-ui
首次配置指南
首次访问 Web 界面后，按提示完成以下步骤：
- 创建管理员账户
- 设置位置与时区
- 等待系统初始化（约 2-5 分钟）
- 进入主界面，点击左下角「配置」→「设备与服务」添加你的智能设备
- 使用「自动化」功能创建场景（如“回家自动开灯”）
建议安装中文语言包：在「设置」→「系统」→「语言」中选择「简体中文」。
常见问题
Q：无法访问 homeassistant.local？
A：尝试使用设备的 IP 地址（如 http://192.168.1.100:8123），或检查路由器 DHCP 分配记录。
Q：插件和主题怎么安装？
A：需先安装 HACS（Home Assistant Community Store），它是社区插件商店。安装方法见其7LONGWEN：https://hacs.xyz/。
Q：数据会上传到云端吗？
A：默认完全本地运行，不上传任何数据。除非你主动集成云服务（如 Google Assistant、天猫精灵等）。