跳转到内容
seenzus Docs seenzus Docs seenzus 文档
EN 打开 seenzus

HACS 原版安装教程（GitHub 授权）

HACS（Home Assistant 社区商店）是一个第三方集成管理器。原版通过 GitHub 设备授权安装，适用于海外 / 非大陆用户。大陆用户推荐更简单的 HACS 极速版安装教程（无需 GitHub）。

准备工作

Section titled “准备工作”

在开始之前，请确认：

  • 你的 Home Assistant 已经正常运行，并能正常访问后台。
  • 你拥有一个 GitHub 账号（没有的话请先到 https://github.com 注册，安装过程需要用它授权）。
  • 设备能够正常访问 GitHub（HACS 通过 GitHub 下载内容）。

说明：冬瓜版 HAOS 已内置 HACS，可直接在「设备与服务 → 添加集成」中搜到，无需额外下载。

先看完整流程

Section titled “先看完整流程”

先播放这段视频，确认完整路径；操作时再按下方截图逐步核对。

视频演示：添加 HACS、完成 GitHub 授权并返回 Home Assistant。

完成标志： GitHub 授权完成，Home Assistant 左侧出现 HACS。

常见问题

Section titled “常见问题”

出现 could_not_register 或连续注册失败

Section titled “出现 could_not_register 或连续注册失败”

提交确认项后如果弹出注册失败，不要连续点击重试。先记住错误状态，再按下面顺序处理。

HACS 原版注册失败提示

  1. 完整重启一次 Home Assistant；
  2. 确认当前网络可以访问 GitHub；
  3. 重新添加 HACS；
  4. 连续失败 3 次后，冬瓜版 HAOS 用户改用 HACS 极速版；其他系统先解决 GitHub 网络连通性。
问题解决办法
搜索不到 HACS冬瓜版 HAOS 一般已内置 HACS；若搜不到，尝试清除浏览器缓存或硬刷新（Ctrl/Cmd + Shift + R），或重启一次 Home Assistant 后再搜。
添加时报 could_not_register多为需要重启或网络问题：完整重启一次 Home Assistant 后重新添加；若仍失败，检查能否访问 GitHub（可能被限流，稍后重试或挂代理）。
一直停留在「Waiting for device activation」检查网络是否能访问 GitHub；确认验证码输入正确且未过期，过期后关闭窗口重新操作。
GitHub 授权后侧边栏没有出现 HACS刷新浏览器页面，或重启一次 Home Assistant。
下载内容很慢或失败多为 GitHub 网络问题，可尝试配置网络代理或加速后重试。国内用户建议直接改用 极速版。

下一步

Section titled “下一步”

左侧边栏出现 HACS 后，不要停在商店首页。继续用 HACS 安装 seenzus MQTT Bridge。

真相源 · verified against HACS 2.0.5 · captured 2026-07