2025.3.4
首页 ▸ Installation ▸

排查安装问题

在安装和使用 Home Assistant 的过程中，可能会遇到一些问题。本页面旨在帮助您解决最常见的问题。

无法在浏览器中访问 Home Assistant

症状：“无法访问此网站”

在尝试在浏览器中访问 Home Assistant 时，浏览器显示消息“无法访问此网站”。

描述

这意味着浏览器无法在网络上找到您的 Home Assistant 安装。

解决方案

要解决此问题，请尝试以下步骤：

  1. 确保您的 Home Assistant 设备已通电（LED 灯亮起）。
  2. 确保您的 Home Assistant 安装已连接到互联网：
    • 确保以太网线插入 Home Assistant 和路由器或交换机。
    • 确保您的网络可以上网。
      • 在首次启动时，时间将会同步。确保您的网络允许 NTP。
      • 在首次启动时，Home Assistant 完成安装。它需要访问以下 URL：
        • version.home-assistant.io：用于获取新版本信息。
        • github.com：用于更新附加组件商店的元数据。
        • ghcr.io：GitHub 容器注册表以获取新的 Home Assistant 更新。
  3. 确保打开浏览器以访问 Home Assistant 的系统与 Home Assistant 处于同一网络。
    • 例如，如果浏览器运行的系统使用 Wi-Fi，请确保它使用与 Home Assistant 相同的 Wi-Fi。
  4. 确保您输入的地址正确。
    • 特别是如果消息包含错误代码“ERR_CONNECTION_REFUSED”，则可能是 URL 的端口部分（:8123）出现了拼写错误。
    • 通常，URL 是 http://homeassistant.local:8123。
    • 如果您运行的是旧版本的 Windows 或网络配置更严格，请尝试 http://homeassistant:8123。
  5. 系统可能仍在启动中。等待几分钟并刷新页面。
    • 刷新方式可能因您使用的浏览器而异。查找刷新 图标，或按 CTRL+R 或 CTRL+SHIFT+R。
  6. 检查路由器的网页界面，查看分配给您的 Home Assistant 安装的 IP 地址。
    • 将此 IP 地址（http://x.x.x.x:8123）直接输入到您的浏览器中。
  7. 如果仍然无法访问 Home Assistant，请将键盘和显示器连接到运行 Home Assistant 的设备，以访问控制台并查看 Home Assistant 的问题所在。
  8. 联系我们的社区寻求帮助。

“安装 Home Assistant 时出错”

症状：在引导过程中，出现“安装 Home Assistant 时出错”

您正在进行引导程序，但收到了消息 安装 Home Assistant 时出错。

引导时安装 Home Assistant 时出错

解决方案

  1. 确保您的网络可以上网。
    • 在首次启动时，时间将会同步。确保您的网络允许 NTP。
    • 在首次启动时，Home Assistant 完成安装。它需要访问以下 URL：
      • version.home-assistant.io：用于获取新版本信息。
      • github.com：用于更新附加组件商店的元数据。
      • ghcr.io：GitHub 容器注册表以获取新的 Home Assistant 更新。
  2. 更改网络环境后，等待几分钟。Home Assistant 将尝试重新连接。
  3. 联系我们的社区寻求帮助。

停留在“准备 Home Assistant”阶段

症状：引导似乎停留在“准备 Home Assistant”阶段

您正在进行引导程序，但该过程似乎停留在 准备 Home Assistant 步骤。

Home Assistant 准备中

解决方案

  1. 选择脉动的蓝点以查看日志文件。
    • 日志文件可能提供有关当前状态的更多信息。
  2. 确保您的网络可以上网。
    • 在首次启动时，时间将会同步。确保您的网络允许 NTP。
    • 在首次启动时，Home Assistant 完成安装。它需要访问以下 URL：
      • version.home-assistant.io：用于获取新版本信息。
      • github.com：用于更新附加组件商店的元数据。
      • ghcr.io：GitHub 容器注册表以获取新的 Home Assistant 更新。
  3. 更改网络环境后，等待几分钟。Home Assistant 将尝试重新连接。
  4. 联系我们的社区寻求帮助。