智能家居 ·

Home Assistant 备份成功,换台机器就一定能恢复吗?

Home Assistant 备份成功不等于整套系统可恢复。核对备份范围、加密密钥、外部数据库、无线适配器和迁移后的实际设备验收。

备份列表里有一个绿色的成功记录,看起来终于可以放心换机器了。但旧主机真正停下来后,才发现备份文件还在旧硬盘上,解密密钥没另存,外部数据库也没有一起备份。

这类问题的关键在于:备份任务完成,只证明这次任务完成了它负责的部分。整个智能家居能否恢复,还要检查文件、密钥、依赖服务和硬件。

这篇以 Home Assistant 官方备份文档为依据,核对日期为 2026 年 11 月 10 日。主要讨论 Home Assistant OS,并明确 Container 的范围差异;恢复清单是建议,没有在用户的家庭设备上执行迁移或故障演练。

先看备份里有什么,再看文件有多大

Home Assistant OS 的备份可以包含设置、历史数据、媒体、共享目录以及所选择的应用和应用数据,具体取决于备份时勾选的内容。[1]

一个文件成功生成,不代表所有项目都已选择。体积很小可能只是排除了媒体和历史,也可能漏掉了你真正需要的数据;体积很大同样不能证明完整。

官方文档还区分了数据库的位置:默认数据库中的历史记录可以按选择纳入备份;如果数据库作为 Home Assistant OS 的应用运行,需要包含对应应用;如果数据库运行在另一台系统上,则不在这份备份里,需要单独处理。[1]

Home Assistant Container 的备份范围也不等同于 OS:文档列出的主要内容是 Home Assistant 设置与可选历史数据,不能据此认为同一主机上的其他容器、卷和部署文件都已打包。

迁移之前,可以列一张实际依赖表:

项目 应检查什么
Home Assistant 配置 是否包含当前需要的设置与自动化
历史与能源数据 使用哪种数据库,是否纳入相应备份
MQTT、数据库等服务 在 OS 应用里,还是另一个容器或另一台机器上
媒体与共享目录 是否被排除,外部文件是否另存
USB 无线适配器 是否保留原适配器,设备映射如何恢复
网络与外部账号 新主机能否访问,是否需要重新认证

这张表是盘点工具。每项是否已经被备份,应以安装方式、配置和实际备份内容为准。

文件和解密密钥,都不能只放在旧主机上

Home Assistant 文档说明,备份默认加密,设置备份时会提示下载 emergency kit,也就是包含恢复所需密钥的应急资料。[1]

如果保留的是加密备份,恢复时需要对应密钥。把密钥仅放在旧机器的下载目录,旧硬盘损坏后可能一起失去;只保存密钥却拿不到备份文件,同样无法恢复。

建议在旧主机之外保留可读取的副本,并妥善保存对应密钥。若更换过密钥,还要确认旧备份使用哪一个,不能假设当前下载的应急资料能解开所有历史文件。

下载或转存的文件也要确认其加密状态,不能只凭扩展名判断。若副本是解密后的归档,就应按敏感配置文件保管,而不是随手传到公开网盘。

官方建议将副本保存在另一套系统,理想情况下还保留异地副本。[1] 对家庭用户而言,先做到“旧主机完全无法开机,我仍能找到文件和密钥”,就比只在同一块硬盘里每天多生成一个文件有意义。

能装下压缩文件,不代表能完成恢复

备份文件是压缩归档,不能用它的大小直接推断新设备所需空间。

Home Assistant 的迁移文档要求检查旧系统实际磁盘使用量,并给目标设备留出额外空间;恢复条件也包括目标系统的健康状态和网络连接。[1]

因此,不宜看见一个几百 MB 的备份,就认为任何剩余几百 MB 的存储都够用。安装程序、恢复后的数据库、应用和媒体都可能占用更多空间。

另外,“本地控制可以不依赖互联网”不代表“重建整个系统也不需要互联网”。官方恢复流程会重新安装 Home Assistant Core 和应用,Home Assistant OS 的相关恢复条件包含互联网连接。[1]

准备迁移时,把目标硬件、安装方式、存储和恢复所需网络一起检查。恢复运行时界面暂时无法访问,也不应立即拔电;应按官方说明检查进度,避免把正常重建过程打断。

仪表盘回来了,设备不一定已经接回来

恢复完成后,原来的仪表盘和自动化配置可能已经出现,但它们依赖的真实设备仍需要工作。

比如,旧系统使用的 USB 无线适配器没有插到新机器上,或者虚拟机没有重新映射该设备。界面上的设备名称还在,并不能补上缺失的无线接口。

Home Assistant 官方迁移流程提醒迁移时连接原有控制器或无线适配器;如果改用了新的内置 Zigbee 无线电,需要按 Zigbee 的迁移流程处理,而不是把恢复配置等同于完成无线网络迁移。[1]

网络存储也应检查是否真的连通。恢复共享路径的配置,不会让一台关机的 NAS 自动变成可访问。电池设备暂时不可用时,可以按设备方式唤醒并观察上报,不要立刻把它从系统里删除。

对于自己单独部署的服务,更要核对是否已恢复相应数据和连接配置。本文不承诺任意 Matter、Thread 或 Zigbee 硬件都能仅靠一份 Home Assistant 备份无缝替换。

把“恢复成功”拆成几个可观察的结果

备份系统提供创建成功、失败、最近成功时间等状态,适合用来发现备份流程异常,但这些状态不是恢复演练报告。[2]

建议为自己的系统设定一份验收清单:

  1. 旧主机不可用时,仍能从另一位置取得备份。
  2. 能取得该备份对应的解密密钥,以及备份时使用的登录凭据。
  3. 在合适的目标环境中完成恢复,并能登录。
  4. 核对关键自动化、所需历史数据和应用是否存在。
  5. 检查一项实际状态上报、一项普通设备控制和一条低风险自动化。
  6. 核对通知及外部依赖,记录实际恢复耗时。

演练应安排在可接受的维护时间,使用备用环境或明确的切换方案。不要让恢复出来的副本与生产实例同时控制同一套设备、重复发送通知。只在隔离环境检查配置的演练,也应如实记录“尚未验证真实设备控制”。

恢复过程会覆盖所选部分。做验证前保留当前系统的独立备份和回退条件,不能为了证明一个旧备份可用,先把唯一可用的现状覆盖掉。

一份备份真正有用的时刻,是你需要恢复的时候

日常可以关注备份是否按时完成、远端副本是否可用;大改动和迁移之前,则要进一步确认恢复范围、密钥和外部依赖。

最值得写下来的不是“我开了自动备份”,而是:最近一次确认可以恢复的是哪份备份,包含哪些东西,哪些部分还没有验证。

这会让下一次换机器时的判断建立在记录上,而不是建立在一个绿色图标上。

资料来源

  1. Home Assistant:Backups。核对备份范围、外部数据库、加密与应急资料、独立存储、迁移条件和恢复后检查;读取页面版本标识为 2026.11.1。
  2. Home Assistant:Backup integration。核对备份完成与失败事件、最近成功备份时间等状态的含义。

AI 生成的概念配图,不是实测照片或网络拓扑图。