4、首次配置:初始化向导、用户管理、系统设置、备份策略、日志查看技巧
好,咱们把 Home Assistant 装好了,也跑起来了。接下来这一步,我称之为「安家落户」。
很多新手一上来就急着连设备,结果后面权限乱成一锅粥,系统崩了连恢复都找不到门路。我刚开始玩 HA 的时候也吃过这个亏——折腾了一周的自动化,因为一次升级全没了。从那以后,我养成了一个习惯:先把「家」收拾利索了,再请「客人」(设备)进门。
这一章,咱们就聊聊首次配置的那些门道。
4.1 初始化向导:别急着点「下一步」
第一次打开 HA 的 Web 界面,你会看到一个初始化向导。说白了,就是让你填几个基本信息。
第一步:创建所有者账户
这是整个系统的「超级管理员」。用户名和密码一定要记牢。我个人习惯用邮箱做用户名,方便找回密码。密码别用 123456,真的,我在项目里见过有人这么干,后来被隔壁小孩用默认密码登进去把灯全关了……
第二步:设置家庭名称和位置
这里有个坑:位置信息决定了你的日出日落时间、时区、天气预报。如果你在「北京市朝阳区」,就老老实实填北京。别填什么「火星基地」,否则你的自动化会在半夜两点触发「日落模式」。
第三步:是否开启匿名数据收集
这个看你自己。我一般会勾选,因为 HA 团队会根据这些数据优化兼容性。说白了,你贡献的数据越多,后面大家用起来越顺。
4.2 用户管理:权限分清楚,省心一万倍
家里不止你一个人用 HA 吧?老婆要控制灯,孩子要看温度,你还要搞自动化。如果所有人都用管理员账号,万一谁手滑删了个自动化……嗯,你懂的。
用户角色分为三种:
| 角色 | 权限范围 | 适合谁 |
|---|---|---|
| 所有者 | 全部权限,包括系统设置、用户管理、添加/删除集成 | 你(管理员) |
| 管理员 | 除了不能删除所有者账户,其他基本都能干 | 信得过的家庭成员 |
| 用户 | 只能查看和控制设备,不能改设置 | 孩子、访客 |
创建用户的步骤:
- 进入「配置 → 人员」
- 点击「添加人员」
- 输入用户名和密码,选择角色
- 保存
我曾经在一个别墅项目里,给保姆单独开了个「用户」账号,只让她能控制客厅灯和窗帘。结果她离职那天,我只需要删掉她的账号,所有权限自动回收。你想想看,要是她用的是管理员账号……那画面太美我不敢看。
4.3 系统设置:把「地基」打牢
系统设置里有很多选项,但咱们第一次配置,重点关注这几个:
4.3.1 通用设置
- 语言: 简体中文
- 时区: 选你所在的城市,比如 Asia/Shanghai
- 单位制: 公制(摄氏度、米)还是英制(华氏度、英尺)?国内一般选公制
- 经纬度: 自动获取的,但你可以手动微调。比如你家在小区最北边,自动定位可能偏了 100 米,日出时间就差几分钟
4.3.2 网络设置
这里有个关键选项:「信任代理」。如果你用 Nginx 或 Cloudflare 做反向代理,一定要把代理的 IP 加进去。否则 HA 会认为所有请求都来自本地,导致外部访问出问题。
我记得有一次帮朋友排查,他死活连不上 HA,折腾了两小时。最后发现是没加 Cloudflare 的 IP 到信任列表。说白了,HA 不认识这个「中间人」,就不让进门。
4.3.3 自定义域名
如果你有公网 IP 和域名,可以在这里设置外部访问地址。格式是 https://yourdomain.com:8123。没有的话,先用内网 IP 凑合着,后面咱们再聊内网穿透。
4.4 备份策略:别等崩了才后悔
这句话我说过一万遍:「备份不是可选项,是必选项。」
HA 的配置、自动化、历史数据,全存在一个叫 config 的文件夹里。一旦硬盘坏了、系统崩了、或者你手滑删了某个文件……嗯,从头再来吧。
4.4.1 手动备份
最简单的办法:把整个 config 文件夹打包下载。路径一般在 /home/homeassistant/.homeassistant/(看你安装方式)。
# 在终端执行
tar -czvf ha_backup_$(date +%Y%m%d).tar.gz /home/homeassistant/.homeassistant/
4.4.2 自动备份(推荐)
HA 自带一个「备份」功能,在「配置 → 系统 → 备份」里。你可以设置每天、每周自动备份,并选择保留最近几个版本。
我个人习惯:每天凌晨 3 点自动备份,保留最近 7 天的版本。这样即使昨天搞坏了什么,也能回滚到前天。
4.4.3 备份到远程
本地备份不够安全——万一整个服务器炸了呢?我建议用 Google Drive 或 NAS 做远程备份。HA 社区有现成的插件,比如 Google Drive Backup,配置好之后自动上传。
4.5 日志查看技巧:学会「看日志」是基本功
设备连不上?自动化不触发?别慌,先看日志。
日志是 HA 的「黑匣子」,记录了系统里发生的每一件事。你想想看,没有日志,你就像蒙着眼睛修车,全靠猜。
4.5.1 在哪里看日志?
进入「配置 → 系统 → 日志」。你会看到一堆密密麻麻的文字。别怕,咱们只看关键信息。
4.5.2 日志等级
| 等级 | 含义 | 颜色 |
|---|---|---|
| DEBUG | 调试信息,开发时用 | 灰色 |
| INFO | 正常信息,比如「设备已连接」 | 白色 |
| WARNING | 警告,不影响使用但需要注意 | 黄色 |
| ERROR | 错误,功能可能受影响 | 红色 |
| CRITICAL | 严重错误,系统可能崩溃 | 深红色 |
4.5.3 常用查看技巧
- 搜索关键词: 比如你连不上小米网关,就搜
xiaomi或gateway - 只看错误: 在日志页面右上角有个筛选器,选「错误」就行
- 导出日志: 点击「下载日志」按钮,发给别人帮忙排查
我曾经遇到一个诡异的问题:某个传感器每隔 5 分钟就掉线一次。日志里全是 ERROR: timeout。排查了半天,发现是 Wi-Fi 信号太弱,传感器离路由器太远。说白了,日志不会骗你,它只会告诉你真相,但需要你耐心去读。
/home/homeassistant/.homeassistant/home-assistant.log 文件。用 tail -f 命令实时跟踪日志,特别适合调试自动化。
好了,首次配置的核心内容就这些。把用户管好、系统设对、备份做勤、日志看透——这四件事做好了,后面你折腾设备的时候,心里就有底了。
下一章,咱们聊聊怎么把设备「请进门」,也就是添加集成和实体。到时候你会发现,前面这些准备工作有多重要。
公众号:蓝海资料掘金营,微信deep3321