🏠 HACS 极速版

预计阅读时间: 4 分钟

版权

版本修改作者：Alone，如果你已经是Home Assistant OS 极速版则无需重复安装，已内置

HACS是一款优秀的 Home Assistant 集成商店，然而国人想要使用它下载插件或前端卡片却困难重重，主要原因就是国内的网络环境。本项目使用了gitmirror.com和fastgit.org等提供的Github代理服务，可以让大家更快的下载商店里的插件。

我们需要你的帮助

HACS极速版是依赖于有github帐号的玩家共享token来实现免帐号使用的，如果您愿意共享您的token，请点此来帮助有需要的人

安装/更新

TIP

本项目是HACS官方集成的修改版，安装本项目会覆盖官方的集成，但是无需重新配置集成(共用一套配置)，因此你可以放心安装。如果想切换到官方版本，使用官方的shell命令再安装即可。

WARNING

以下几种方法任选其一！

方法1️⃣: 使用命令安装

wget -O - https://get.hacs.vip | bash -

# 或

curl -fsSL get.hacs.vip | bash

如果是haos/hassio/supervised版本的HA，可直接在宿主机或Terminal & SSH加载项中执行上面的命令
如果是core/docker版本的HA，需要ssh登陆宿主机后，并cd进入到HA配置目录再执行安装命令

方法2️⃣:`加载项安装器: https://hacs.vip/get-addon`

需要HAOS或Supervised版本的HA

添加加载项仓库 https://gitee.com/hacs-china/addons
找到HACS极速版安装器并安装加载项
启动加载项并观察日志
重启HA

方法3️⃣:`upgrade`服务

需要已安装HACS极速版v1.33.0.3版本及以上

在开发者工具中执行服务 service: hacs.upgrade
重启HA使更新后的HACS生效

方法4️⃣:`shell_command`服务

复制代码到HA配置文件 configuration.yaml

shell_command:
  update_hacs_china: |-
    wget -O - https://get.hacs.vip | bash -

重启HA使配置生效
在开发者工具中执行动作 action: shell_command.update_hacs_china
再次重启HA使更新后的HACS生效

方法5️⃣:`Docker安装`

仅针对未安装HACS的Docker版本的HA

使用命令方式安装

docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=Asia/Shanghai \
  -v /PATH_TO_YOUR_CONFIG:/config \
  -v /run/dbus:/run/dbus:ro \
  --network=host \
  hacn/hacn:stable

使用Compose安装

services:
  homeassistant:
    container_name: homeassistant
    image: hacn/hacn:stable
    volumes:
      - /PATH_TO_YOUR_CONFIG:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host

启动后添加HACS集成

方法6️⃣: 手动安装

点击这里下载安装包并解压 (如果下载不了请点这里或这里)
通过samba/ftp进入HA配置目录，通常为以下目录：
- /usr/share/hassio/homeassistant haos/hassio宿主机
- /config haos/hassio的Samba或Terminal & SSH加载项
- $HOME/.homeassistant 以core方式安装的HA默认配置目录
- docker安装的HA为-v参数后面映射的目录
在HA配置目录下创建custom_components文件夹 (如果已有请忽略)
在custom_components目录下创建hacs文件夹 (如果已有请删除重新创建)
將解压出来的文件复制到刚创建的hacs文件夹
重启HA
添加HACS集成 (仅首次安装)

ON THIS PAGE

#🏠 HACS 极速版

#安装/更新

#方法1️⃣: 使用命令安装

#方法2️⃣:加载项安装器: https://hacs.vip/get-addon

#方法3️⃣:upgrade服务

#方法4️⃣:shell_command服务

#方法5️⃣:Docker安装

#方法6️⃣: 手动安装