🏠 Home Assistant 针对国人优化各种极速版#

🌈 专为中国用户打造，彻底解决因网络导致的使用困难

🎯 Home Assistant OS 极速版#

如果打的开Github，点个Star吧

如遇到 bug，请通过以下方式反馈：

• 在微信中留言

• 在 GitHub 上提 issue

✨ 核心亮点#

🛠️ 原汁原味的官方体验#

• 🟢 100% 保留官方源代码
• 🚀 仅优化升级镜像地址为中国可访问节点
• ⏱️ 系统初始化时间大幅优化：界面显示20分钟，实际仅需5分钟即可完成（相比原版可能耗时数小时）

📚 HACS 极速版 Alone#

• ⚡ 内置 HACS 极速版，集成安装零报错

• 🔍 支持在集成中直接搜索添加 HACS Gitee 源

• 🚀 集成安装完成后，可直接添加HACS，或一键快速添加

📱 海量加载项支持#

• 📦 内置 400+ 中国版加载项
• 🖱️ 一键安装，流畅升级
• ✅ 彻底解决：
  • 🌐 网络问题导致的安装失败
  • 🗑️ 系统误删加载项
  • 🔧 网络异常导致的系统错误，自动修复功能失效
• 🔗 访问地址：加载项仓库

📅 智能更新策略#

• 🗓️ 每月 28 日统一更新版本
• 🛡️ 避免月初更新导致的集成问题
• ⏳ 比官方版本延迟约 1 个月，确保稳定性
• 📝 支持根据用户反馈调整更新频率

💻 极速在线升级#

• ⚡ 初始化与在线升级全面优化
• 🕒 告别漫长等待，升级体验大幅提升

⚡ 完全开源透明#

• 🔓 所有修改公开透明
• 🔍 支持代码审查
• 🔒 无任何后门，确保系统安全

🔧 新设备适配计划#

• 📈 持续扩展设备支持范围
• 💡 欢迎用户提交设备适配需求
• 🤝 共同完善生态建设

初始化速度演示#

升级速度演示#

📥 系统镜像下载#

HACS 极速版 #

👨‍💻 版本修改作者：Alone#

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

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

安装/更新#

本项目是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配置目录再执行安装命令

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

需要HAOS或Supervised版本的HA

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

方法3️⃣: upgrade服务#

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

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

方法4️⃣: shell_command服务#

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

   shell_command:
     update_hacs_china: |-
       wget -O - https://get.hacs.vip | bash -
2. 重启HA使配置生效
3. 在开发者工具中执行动作 action: shell_command.update_hacs_china
4. 再次重启HA使更新后的HACS生效

方法5️⃣: Docker安装#

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

1. 使用命令方式安装

   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
2. 使用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
3. 启动后添加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，会缺少文件

代理#

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

常见问题#

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

其它官方已弃用的安装方式#