常规故障排除

此页面提供一些关于更一般故障排除主题的信息。

Home Assistant 进入恢复模式

症状：Home Assistant 在恢复模式中

在页面顶部，您会看到一个红色横幅。在 概述 页面，您会看到一个 恢复模式 通知。

描述

当 Home Assistant 处于恢复模式时，配置存在问题。

恢复模式加载最小的一组集成，以允许对配置进行故障排除。恢复模式将使用上次成功启动 Home Assistant 时使用的配置部分。您仍然可以看到用户界面、设置和附加组件。

解决方案

您需要识别配置文件中的问题并在那修复它。问题可能是由简单的无效 YAMLYAML 是一种人类可读的数据序列化语言。它用于以结构化格式存储和传输数据。在 Home Assistant 中，YAML 用于配置，例如在 configuration.yaml 或 automations.yaml 文件中。 [Learn more] 文件引起的。

• 如果您正在运行 Home Assistant Operating SystemHome Assistant OS，即 Home Assistant 操作系统，是一个嵌入式、简约的操作系统，旨在运行 Home Assistant 生态系统。它是大多数用户推荐的安装方法。 [Learn more]，如果需要，您可以安装一个附加组件，例如 Studio Code Server，以编辑配置文件。
• 如果您仍然登录，可以 编辑您的配置。
  • 在 Home Assistant 用户界面中，打开您通常使用的附加组件并编辑配置文件。
• 重启 Home Assistant。
• 如果您因为忘记密码而被锁定，则无法从用户界面编辑配置文件。请按照步骤 重置您的密码。

在安全模式下重启 Home Assistant

如果您的 Home Assistant 行为不正常且无法识别根本原因，您可以使用 安全模式 来缩小可能原因的范围。 安全模式 加载 Home Assistant Core，但不加载自定义集成、自定义卡片和自定义主题。如果问题在 安全模式 中不存在，则问题不在 Home Assistant Core 中。在报告问题之前，请检查问题在 安全模式 中是否仍然存在。

• 要从 UI 启用安全模式，请转到 设置 > 系统 > 重启 Home Assistant（右上角） > 以安全模式重启 Home Assistant。
• 如果您无法访问 UI，可以通过 命令行 启用 安全模式：
  • ha core restart --safe-mode

我没有看到任何更新

通常，更新会在 设置 页面顶部显示。如果您在这里没有看到它们，可能是 可见性 选项被禁用。

解决方案

1. 在 系统 页面，右上角选择三点 菜单并选择 检查更新。
2. 转到 系统 > 更新。
   • 选择更新通知。
   • 选择齿轮图标 ，然后将 可见 设置为激活。