Home Assistant 安装指南
Home Assistant 是一个开源的智能家居自动化平台,支持本地部署、隐私优先,并兼容数百种智能设备。本专题页将为你提供清晰、简洁的安装方法,帮助你快速上手。
1. 准备工作
在安装前,请确认以下事项:
- 一台可长期运行的设备(如树莓派、旧电脑、NAS 等)
- 稳定的网络连接
- 至少 8GB 的 microSD 卡(若使用树莓派)
- 基础的命令行操作知识(非必需,但有帮助)
2. 安装方式推荐
根据你的设备和需求,选择最适合的安装方式:
- Home Assistant OS(推荐新手):专为 Home Assistant 打造的操作系统,一键刷入,自动更新。
- Docker 安装:适合已有 Linux 服务器或 NAS 用户,灵活可控。
- Python 虚拟环境安装:适合开发者或高级用户,完全自定义。
3. 使用 Home Assistant OS 安装(以树莓派为例)
- 访问 78TP安装页面 下载适用于你设备的镜像。
- 使用工具如
Raspberry Pi Imager 或 BalenaEtcher 将镜像写入 SD 卡。
- 将 SD 卡插入树莓派,接通电源和网线。
- 等待 5–10 分钟,浏览器访问
http://homeassistant.local:8123 即可进入初始设置界面。
4. 首次配置
首次启动后,你需要:
- 创建管理员账户
- 设置位置与时区
- 添加你的智能设备(如通过 MQTT、Zigbee、Wi-Fi 等协议)
5. 常见问题
Q:无法访问 homeassistant.local?
A:尝试使用设备的 IP 地址(如 http://192.168.1.100:8123),或检查路由器中的设备列表。
Q:安装后卡在“正在加载”?
A:首次启动可能需要较长时间(10–15 分钟),请耐心等待。确保 SD 卡性能良好。