本帖最后由 anlong 于 2025-1-22 17:38 编辑
本项目为HACS官方集成的修改版，安装本项目版本会覆盖官方的集成，但是无需重新配置集成(共用一套配置)，因此你可以放心安装。如果想切换到官方版本，使用官方的shell命令再安装即可。
安装/更新
以下几种方法任选其一！
方法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配置目录再执行安装命令
https://hacs.vip/get-addon`](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3a%2f%2fgitee.com%2fhacs-china%2faddons)">方法2️⃣: 加载项安装器: https://hacs.vip/get-addon`
需要HAOS或Supervised版本的HA
- 添加加载项仓库
https://gitee.com/hacs-china/addons`
- 找到
HACS极速版安装器并安装加载项
- 启动加载项并观察日志
- 重启HA
需要已安装HACS极速版v1.33.0.3版本及以上
- 在开发者工具中执行服务
service: hacs.upgrade
- 重启HA使更新后的HACS生效
- 复制代码到HA配置文件
configuration.yaml
shell_command:
update_hacs_china: |-
wget -O - https://get.hacs.vip | bash -
- 重启HA使配置生效
- 在开发者工具中执行动作
action: shell_command.update_hacs_china
- 再次重启HA使更新后的HACS生效
仅针对未安装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 \
ghcr.nju.edu.cn/hasscc/hacn:stable
- 使用Compose安装
services:
homeassistant:
container_name: homeassistant
image: ghcr.nju.edu.cn/hasscc/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集成 (仅首次安装)
镜像自v1.27.1.3开始，HACS极速版支持自定义Github API镜像，如果你的HACS无法加载集成列表和集成详情，修改此选项会有所改善。此前的版本仅能解决集成下载不了，而该版本后能解决大部分Github访问不了导致的大部分问题。 不过遗憾的是，首次安装HACS时的授权过程仍然还不能被加速，如果你在授权过程中一直转圈，请稍后再试或使用其他科学的方式。
- 社区提供的免费镜像：
- https://ghapi.hacs.vip/api - @al-one
- https://ghapi-cf.hacs.vip/api - @al-one
- https://hacs-china.chrome7.com/api - @goxofy
- https://hacs-china.casen.tk/api - @CasenChan
以上镜像由贡献者免费提供，是由Cloudflare Worker搭建，每个镜像每天有10万次请求次数限制，请随机使用上面的镜像。我们建议你使用自己的域名创建镜像，当然也可以使用freenom.com的免费域名。
常见问题
| 
发表于 2022-2-25 22:55:37
