首次配置：网络、时区与用户

初始化向导长什么样

HA 跑起来之后的第一次打开，是一个简短的初始化向导，全程图形化，几分钟就能走完。向导本身没什么难度——无非是建账户、填位置、选时区这些——但每一步背后的选择会影响后面所有自动化行为。填错一个时区，你写的每一条定时规则都会在错误的时间触发。本篇把向导的每一屏拆开讲，重点说你可能没意识到的填坑点。

创建管理员账户

第一件事是创建本机管理员账户。注意三点：

• 这个账户数据库存在本地，不经过任何云端，密码复杂度你自己说了算。
• 记住它——HAOS 没有找回密码的传统流程，丢了只能走重置或命令行改密码的硬路。用密码管理器存好，一劳永逸。
• 家人不需要用这个账户，后面可以给每个家人建普通用户账户，仪表盘权限分开管。
• 密码里不要用英文双引号等特殊字符，某些 YAML 配置场景下特殊字符会带来麻烦——用长一点但常规的字符组合最稳妥。

一个常见的组织方式：管理员账户只归你用，管配置管自动化；家人的账户走各自的用户名，只看和用。这比全家共用一个账户干净得多，出问题也好排查是谁的操作引起的。

给家人建普通账户

向导走完后，建议立刻在用户管理页面把家里人也加上。HA 的多用户体系支持每个人独立的仪表盘视图和权限，家人登录后看到的是各自的设备状态，而不是你那一屏密密麻麻的工程师视图。

几条配置家人账户的经验：

• 名字用真名或称呼，自动化日志里会出现操作者，认得出是谁很重要。
• 不熟悉的人只给只读权限，老人小孩尤其如此，防止误操作改掉关键配置。
• 先建一两个人的账户试用，把权限模型跑顺了再加全家人。
• 家人账户不影响通知推送，通知该发给谁还是在自动化里单独配。
• 每个用户的仪表盘视图互相独立，给不同的人看不同的卡片是完全正常的用法。

语言与地区偏好

向导会让你选界面语言。中文界面目前覆盖基本完整，个别新功能的翻译可能滞后于英文，遇到看不懂的菜单切英文对照一下就能对上。地区偏好不只影响语言，还影响温度、风速等显示格式、以及天气集成的默认数据源地区。全部选中国大陆即可，没什么犹豫的。

位置与时区：自动化灵敏度的根基

向导会让你填家的位置（城市级别即可）和时区。这两个看似不起眼的设置，直接决定三件事：

• 日出日落自动化：HA 根据经纬度自己算每天几点天黑，天黑开灯这类规则全靠它。位置填错，自动化就跟着错——你以为灯是定坏的，其实是位置坏的。
• 历史记录的时间戳：时区错了，你看到的所有图表时间都会差几个钟头，排查问题时很容易被带偏，甚至怀疑是设备坏了。
• 天气预报和气象实体：天气集成取的是你填的位置附近的数据，填到隔壁城市，下雨提醒天天误报。

填位置时不需要精确到门牌号，城市级坐标足够，反正日出日落只差秒级。另外它存在本地服务器，不往任何云端发送，隐私上不必担心。

如果发现了设置错的地方也不用慌，这些在设置页里都能随时改，改完日出日落等数据会自动重算。

网络与访问地址

首次配置之后，确认一遍 HA 监听的网络设置。默认情况下 HA 监听所有网卡的 8123 端口，局域网内任意设备打开 http://你的内网IP:8123 就能访问。HTTP 访问在本阶段完全够用，等以后配置远程访问时再考虑 HTTPS 证书那些复杂事。几个值得检查的点：

• 固定 IP：给 HA 所在机器分配固定内网地址，或者直接在路由器上做静态绑定，免得重启后 IP 漂移、手机书签失效、自动化里写死的地址报错。还不知道怎么做的，照着OpenWrt 从入门到精通里的静态 DHCP 章节操作即可。这一步重要到值得拿到初始化阶段来做，而不是出问题之后。
• 多网口机器：只留一个网口接网，避免 HA 暴露在非预期网段上。
• mDNS 可用性：设备发现、HomeKit 配对依赖它，正常路由器都支持，OpenWrt 用户注意 Avahi 服务有没有起来，它可以理解为局域网里的设备广播站。
• 访问入口：把地址加入书签，也可以装手机 App 直接连。
• 同网段问题：如果家里划了 VLAN，保证 HA 和要接入的设备在能互通的网段，这是排查远程控制失灵时第一件要确认的事。VLAN 的划分在软路由入门指南里有完整示范，不懂可以先不划。

单位与偏好

向导里的单位制选择（公制英制）和货币会影响所有界面的显示。国内用户选公制、货币选人民币即可。这些后续也都能改，但要尽早定下来，否则早期积累的历史记录在改单位后会有一段显示混乱的过渡期。

日期格式和时间格式同样在这里选，建议用 24 小时制——家里所有人都能看懂，不用再做换算。

顺手认识一下 configuration.yaml

虽然现代 HA 的日常操作几乎全部在图形界面完成，但配置目录里那个 configuration.yaml 仍是整个系统的核心文件，值得现在就混个脸熟。第一次打开它，你会发现内容可能比想象中少——因为界面里做的大部分设置被写进了 .storage 子目录，而不是这个文件。这是 HA 有意的设计：手写文件和界面配置各管一滩，互不打架。

关于它的三条新手须知：

• 不要手改界面管的配置：看住自己的手，别把界面能改的东西也写进 YAML，两者冲突时排查起来非常痛苦。
• 改完要检查再重启：手动编辑 YAML 之后，HA 会提示配置校验，通过后再重启生效，养成先校验的习惯能避免一半的启动失败。
• 代码编辑器 Add-on 是好帮手：HAOS 用户装一个官方的 File editor 或 Studio Code Server，以后改配置就不用碰命令行了。Container 用户可以用宿主机上任何编辑器。

secrets.yaml 值得单独一提：密码、API 令牌这些敏感值应该放进它，然后在主配置里用引用的方式调用，避免明文散落各处。这是从一开始就该养成的习惯。

顺手做的基础维护设置

还没到运维那章，但有两个基础设置现在顺手开了，将来省事：

• 记录器级别调成 warning：默认 info 级别的日志增长很快，用不了多久就占掉可观的磁盘空间。调试需要时再临时调详细。
• 历史数据保留期限：默认保存几天的详细记录，时长在 Recorder 配置里可改。存储空间小的机器尤其要留意，SD 卡用户这是绕不开的一次设置。

这两项的具体位置可能随版本变化，在设置或维护页面找对应入口即可，原理上记住一条：留得越久越占空间，够用就行。

基本信息检查清单

走完向导后，按这张清单逐项确认，都打勾了再进入第 3 章接设备：

1. 管理员账户已建好并存进密码管理器。
2. 位置和时区显示正确，日出日落时间和你窗外一致。
3. 单位、货币、日期格式符合家人习惯。
4. HA 机器已固定内网 IP。
5. 局域网另一台设备能打开 HA 页面。
6. 手机 App 能连上（推荐顺手装上，后面通知功能要用）。
7. 家人账户建好，权限各就各位。
8. 日志和历史数据保留设置已按存储情况调过。

照着这张清单逐项打勾，是一项成本低、回报极高的投资。未来某天深夜系统出问题，你会庆幸现在留下的每一条都对。

一个建议：先别急着接设备

初始化完成后，最常见的冲动是赶紧把家里设备全接进来。先忍住。花十分钟把本文的清单走完，再确认两件事：第一，备份功能能正常工作（见备份那篇）；第二，系统更新和重启没有异常。磨刀不误砍柴工，配置环境第一次就弄对，后面接设备、写自动化时你会感谢现在多检查了一下的自己。

还有一个进阶建议：现在把这次的配置选择用一页笔记记下来——IP 地址、时区、用户名、部署形态。半年后你动手改配置时，这页笔记比翻界面试错快十倍，也是你将来搬家或重建时的第一手资料。

延伸阅读

• 软路由入门指南：静态 IP 绑定、mDNS 与局域网排查的基础
• 群晖 DSM 实用指南：NAS 容器部署 HA 的网络模式对照