常见任务 - Core
备份
要了解如何备份系统或如何从备份中恢复系统，请参阅 常见任务 下的备份文档。
更新
更新 Home Assistant Core 的最佳实践：
-
- 这确保您可以在需要时 从备份中恢复安装。
-
检查 Home Assistant 更新说明 中的向后不兼容更改。确保检查您正在运行的版本与您要升级的版本之间的所有更新说明。使用浏览器中的搜索功能 (
CTRL + f/CMD + f) 搜索 向后不兼容更改。 -
更新 Home Assistant。
-
检查持久通知和日志，看是否有任何需要解决的配置问题。
-
停止 Home Assistant 服务。
-
切换到运行 Home Assistant 的用户
sudo -u homeassistant -H -s -
激活 Home Assistant 正在运行的虚拟环境
source /srv/homeassistant/bin/activate -
下载并安装新版本
pip3 install --upgrade homeassistant -
完成后再次启动服务以使用新文件。
运行特定版本
要查看您的系统正在运行哪个版本，请前往 设置 > 关于。
如果 Home Assistant Core 版本与您的硬件设置不兼容，您可以降级到之前的版本。在这个例子中，2025.3.4 被用作目标版本，但您可以选择您希望运行的版本。
-
停止 Home Assistant 服务。
-
切换到运行 Home Assistant 的用户。
sudo -u homeassistant -H -s -
激活 Home Assistant 运行的虚拟环境。
source /srv/homeassistant/bin/activate -
下载并安装您想要的版本。
pip3 install homeassistant==2025.3.4 -
完成后再次启动服务以使用新文件。
运行测试版
如果您想在其他人之前测试下一个版本，您可以安装测试版。
-
停止 Home Assistant 服务。
-
切换到运行 Home Assistant 的用户。
sudo -u homeassistant -H -s -
激活 Home Assistant 正在运行的虚拟环境。
source /srv/homeassistant/bin/activate -
下载并安装测试版。
pip3 install --pre --upgrade homeassistant -
完成后，重新启动服务以使用新文件。
运行开发版本
如果您想使用最新的 Home Assistant Core 开发分支，您可以升级到 dev。
dev 分支可能是不稳定的。潜在后果包括数据丢失和实例损坏。
-
停止 Home Assistant 服务。
-
切换到正在运行 Home Assistant 的用户。
sudo -u homeassistant -H -s -
激活运行 Home Assistant 的虚拟环境。
source /srv/homeassistant/bin/activate -
下载并安装您想要的版本。
pip3 install --upgrade git+https://github.com/home-assistant/core.git@dev -
完成后，重新启动服务以使用新文件。
配置检查
在更改配置文件后，请检查配置是否有效，然后再重新启动 Home Assistant Core。
-
切换到运行 Home Assistant 的用户。
sudo -u homeassistant -H -s -
激活 Home Assistant 运行的虚拟环境。
source /srv/homeassistant/bin/activate -
运行配置检查。
运行完整检查：
hass --script check_config列出所有已加载的文件：
hass --script check_config --files查看集成的配置（在此示例中为
light）：hass --script check_config --info light或查看所有集成的配置
hass --script check_config --info all您可以使用以下命令从命令行获取帮助：
hass --script check_config --help -
完成后，重新启动服务以使用新的文件。