通过 USB 安装

USB 安装方式适用于还在包装盒里的面板，也适用于因厂商软件而难以通过网络访问的面板。将面板接到你正在使用的电脑上，浏览器就会直接通过数据线安装面板应用。安装过程不会通过你的网络传输任何内容，Home Assistant 服务器也无需访问面板。大多数人只会在安装面板上墙前使用一次这种方式。

从 Home Assistant 中开始

管理员从 Home Assistant 侧边栏中的 Panel Assistant 页面打开 USB 安装程序。Home Assistant 会检查发布版本，然后将其交给安装程序，安装程序会在独立的安全窗口中打开。因此，本网站没有安装按钮：执行安装的页面只接受来自你自己的 Home Assistant 的发布版本，未经 Home Assistant 验证的内容不会被安装到面板上。

你需要准备什么

• 已安装的 集成，以及管理员账户。
• 基于 Chromium 的浏览器，例如 Chrome 或 Edge。Firefox 和 Safari 无法与 USB 设备通信。
• 一根 USB 数据线，用来连接面板和运行该浏览器的电脑或手机，而不是连接 Home Assistant 服务器。
• 在面板的开发者选项中开启 USB 调试，并安排一人在面板旁，在授权提示出现时确认授权。硬件页面介绍了各型号如何进入开发者选项。

安装过程

1. 在 Panel Assistant 页面选择版本。列表中只显示 Home Assistant 能够验证并用于安装的 ha-paneld 发布版本：最新稳定版，以及近期的候选发布版（如有），后者会标记为测试版本。
2. 安装程序窗口会验证发布版本，并要求你在浏览器的 USB 提示框中选择面板。
3. 在面板屏幕上确认 USB 调试授权提示。
4. 确认安装。在你确认之前，面板不会发生任何变化。安装程序会先检查面板是否确实没有已有安装：如果已存在安装，它会拒绝覆盖安装，以免危及面板上的数据。
5. 保持数据线连接，并让标签页保持连接，直到安装程序报告完成，然后在面板上完成引导式设置。

如果数据线中途断开或窗口中途关闭，请重新插好数据线，再次从 Home Assistant 传送同一发布版本，并重新连接同一面板。安装程序会在浏览器中保存进度，先检查所有中断的步骤，再进行其他操作，并从中断处继续，而不是从头开始。

安装完成后

面板已经运行应用，可以作为设备添加到 Home Assistant。USB 安装程序不会更新已经安装了该应用的面板；更新方式请参阅 更新与恢复。