3、初始配置：完成首次启动向导、设置用户、区域、时区、语言以及基础系统设置

当 Home Assistant（以下简称 HA）首次启动时，系统会进入一个引导性质的配置流程，官方称之为“首次启动向导”（Getting Started）。这一阶段是 HA 从“一个运行中的程序”转变为“一个属于你的智能家居中枢”的关键节点。很多初学者在这一步容易因为急于进入界面而随意选择时区或跳过某些设置，导致后续自动化脚本中出现时间偏差、天气服务定位错误、甚至无法通过外部网络访问等问题。本章将系统拆解首次启动向导的每一个环节，帮助你理解每个选项背后的逻辑，并给出适合不同部署环境（树莓派、NUC、虚拟机、Docker）的配置建议。

3.1 首次启动向导的核心原理与前置条件

HA 的首次启动向导本质上是一个“最小化可用配置”的引导程序。它并不要求你在这一阶段完成所有设置，而是通过几个关键选项，让系统能够正确理解“你在哪里”“你使用什么语言”“你的家叫什么名字”。这些信息会被写入 HA 的存储层（.storage 目录下的 JSON 文件）以及 configuration.yaml 主配置文件中。向导完成后，HA 会启动一个名为 homeassistant 的默认区域（Zone），并将你设置的住宅名称作为该区域的实体名称前缀。

在开始向导之前，请确认以下前置条件：

• 网络连通性：HA 需要访问互联网以下载部分组件（如语音助手、天气集成等），但核心向导本身不强制联网。
• 设备时间同步：如果你的安装设备（如树莓派）没有正确同步时间，向导中的时区设置可能无法生效，建议先通过 date 命令检查系统时间。
• 浏览器兼容性：推荐使用 Chrome、Edge 或 Firefox 的最新版本，Safari 在部分旧版本上可能存在 WebSocket 连接问题。
• 访问地址：通过 http://<设备IP>:8123 访问向导页面。如果是 Docker 部署，请确认端口映射正确。

3.2 向导各步骤操作流程与参数说明

首次启动向导共分为四个主要步骤，每个步骤对应一组配置项。下面逐一拆解每个步骤的操作要点和参数含义。

步骤一：创建管理员账户

这是向导的第一步，也是最重要的一步。你需要设置一个用户名和密码，该账户拥有 HA 系统的最高权限。密码建议使用至少 12 位混合字符（大小写字母+数字+符号），因为该账户不仅用于登录 Web 界面，还用于生成 API 长期访问令牌（Long-Lived Access ），供第三方应用（如手机 App、Node-RED）调用 HA 接口。

# 示例：创建账户时的推荐密码策略
用户名：admin
密码：Ha@2024#Secure!
确认密码：Ha@2024#Secure!

创建完成后，HA 会在 .storage/auth 目录下生成对应的认证凭证。请注意，此账户与操作系统层面的用户无关，是 HA 应用层的独立账户体系。

步骤二：设置住宅名称与位置

住宅名称默认显示为“我的家”（My Home），你可以将其修改为更具辨识度的名称，例如“阳光花园公寓”或“Smith Residence”。这个名称会作为 HA 中所有与“家”相关的实体前缀，例如 zone.sunshine_apartment。如果你后续配置了多个区域（如办公室、度假屋），这个名称将用于区分不同区域的自动化场景。

位置信息（经纬度）在向导中通常通过“地图选点”或“输入城市名称”的方式完成。HA 会根据该位置自动计算日出日落时间、时区偏移，并用于天气集成（如 OpenWeatherMap）的默认定位。如果你不希望暴露精确位置，可以只填写城市级别，但这样会导致日出日落时间存在几分钟误差。

步骤三：选择时区、语言与单位制

时区设置直接影响所有自动化规则中的时间判断。例如，如果你设置的是 UTC 而非 Asia/Shanghai，那么“早上 7 点开灯”的自动化会在北京时间下午 3 点触发。语言选项决定 HA 前端界面的显示语言，目前简体中文（zh-Hans）已得到完整支持。单位制则影响温度（°C/°F）、风速（km/h 或 mph）、气压（hPa 或 inHg）等显示值。

步骤四：完成向导并进入主界面

点击“完成”后，HA 会进行约 30 秒的初始化加载，然后进入主仪表盘。此时系统尚未安装任何集成（Integration），但已经具备以下基础能力：用户认证、区域管理、日志记录、服务调用框架。你可以立即开始添加设备，也可以先进行基础系统设置。

3.3 基础系统设置：向导完成后的关键配置

向导完成后，建议按以下顺序进行基础系统设置，这些设置将影响 HA 的长期稳定运行和可维护性。

3.3.1 用户管理与权限分组

在“设置 → 人员”中，你可以添加家庭成员或访客账户。HA 支持三种权限角色：管理员（Admin）、用户（User）和只读（Read-Only）。管理员拥有全部权限；用户可以操作设备和服务，但不能修改系统配置；只读用户仅能查看状态。对于家庭场景，建议为每位成员创建独立账户，避免共用管理员账户带来的安全风险。

3.3.2 网络与外部访问配置

默认情况下，HA 只能通过局域网 IP 访问。如果你需要在外出时远程控制家庭设备，有两种主流方案：

1. Nabu Casa 云服务：HA 官方提供的付费云隧道服务，无需公网 IP 和端口转发，配置简单，延迟较低，同时支持 Alexa/Google Home 语音集成。
2. 反向代理（如 Nginx + Let's Encrypt）：适合已有域名和公网 IP 的用户，需要配置 SSL 证书和端口转发，灵活性更高但维护成本较大。

在“设置 → 系统 → 网络”中，你可以查看当前内网 IP、端口（默认 8123）以及是否启用了 SSL。如果你使用 Docker 部署，请确保端口映射正确，例如 -p 8123:8123。

3.3.3 日志与备份策略

HA 的日志文件位于 /config/home-assistant.log（Docker 或 HAOS 路径）。在“设置 → 系统 → 日志”中，你可以实时查看系统日志，并调整日志级别（调试、信息、警告、错误）。对于生产环境，建议开启“自动备份”功能，备份内容包括 configuration.yaml、.storage 目录以及自定义脚本。备份文件默认存储在 /backup 目录，你可以通过 Samba 或 Google Drive 插件将其同步到外部存储。

3.4 案例拆解：从向导到首个自动化——一个完整的配置闭环

下面通过一个实际案例，展示从首次启动向导到完成基础系统设置后，如何快速验证配置是否正确。

背景与约束：用户“小林”使用树莓派 4B（4GB 版本）安装了 HAOS，计划实现“日落时自动开启客厅灯”的自动化。树莓派通过 Wi-Fi 连接家庭网络，路由器 DHCP 分配的 IP 为 192.168.1.100。

初始现象与目标：完成向导后，小林发现自动化测试时灯光没有按预期触发。检查日志发现，自动化触发时间比实际日落时间晚了 1 小时。

关键输入数据与日志：在“开发者工具 → 状态”中查看 sun.sun 实体，发现 next_setting 属性显示为 UTC 时间（如 18:30 UTC），而小林所在时区为 UTC+8，实际日落应为次日 02:30。这说明时区设置未生效。

分析判断过程：小林检查“设置 → 系统 → 常规”，发现时区显示为 UTC，而非 Asia/Shanghai。原因是在向导中，小林误以为“UTC”是国际标准时间，没有修改为本地时区。

实际操作步骤：

1. 进入“设置 → 系统 → 常规”，将时区修改为 Asia/Shanghai。
2. 点击“保存”后，系统提示需要重启。小林选择“重启”按钮。
3. 重启完成后，再次查看 sun.sun 实体，确认 next_setting 已显示为本地时间（如 18:30）。
4. 重新测试自动化，灯光在日落时正常开启。

结果对比与复盘：修复后，自动化触发时间准确。小林复盘发现，如果他在向导中仔细阅读时区选项的说明，本可以避免这个问题。此外，他还发现住宅名称设置为“小林的温馨小屋”后，所有相关实体都带上了这个前缀，例如 zone.xiaolins_warm_home，这有助于在自动化中快速识别区域。

3.5 常见误区与总结复盘

在首次配置过程中，以下误区最为常见，需要特别注意：

• 误区一：跳过位置设置。如果不设置经纬度，HA 将无法计算日出日落时间，导致“日落开灯”类自动化失效。即使你不需要天气功能，也建议设置一个大致位置。
• 误区二：使用弱密码。HA 的管理员账户如果被暴力破解，攻击者可以控制你所有的智能设备。建议启用两步验证（2FA），在“用户 → 安全”中开启。
• 误区三：忽略单位制。如果你后续接入的是美版智能设备（如某些温控器），它们可能默认使用华氏度，而 HA 全局单位制设置为摄氏度时，会出现数值换算混乱。
• 误区四：直接修改 configuration.yaml 而不重启。虽然 HA 支持热加载部分配置，但时区、语言等基础设置必须重启才能生效。

总结复盘：首次启动向导是 HA 使用体验的“第一印象”，也是后续所有自动化逻辑的基石。建议在向导完成后，花 10 分钟检查“设置 → 系统 → 常规”中的所有选项，确保时区、语言、单位制符合你的实际需求。同时，为管理员账户开启 2FA，并创建独立的家庭成员账户。最后，配置一次自动备份，并手动触发一次备份验证文件完整性。这些基础工作虽然看似琐碎，但能避免未来数月内因配置错误导致的排查困扰。