常见任务 - 容器

备份

有关如何备份系统或如何从备份恢复系统的详细信息，请参阅 常见任务 下的备份文档。

更新

更新 Home Assistant Core 的最佳实践：

1. 备份您的安装，并将备份和 备份应急包 存放在安全的地方。
   • 这确保您可以在需要时 从备份中恢复安装。
2. 检查 Home Assistant 更新说明 中的向后不兼容更改。确保检查您正在运行的版本与您要升级的版本之间的所有更新说明。使用浏览器中的搜索功能 (CTRL + f / CMD + f) 搜索 向后不兼容更改。
3. 更新 Home Assistant。
4. 检查持久通知和日志，看是否有任何需要解决的配置问题。

docker pull ghcr.io/home-assistant/home-assistant:stable

docker compose pull homeassistant
docker compose up -d

运行特定版本

要查看您的系统正在运行哪个版本，请前往 设置 > 关于。

如果 Home Assistant Core 版本与您的硬件设置不兼容，您可以降级到之前的版本。在这个例子中，2025.3.4 被用作目标版本，但您可以选择您希望运行的版本。

docker pull ghcr.io/home-assistant/home-assistant:2025.3.4

然后您需要使用新镜像重新创建容器。

运行测试版

如果您想在其他人之前测试下一个版本，您可以安装测试版。

docker pull ghcr.io/home-assistant/home-assistant:beta

然后您需要使用新映像重新创建容器。

运行开发版本

如果您想使用最新的 Home Assistant Core 开发分支，您可以升级到 dev。

docker pull ghcr.io/home-assistant/home-assistant:dev

然后您需要使用新映像重新创建容器。

配置检查

在更改配置文件后，请检查配置是否有效，然后再重新启动 Home Assistant Core。

如果你的容器名称不是 homeassistant，请在下面的示例中更改该部分.

运行完整检查：

docker exec homeassistant python -m homeassistant --script check_config --config /config

列出所有已加载的文件：

docker exec homeassistant python -m homeassistant --script check_config --files

查看集成的配置（在此示例中为 light）：

docker exec homeassistant python -m homeassistant --script check_config --info light

或者查看所有集成的配置

docker exec homeassistant python -m homeassistant --script check_config --info all

您可以使用以下命令从命令行获取帮助：

docker exec homeassistant python -m homeassistant --script check_config --help