title: '2025.1:带着备份迈入 2025!' description: '<lite-youtube videoid="qCd7RHprmc0" videotitle="Home Assistant 2025.1 发布 Party"</lite-youtube。 本页属于 Home Assistant 中文博客与更新记录,适合了解版本演进、功能变更与社区动态。' 保留策略,以及由集成扩展备份位置的完整能力。还有大量 “What the Heck?!” 月改进、新集成等更多更新!

2025.1:带着备份迈入 2025!

Home Assistant 2025.1 来了!🥂

新年快乐!Home Assistant 全体项目成员祝你和家人 在 2025 年平安健康、万事顺遂!❤️ 让我们一起把今年变得比去年更精彩!

我们都非常兴奋地用一个重量级发布来开启新的一年!🎆

这次发布带来了 Home Assistant 备份系统的全面重构, 它已经筹备了好几个月!这可不只是界面改一改—— 而是从前到后彻底翻新!

自动备份、加密的 Home Assistant Cloud 备份存储、 保留策略、配置向导,甚至还支持由集成提供备份存储位置!🤯

但还不止这些!我们在 12 月还举办了 “What the Heck?!” 月, 社区在活动中提出了很多体验优化建议,而这次发布已经落地了其中相当一部分!

这次发布内容真的很多,话不多说,直接开看!

祝你用得开心!

../Frenck

备份系统全面重构

我们来聊聊备份。说实话,备份是最重要却也最容易被忽视的事情之一。 但当灾难发生时,比如硬件故障,一份可靠备份就能救场。 谁不希望出问题后还能快速恢复运行呢?

虽然 Home Assistant 过去的备份系统多年下来一直稳定可靠, 但它并不太方便你落实最佳实践, 比如定期备份、加密和异地存储。 许多人不得不依赖自定义插件、自动化或蓝图来补足这些能力。

而这一切,从这次发布开始改变!🎉

我们彻底重做了 Home Assistant 的备份体验, 让你只需几次点击就能按最佳实践建立扎实的备份策略, 在备份这件事上真正安心。

不用担心,如果你已经在使用自定义备份方案,它们依然可继续使用。 即使引入了很多新能力,我们仍确保整体保持向后兼容。

那么,废话不多说,一起看看全新的备份系统!

自动备份 🤖

没看错——Home Assistant 现在支持自动备份了!

通过计划任务,备份会定期自动创建, 你完全不用手动操作。 这能确保你始终有一份近期可用的备份,不再为此操心。

Screenshot showing the bew 备份 概述 page which shows you exactly when your last 备份 took place

当你在设置菜单中进入备份页面时, 会看到全新的概览页,清楚显示上次备份时间和下次计划时间。 安心感瞬间拉满!

自动备份会在凌晨 4:45 执行。 也就是说,当家里人都在睡觉时,Home Assistant 正在为你的数据保驾护航。 这个时间点也意味着内部数据库维护已经完成, 能让备份文件尽可能紧凑。

如果计划自动备份过程中出现问题, Home Assistant 会通过修复中心通知你, 确保你能及时知晓并采取处理动作。

触发计划外自动备份 👆

按计划自动备份很棒,但有时你会希望 立刻触发一次备份! 比如你准备做大改动,或者晚上要连着升级一堆东西。

没问题!现在你可以随时在备份页面触发一次计划外自动备份。 它会立即按与你计划自动备份相同的配置创建备份。

Screenshot showing the 备份 now button + dialog that allows you to 触发器 an off-schedule 备份 at any time

按需触发自动备份非常实用,一键就能覆盖你的全部备份设置。 当然,手动备份依然保留, 你仍可以创建内容精确可控的特定备份。

Home Assistant Cloud 备份 😎

你是 Home Assistant Cloud by Nabu Casa 的订阅用户吗? 那你有福了!现在你可以自动把最新、完整加密的备份 存到 Home Assistant Cloud 账户中。

该功能额外不收费就提供 5GB 存储, 为你的数据带来完整加密的异地保护!🎁

Home Assistant Cloud is now a 备份 target location, that is included with the Home Assistant Cloud subscription at no additional costs

你可以在 Home Assistant 内下载备份, 也可以在 Nabu Casa 的 Home Assistant Cloud 账户页面 下载。 这样即使 Home Assistant 硬件完全故障, 你仍可随时拿到最新备份。

备份位置天生可扩展 🧩

所以,自动备份可以存本地磁盘,也可以存 Home Assistant Cloud。 但如果你还想存到其他地方呢?

选择权是 Home Assistant 的核心价值之一; 我们希望在避免厂商锁定的前提下,把系统做得尽可能灵活。 因此,备份系统从设计上就是可扩展的。

这意味着未来集成可以提供新的备份存储位置, 比如 NAS、Google Drive、Backblaze B2 或其他存储服务商。

Screenshot showing an potential example storage provider provided by an 集成

目前这项能力还是全新功能 ✨, 所以暂时还没有集成提供额外位置。 不过我们预计在接下来几个版本里,会有更多集成加入备份位置支持。

这种可扩展性确保你能把备份存到想存的地方, 自由选择你更偏好、也更信任的存储方案。

默认加密备份 🔒

随着 Home Assistant Cloud 成为异地备份位置, 以及未来集成可能提供更多(异地)备份位置, 安全性变得前所未有地重要。 你的备份不仅包含智能家居设备的访问凭据, 还包含你家中的历史数据, 任何人都不应该接触到如此敏感的信息!绝不!

因此,所有备份现在默认使用 AES-128 加密。 为了把备份安全放在首位,我们将过去可选的密码机制, 替换为强制使用的加密密钥。

The new 备份 概述 page shows you exactly when your last 备份 took place

首次设置备份时,系统会为你生成加密密钥。 请务必把它保存在安全位置,因为恢复备份时必须用到。 为了方便保存,你可以在设置流程中把密钥下载为应急包的一部分, 也可以之后随时在备份设置页面下载。 请妥善保管!🔑

所有安装方式都支持恢复备份 🤗

还有一个好消息——现在所有安装方式都支持恢复备份了!🎉

此前只有 Home Assistant OS 安装支持恢复备份。 而从这个版本开始,所有安装方式都可使用该功能! 无论你如何运行 Home Assistant, 即使是在 Docker 环境下使用容器,也都可以恢复备份。

这也意味着你可以从本地存储、Home Assistant Cloud, 或未来通过集成新增的任何备份位置进行恢复。

事实上,今天发布的所有备份功能, 都不受安装方式限制。 我们希望每个人都能拥有可靠的备份策略。

备份保留策略 🗑

之前的备份系统虽然能生成可靠备份, 但如果你不手动清理,磁盘空间最终还是会被占满。😬

所以!现在我们加入了备份保留策略! 你可以配置要保留多少份备份,其余交给 Home Assistant 自动处理。

You can now 配置 a retention policy for your backups, allowing Home Assistant to clean it up automatically

每次备份后都会自动执行清理。 如果你因为特殊需求手动创建了备份,它们不会被自动删除, 你可以对特殊场景保持完全控制。

首次设置备份 🚀

新备份系统上手快速又简单!

升级后首次打开备份设置时, 你会看到一个设置向导, 它会一步步引导你完成备份配置。

Screenshot of the our friendly wizard that will help you setting up your backups

向导会帮助你设置加密密钥、配置备份频率, 并设定备份保留策略。 全部完成后,它会立即启动你的第一次备份!

全部搞定!又少了一件需要担心的事 🎉

3…2…1… 备份!🎊

我们对这套新备份系统超级兴奋! 新年伊始,也真心建议你认真对待备份这件事。 把它当成一个不错的新年目标,如何?😉

所以,先停下手头的事,马上把备份设置起来吧! 直接开始你的 3-2-1 备份策略。 如果你还不熟悉它:

你可以在我们的 3…2…1… 备份博客文章 中了解全部内容。

“What the Heck?!” 月

12 月的 “What the Heck?!” 月 真的是一场超精彩的活动!🎉

非常感谢每一位分享 “What the Heck?!” 时刻和 Home Assistant 改进想法的朋友。 你的反馈非常宝贵,也持续帮助我们规划未来路线图和优先级。

非常感谢每一位分享自己 “What the Heck?!” 时刻和 Home Assistant 改进想法的朋友。你的反馈极其宝贵,也在持续帮助我们塑造未来的路线图与优先事项。

这次发布中已经解决了相当多大家分享的 “What the Heck?!” 问题 🚀——而且我们还不会停下!接下来的版本里,你还会看到更多受到这些反馈启发而实现的改进。

创建自动化和脚本时设置类别与标签

第一个已经解决的 WTH 项目,要感谢 @jpbede!而且这也是票数较高的问题之一,确实很值得解决!Andrew Jackson 写道:

"WTH can you not add categories, labels etc when creating an 自动化"

是啊,这确实是个很好的 WTH!每次你创建新的自动化或脚本时,通常都希望当场把它整理好,而不是之后再回到设置里补做。已修复!🎉

按下键盘上的 d 键即可弹出设备快速栏

现在,当你创建新的自动化或脚本,或者给它们重命名时,就可以立刻设置描述、类别、标签和区域!🏷️ 很棒!

快速跳转到设备

你可能已经知道,在 Home Assistant 的任意位置,都可以按键盘上的 c 键打开快速导航栏前往各种页面,或按 e 键搜索并跳转到任意实体。不过……

"WTH is there no quick bar for devices?"

这是 Andreas Brett 提出的一个好问题!确实,之前设备没有这样的快捷入口。现在由 @jpbede 出手解决!你可以按下键盘上的 d 键,通过快速栏直接跳转到任意设备。

按下键盘上的 d 键即可弹出设备快速栏

图表缩放与平移

KNXBroker 提出了下面这个 WTH 话题:

"WTH lets 升级 History Graphs"

你说得对!Home Assistant 中的历史图表虽然基础但够用,但我们当然还能做得更好!🚀

那个 WTH 讨论里呼声很高的一项功能,就是图表的缩放与平移……感谢 @MindFreeze,现在你可以在 Home Assistant 的任意图表中进行缩放和平移了!📈

按住 ctrl(macOS 上为 command)并滚动鼠标滚轮,即可在 Home Assistant 中缩放任意图表! 按住 ctrl(macOS 上为 command)并滚动鼠标滚轮, 即可在 Home Assistant 中缩放并拖拽任意图表!

按住 control 键(macOS 上为 command 键)并滚动鼠标滚轮,就可以缩放图表。你也可以点击并拖拽,平移已经放大的图表。

除了这个改动之外,@MindFreeze 还为历史图表加入了细小的微动画,让它们看起来更灵动、不再那么静态。

控制新实体默认是否暴露给 Assist

mathd 在 “What the Heck?!” 月的讨论中提出了这样一个问题:

"WTH Are all new 实体 exposed to Assist by default?"

我们听到了!感谢 @jpbede,你现在可以控制新实体默认是否暴露给 Assist 了。你可以在 Home Assistant 语音助手设置中开启或关闭这个选项。

在设置中控制新实体是否默认暴露给 Assist

更多 “What the Heck?!” 改进

本次发布中的很多小改进都来自 “What the Heck?!” 月活动。以下是其中另外一些值得注意的变化:

"WTH there is no hotkey for Assist"**

感谢 @jpbede,现在你可以在 Home Assistant 的任意位置按下键盘上的 a 键来唤出 Assist 了!🎙️ 很赞!

"WTH doesn't HA ask if I want to save automation?"

哇,这个问题也很好!感谢 @jpbede,现在如果自动化编辑器中有未保存的更改,离开前 Home Assistant 会询问你是否要保存。🤖

"WTH Is in Energy 仪表盘 the individual 设备 not able to reorder"

感谢你提出这个问题,yormedia!说实话,这个问题在之前几届 “What the Heck?!” 活动中也被提过很多次了。理由已经足够充分,于是 @karwosts 把它实现了!你现在可以在分类设置中重新排列它们的顺序。🔡

"WTH Can't I filter labels within a table filter?"

这是个好问题。如果你有很多标签,那么在筛选选项里滚动浏览完整标签列表会有点麻烦。感谢 @silamon,现在你可以直接在筛选选项中搜索并筛选标签了!🔎

WTH sentence 触发器 doesn't contain any context

这是个很棒的点子!感谢 @balloob,现在完整的对话输入内容已经可以供句子触发器使用了!🗣️ 这实际上也是本届活动中第一个被解决的 WTH 项目!😎

集成

感谢社区持续带来新的集成,并不断改进现有集成!你们都太棒了 🥰

新集成

欢迎以下新集成加入本次发布:

  • Cookidoo,由 @miaucl 添加
    与 [Cookidoo 官方 Thermomix 食谱平台]上的购物清单交互。
  • EHEIM Digital,由 @autinerd 添加
    使用 Home Assistant 控制你的 [EHEIM Digital 水族设备]。
  • Ituran,由 @shmuelzon 添加
    获取并使用你车辆中 Ituran 设备提供的信息。
  • Ohme,由 @dan-r 添加
    获取 Ohme 智能电动车充电器的传感器信息。
  • Peblar,由 @frenck 添加
    控制并监控你的 [Peblar 电动车充电器]的充电会话。
  • Powerfox,由 @klaasnicolaas 添加
    采集你的 Poweropti 设备所读取的电、水、燃气和热能数据。
  • Slide Local,由 @dontinelli 添加
    通过本地 API 将你的 Slide 窗帘设备直接接入 Home Assistant。
  • Watergate,由 @adam-the-hero 添加
    将 Watergate Sonic Local 集成进 Home Assistant。

现有集成的重要改进

不仅有新集成加入,现有集成也在持续改进。以下是一些值得关注的现有集成更新:

现已可通过 UI 设置

虽然大多数集成都可以直接在 Home Assistant 用户界面中设置,但仍有一些过去只能通过 YAML 配置。我们持续将更多集成迁移到 UI 中,让每个人都更容易设置和使用。

以下集成现在已可通过 Home Assistant UI 设置:

告别以下集成

以下集成也已在本次发布中移除:

  • DTE Energy Bridge 在弃用后已被移除,因为该集成已经无法正常工作。
  • Simulated 此前已被弃用,现在正式移除。
  • Stookalert 已被移除,因为其上游数据已不再更新。若你需要相同信息,Stookwijzer 集成是一个不错的替代方案。

其他值得注意的变化

本次发布还有许多其他改进;以下是其中一些值得关注的变化:

  • 当你查看数据表并在浏览器中使用 ctrl+f 搜索时,搜索输入框现在会自动获得焦点,因为浏览器原生搜索在数据表中无法正常工作。感谢 @jpbede
  • @marcinbauer85 调整了“添加卡片”对话框,现在添加卡片时会自动聚焦到搜索框,这样你就能立刻开始输入搜索内容。很贴心!
  • 通过 Home Assistant 上传的图片(例如背景图或用户头像)现在可以在媒体浏览器中浏览了。感谢 @karwosts
  • 在数字实体的 more-info 对话框中,数值滑块旁边现在会显示计量单位。感谢 @abmantis
  • Home Assistant 现在支持将 mWh 作为能量传感器的单位,并支持将 mW 作为电功率传感器的单位。感谢 @agners
  • @wendevlin 为自动化和脚本编辑器添加了设置和类别的溢出菜单动作(右上角三点菜单),让你可以更直接地从编辑器访问这些内容。不错!
  • logbook 卡片 现在支持选择要显示事件的目标。你现在可以按实体、设备、区域、楼层和标签来筛选!感谢 @silamon

仪表盘 background 设置

几次发布之前,我们让给仪表盘添加背景图片变得更容易了。而在本次发布中,@silamon 更进一步,加入了大量设置,让你可以自定义背景图片的显示方式。

这包括支持平铺背景、透明度、尺寸设置、对齐方式,以及让背景随页面滚动或固定不动。

你现在可以完整自定义仪表盘背景,包括平铺、透明度、对齐方式和尺寸设置

太棒了!感谢 @silamon

Tile 卡片的媒体播放器音量功能

这是来自 @simon-zumbrunnen 的一个超棒新增功能!Tile 卡片现在支持媒体播放器音量滑块特性。借助它,你可以直接在 Tile 卡片上控制媒体播放器音量。🔉 干得漂亮,Simon!

启用音量功能滑块后的媒体播放器 tile 卡片

Patch releases

我们还将在 1 月为 Home Assistant 2025.1 发布补丁版本。这些补丁版本只包含 bug 修复。我们的目标是每周五发布一个补丁版本。

2025.1.1 - January 7

2025.1.2 - January 9

2025.1.3 - January 20

2025.1.4 - January 24

需要帮助?加入社区吧!

Home Assistant 拥有一个非常棒的用户社区,大家都非常愿意彼此帮助。所以,加入我们吧!

我们非常活跃的 Discord 聊天服务器 是一个绝佳去处,也别忘了加入我们精彩的 论坛

发现了 bug 或问题?请到我们的 issue tracker 提交反馈,帮助我们修复!或者查看帮助页面,了解更多可寻求帮助的渠道。

如果你更喜欢电子邮件,订阅我们的 Building the Open Home Newsletter,即可直接在收件箱中接收最新功能消息、社区动态,以及关于打造 Open Home 的其他新闻。

向后不兼容的变更

我们始终尽力避免对现有功能做出可能意外影响 Home Assistant 安装的更改。但很遗憾,有时候这是不可避免的。

我们始终会记录这些更改,以尽可能让迁移过程变得更容易。本次发布包含以下向后不兼容变更:

1-Wire 计数器中的计量单位已被移除, 因为 count 并不是一个单位 😁

(@jrieger - #132076) (文档)

现在,如果 HEOS 媒体播放器分组中的某个成员不是有效的 HEOS 播放器, 系统会抛出异常。此前,未知或无效成员会被静默忽略。

(@andrewsayre - #132213) (文档)

devolo Home Control 集成已更新,移除了设置 mydevolo URL 的选项。 该选项此前仅用于开发目的,以对接 devolo Home Control Cloud。 该选项现已不可用。

(@Shutgun - #132821) (文档)

FXCOM RFXtrx 计数器中的计量单位已被移除, 因为 count 并不是一个单位 😁

(@jrieger - #133108) (文档)

“Water usage” 传感器的计量单位已从 l/min 更新为 L/min。 这项调整统一了单位表示,以提升 Home Assistant 内的一致性。

任何依赖旧单位的自动化、脚本或模板都可能需要调整。 长期统计数据会保持不变,但系统会创建修复问题, 以确保数据按新单位完成更新。

(@DCSBL - #132261) (文档)

color_tempkelvin 选项已不再是 LIFX 动作的有效参数。请改用 color_temp_kelvin

(@epenet - #132730) (文档)

内置的 OAuth 应用凭据已被移除,因为 Tesla 已不再支持开源应用注册,并正转向按使用量付费的模式。

你可以在这篇博客文章中了解更多相关公告内容。

(@Bre77 - #132431) (文档)

“设备状态” 传感器的状态值现已被标准化,以符合 Home Assistant 核心规则,并支持翻译。这会影响以下 UniFi 传感器状态:

  • Connected, which now became connected
  • Pending, which now became pending
  • Firmware Mismatch, which now became firmware_mismatch
  • Upgrading, which now became upgrading
  • Provisioning, which now became provisioning
  • Heartbeat Missed, which now became heartbeat_missed
  • Adopting, which now became adopting
  • Deleting, which now became deleting
  • Inform Error, which now became inform_error
  • Adoption Failed, which now became adoption_failed
  • Isolated, which now became isolated
  • Unknown, which now became unknown

如果你在自动化、脚本或模板中直接使用了这些状态值,就需要相应调整,以匹配这些变化。

(@bieniu - #131921) (文档)

该集成现在使用官方的 Zabbix Python API。因此,当前支持的最低 Zabbix 版本变为 5.0。这意味着不再支持 Zabbix 4 及更早版本。

(@kruton - #131674) (文档)

如果你是自定义集成开发者,并想了解适用于你集成的变化和新功能,请务必关注我们的开发者博客。以下是本次发布中最值得注意的几项:

全部变更

当然,本次发布还有更多内容。你可以在这里查看完整变更列表:Home Assistant 核心 2025.1 完整更新日志