Home Assistant 安装指南

Home Assistant 是一个开源的智能家居自动化平台，支持本地部署、隐私优先，并兼容数百种智能设备。本专题页将为你提供清晰、简洁的安装方法，帮助你快速上手。

1. 准备工作

在安装前，请确认以下事项：

• 一台可长期运行的设备（如树莓派、旧电脑、NAS 等）
• 稳定的网络连接
• 至少 8GB 的 microSD 卡（若使用树莓派）
• 基础的命令行操作知识（非必需，但有帮助）

2. 安装方式推荐

根据你的设备和需求，选择最适合的安装方式：

1. Home Assistant OS（推荐新手）：专为 Home Assistant 打造的操作系统，一键刷入，自动更新。
2. Docker 安装：适合已有 Linux 服务器或 NAS 用户，灵活可控。
3. Python 虚拟环境安装：适合开发者或高级用户，完全自定义。

3. 使用 Home Assistant OS 安装（以树莓派为例）

1. 访问 78TP安装页面 下载适用于你设备的镜像。
2. 使用工具如 Raspberry Pi Imager 或 BalenaEtcher 将镜像写入 SD 卡。
3. 将 SD 卡插入树莓派，接通电源和网线。
4. 等待 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 卡性能良好。