首次配置引导向导详解
Onboarding 是什么
Home Assistant 在全新安装后会弹出一个 5 步浏览器向导（Onboarding），帮用户完成初始化配置。整个过程不需要命令行、不需要编辑配置文件，点来点去就能完成。
访问地址
- Home Assistant OS：
http://homeassistant.local:8123 - Docker：
http://<服务器IP>:8123
向导每一步顶部会显示你当前在哪一步（1/5、2/5 等）。
第 1 步：创建首个管理员账户
向导第一步要求创建管理员账户：
- 用户名：自己取一个，
admin也可以 - 密码：强密码，最好 12 位以上，包含大小写、数字和特殊字符
- 名字 / 姓氏：可选，Home Assistant 用它在通知里称呼你
- 位置：选择你的国家和时区（影响日落日出时间、天气数据等）
注意：密码一旦创建不能通过界面直接修改——要改得去 Settings → People → 你的用户 → Security → Change password。所以第一次就要设对。
第 2 步：网络设备自动发现
Home Assistant 启动后会自动扫描本地网络上的已知设备（通过 mDNS、UPnP、SSDP 等协议）。第 2 步会展示发现到的设备列表：
- 点击每个设备右边的 Configure 按钮逐个完成接入
- 某些设备需要在这个步骤配对（如 Philips Hue Bridge 按一下桥身上的按钮、Sonos 确认连接请求）
- 发现完所有设备后，点击 Next
不要急着跳过这一步——自动发现帮你省去了后续手动找每个集成的麻烦。但也可以先跳过，之后在 Settings → Devices & services 里手动添加。
第 3 步：时区与地区确认
虽然第 1 步已经选了国家和时区，第 3 步会再确认一次：
- Measurement system：选公制 / 英制
- Currency：选你常用的货币单位（影响 Energy Dashboard）
- Languages：界面语言（可以之后在 Settings 里改）
第 4 步：创建家庭（Areas）
Home Assistant 用 Areas（区域） 来组织设备。向导第 4 步会让你创建几个常用区域：
- 客厅、卧室、厨房、卫生间、书房…
- 可以之后随时加新区域或改名称
每个设备都可以归到一个区域，之后仪表盘的传感器、自动化触发条件就能按区域筛选。
第 5 步：完成
全部步骤完成后，Home Assistant 会自动把发现到的设备分配到你创建的区域，然后跳转到 Lovelace 仪表盘。恭喜你，Home Assistant 已经完全跑起来了！
之后要做的事（首次 Onboarding 之后）
Onboarding 只是最基础的配置，你还需要：
| 优先级 | 任务 | 路径 |
|---|---|---|
| 1 | 安装 HACS | 添加社区商店仓库 |
| 2 | 配置 Zigbee/Z-Wave 适配器 | Settings → Devices & services → Add integration |
| 3 | 配置 Energy Dashboard | Settings → System → Energy |
| 4 | 创建第一个自动化 | Settings → Automations & scenes → Create automation |
| 5 | 安装 Companion App | 手机 App Store / Google Play 搜索 Home Assistant |
| 6 | 配置远程访问 | Nabu Casa 或 DuckDNS + Let's Encrypt |
重置 Onboarding
如果你想重新走一遍 Onboarding（或者安装时跳过了、现在想补），可以：
- 备份你的配置（强烈推荐）
- 编辑
configuration.yaml，添加：
default_config:（如果已经有这行就不用加）
- 重启 Home Assistant
- 访问
http://homeassistant.local:8123/onboarding.html
实际上 Onboarding 只影响初始状态。之后绝大多数配置都可以通过 Settings 界面调整，不需要重走向导。