HACS极速版！

anlong

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

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

使用命令行安装

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

复制代码

如果上面的命令执行后卡住不动，或没有提示安装成功，请尝试下面的命令：

wget -O - https://hacs.vip/get | HUB_DOMAIN=ghproxy.com/github.com bash -

复制代码

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

手动安装

• 点击这里下载安装包并解压 (如果下载不了请点这里或这里)
• 通过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文件复制到刚创建的hacs文件夹
• 重启HA
• 添加HACS集成 (仅首次安装)
  

请不要通过下图中的位置下载HACS，会缺少文件

                               
登录/注册后可看大图

镜像

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

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

• 社区提供的免费镜像：
  
  • https://ghapi-cf.hacs.vip/api - @al-one
  • https://hacs-china.chrome7.com/api - @goxofy
  • https://cn.hacs.tk/api - @cheny95
  • https://hacs.liangshe.ng/api - @louliangsheng
  • https://hacs-china.casen.tk/api - @CasenChan
    

以上镜像由贡献者免费提供，是由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
    

常见问题

• 极速版和官方HACS的差别有那些？
  

jswh1969

我先删除HACS文件夹，再解压，安装好了，但商店已下载里有两个HACS，官方的还在，而且我原先是想解决HACS界面不显示“集成”“前端”等问题的，为什么会这样？

jswh1969

已经安装了官方的HACS，直接删除文件夹然后安装极速版，可以吗？

谁敢摸狗蛋

在HA的集成与服务页面找到已添加的HACS，点击选项
填入镜像地址https://your.mirror.domain/api

大佬，这一步在哪里，前面镜像都创建好了，这个步骤没找到，请指教下把

roanstar

cd进入到HA配置目录再执行安装命令，在命令行里怎么输入啊？CD 相应目录？

461226764

谢谢大佬，安装速度 自带翻译

mikebai521

github打不开ping不通有什么好办法吗？或者有经济一些的付费代理？添加集成那步怎么都无法链接GITHUB。。。

liujueshen

命令行安装很快

roommaster

安装好快

yx262514

用了您的方法，安装了HACS，但还是不能下载插件，一直转圈，ping github也可以ping的通