什么是 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、天猫精灵等)。