HACS 极速版 下载安装方法

kzdq

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


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

以下几种方法任选其一！

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

1. wget -O - <a href="https://get.hacs.vip" target="_blank">https://get.hacs.vip</a> | bash -
   
2. 
   
3. # 或
   
4. 
   
5. 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

1. shell_command:
   
2.   update_hacs_china: |-
   
3.     wget -O - <a href="https://get.hacs.vip" target="_blank">https://get.hacs.vip</a> | bash -

复制代码

重启HA使配置生效
在开发者工具中执行动作 action: shell_command.update_hacs_china
再次重启HA使更新后的HACS生效
方法5️⃣: Docker安装
仅针对未安装HACS的Docker版本的HA

使用命令方式安装

1. docker run -d \
   
2.   --name homeassistant \
   
3.   --privileged \
   
4.   --restart=unless-stopped \
   
5.   -e TZ=Asia/Shanghai \
   
6.   -v /PATH_TO_YOUR_CONFIG:/config \
   
7.   -v /run/dbus:/run/dbus:ro \
   
8.   --network=host \
   
9.   hacn/hacn:stable

复制代码

使用Compose安装

1. services:
   
2.   homeassistant:
   
3.     container_name: homeassistant
   
4.     image: hacn/hacn:stable
   
5.     volumes:
   
6.       - /PATH_TO_YOUR_CONFIG:/config
   
7.       - /etc/localtime:/etc/localtime:ro
   
8.       - /run/dbus:/run/dbus:ro
   
9.     restart: unless-stopped
   
10.     privileged: true
    
11.     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集成 (仅首次安装)
⚠️ 请不要通过下图中的位置下载HACS，会缺少文件 download hacs


代理
Note

自v1.27.1.3开始，HACS极速版支持自定义Github API地址，如果你的HACS无法加载集成列表和集成详情，修改此选项会有所改善。 此前的版本仅能解决集成下载不了，而该版本后能解决大部分Github访问不了导致的大部分问题。

不过遗憾的是，首次安装HACS时的授权过程仍然还不能被加速，如果你在授权过程中一直转圈，请稍后再试或使用其他科学的方式。

社区提供的免费代理：
https://ghapi.hacs.vip - @al-one
https://ghapi-cf.hacs.vip/api - @al-one
https://hacs-china.chrome7.com/api - @goxofy
https://hacs-china.casen.tk/api - @CasenChan
Note

以上地址由贡献者免费提供，是由Cloudflare Worker搭建，每个代理每天有10万次请求次数限制，请随机使用上面的代理。 我们建议你使用自己的域名创建代理，当然也可以使用freenom.com的免费域名。

创建自己的代理：
登陆或注册Cloudflare添加自己的域名，并修改域名的NS记录
创建Worker服务，选择HTTP 处理程序
复制index.js中的代码，并张贴至Worker的代码编辑器中
部署并在触发器中添加自定义域名，Worker分配的域名是无法被访问的
访问https://your.mirror.domain/api/检查是否生效
在HA的集成与服务页面找到已添加的HACS，点击选项
填入地址https://your.mirror.domain/api