{"id":14820660,"url":"https://github.com/hacs-china/integration","last_synced_at":"2025-09-17T03:31:28.046Z","repository":{"id":45658226,"uuid":"463389296","full_name":"hacs-china/integration","owner":"hacs-china","description":"🇨🇳 HACS 极速版，无需登陆Github","archived":false,"fork":true,"pushed_at":"2025-08-17T15:09:00.000Z","size":13521,"stargazers_count":634,"open_issues_count":0,"forks_count":49,"subscribers_count":1,"default_branch":"china","last_synced_at":"2025-08-17T17:20:39.027Z","etag":null,"topics":["custom-component","hacs","hacs-china","home-assistant"],"latest_commit_sha":null,"homepage":"https://hacs.vip","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"hacs/integration","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hacs-china.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-25T03:53:45.000Z","updated_at":"2025-08-17T15:07:12.000Z","dependencies_parsed_at":"2023-02-09T21:45:50.882Z","dependency_job_id":null,"html_url":"https://github.com/hacs-china/integration","commit_stats":null,"previous_names":[],"tags_count":218,"template":false,"template_full_name":null,"purl":"pkg:github/hacs-china/integration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hacs-china%2Fintegration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hacs-china%2Fintegration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hacs-china%2Fintegration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hacs-china%2Fintegration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hacs-china","download_url":"https://codeload.github.com/hacs-china/integration/tar.gz/refs/heads/china","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hacs-china%2Fintegration/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275529508,"owners_count":25481125,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-17T02:00:09.119Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-component","hacs","hacs-china","home-assistant"],"created_at":"2024-09-18T18:01:11.404Z","updated_at":"2025-09-17T03:31:28.032Z","avatar_url":"https://github.com/hacs-china.png","language":"Python","funding_links":["https://github.com/sponsors/ludeeus","https://buymeacoffee.com/ludeeus"],"categories":["Python"],"sub_categories":[],"readme":"# HACS 极速版\n\n[![version](https://img.shields.io/github/v/release/hacs-china/integration)](https://github.com/hacs-china/integration/releases/latest?include_prereleases)\n[![releases](https://img.shields.io/github/downloads/hacs-china/integration/total)](https://github.com/hacs-china/integration/releases)\n[![stars](https://img.shields.io/github/stars/hacs-china/integration)](https://github.com/hacs-china/integration/stargazers)\n\n[HACS](https://hacs.xyz)是一款优秀的 [Home Assistant](https://www.home-assistant.io) 集成商店，然而国人想要使用它下载插件或前端卡片却困难重重，主要原因就是国内的网络环境。\n本项目使用了[gitmirror.com](https://gitmirror.com)和[fastgit.org](https://fastgit.org)等提供的Github代理服务，可以让大家更快的下载商店里的插件。\n\n\u003ca name=\"install\"\u003e\u003c/a\u003e\n## 安装/更新\n\n\u003e 本项目是HACS官方集成的修改版，安装本项目会覆盖官方的集成，但是无需重新配置集成(共用一套配置)，因此你可以放心安装。如果想切换到官方版本，使用官方的shell命令再安装即可。\n\u003e\n\u003e 以下几种方法任选其一！\n\n#### 方法1️⃣: 使用命令安装\n\n```shell\nwget -O - https://get.hacs.vip | bash -\n\n# 或\n\ncurl -fsSL get.hacs.vip | bash\n```\n\n- 如果是haos/hassio/supervised版本的HA，可直接在宿主机或`Terminal \u0026 SSH`加载项中执行上面的命令\n- 如果是core/docker版本的HA，需要ssh登陆宿主机后，并cd进入到HA配置目录再执行安装命令\n\n#### 方法2️⃣: [`加载项安装器: 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)\n\n\u003e 需要HAOS或Supervised版本的HA\n\n1. 添加加载项仓库 [`https://gitee.com/hacs-china/addons`](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgitee.com%2Fhacs-china%2Faddons)\n2. 找到`HACS极速版安装器`并安装加载项\n3. 启动加载项并观察日志\n4. 重启HA\n\n#### 方法3️⃣: [`upgrade`](https://my.home-assistant.io/redirect/developer_call_service/?service=hacs.upgrade)服务\n\n\u003e 需要已安装HACS极速版v1.33.0.3版本及以上\n\n1. 在开发者工具中执行服务 [`service: hacs.upgrade`](https://my.home-assistant.io/redirect/developer_call_service/?service=hacs.upgrade)\n2. 重启HA使更新后的HACS生效\n\n#### 方法4️⃣: [`shell_command`](https://my.home-assistant.io/redirect/developer_call_service/?service=shell_command.update_hacs_china)服务\n\n1. 复制代码到HA配置文件 `configuration.yaml`\n    ```yaml\n    shell_command:\n      update_hacs_china: |-\n        wget -O - https://get.hacs.vip | bash -\n    ```\n2. 重启HA使配置生效\n3. 在开发者工具中执行动作 [`action: shell_command.update_hacs_china`](https://my.home-assistant.io/redirect/developer_call_service/?service=shell_command.update_hacs_china)\n4. 再次重启HA使更新后的HACS生效\n\n#### 方法5️⃣: [`Docker安装`](https://hub.docker.com/r/hacn/hacn)\n\n\u003e 仅针对未安装HACS的**Docker**版本的HA\n\n1. 使用命令方式安装\n    ```bash\n    docker run -d \\\n      --name homeassistant \\\n      --privileged \\\n      --restart=unless-stopped \\\n      -e TZ=Asia/Shanghai \\\n      -v /PATH_TO_YOUR_CONFIG:/config \\\n      -v /run/dbus:/run/dbus:ro \\\n      --network=host \\\n      hacn/hacn:stable\n    ```\n2. 使用Compose安装\n    ```yaml\n    services:\n      homeassistant:\n        container_name: homeassistant\n        image: hacn/hacn:stable\n        volumes:\n          - /PATH_TO_YOUR_CONFIG:/config\n          - /etc/localtime:/etc/localtime:ro\n          - /run/dbus:/run/dbus:ro\n        restart: unless-stopped\n        privileged: true\n        network_mode: host\n    ```\n3. 启动后[添加HACS集成](https://my.home-assistant.io/redirect/config_flow_start/?domain=hacs)\n\n#### 方法6️⃣: 手动安装\n\n- [点击这里下载](https://github.com/hacs-china/integration/releases/latest/download/hacs.zip)安装包并解压 (如果下载不了请点[这里](https://ghproxy.com/github.com/hacs-china/integration/releases/latest/download/hacs.zip)或[这里](https://hub.fastgit.xyz/hacs-china/integration/releases/latest/download/hacs.zip))\n- 通过samba/ftp进入HA配置目录，通常为以下目录：\n  - `/usr/share/hassio/homeassistant` haos/hassio宿主机\n  - `/config` haos/hassio的`Samba`或`Terminal \u0026 SSH`加载项\n  - `$HOME/.homeassistant` 以core方式安装的HA默认配置目录\n  - docker安装的HA为`-v`参数后面映射的目录\n- 在HA配置目录下创建`custom_components`文件夹 (如果已有请忽略)\n- 在`custom_components`目录下创建`hacs`文件夹 (如果已有请删除重新创建)\n- 將解压出来的文件复制到刚创建的`hacs`文件夹\n- 重启HA\n- [添加HACS集成](https://my.home-assistant.io/redirect/config_flow_start/?domain=hacs) (仅首次安装)\n\n\u003e ⚠️ 请不要通过下图中的位置下载HACS，会缺少文件\n\u003e ![download hacs](https://user-images.githubusercontent.com/4549099/157629602-422a7bbe-7588-4a81-803e-b295491d78fe.png)\n\n\n\u003ca name=\"proxy\"\u003e\u003c/a\u003e\n\u003ca name=\"mirror\"\u003e\u003c/a\u003e\n## 代理\n\n\u003e **Note**\n\u003e \n\u003e 自v1.27.1.3开始，HACS极速版支持自定义Github API地址，如果你的HACS无法加载集成列表和集成详情，修改此选项会有所改善。\n\u003e 此前的版本仅能解决集成下载不了，而该版本后能解决大部分Github访问不了导致的大部分问题。\n\u003e \n\u003e 不过遗憾的是，首次安装HACS时的授权过程仍然还不能被加速，如果你在授权过程中一直转圈，请稍后再试或使用其他科学的方式。\n\n- 社区提供的免费代理：\n  - `https://ghapi.hacs.vip` - [@al-one](https://github.com/al-one)\n  - `https://ghapi-cf.hacs.vip/api` - [@al-one](https://github.com/al-one)\n  - `https://hacs-china.chrome7.com/api` - [@goxofy](https://github.com/goxofy)\n  - `https://hacs-china.casen.tk/api` - [@CasenChan](https://github.com/CasenChan)\n\n\u003e **Note**\n\u003e \n\u003e 以上地址由贡献者免费提供，是由`Cloudflare Worker`搭建，每个代理每天有10万次请求次数限制，请随机使用上面的代理。\n\u003e 我们建议你使用自己的域名创建代理，当然也可以使用[`freenom.com`](https://freenom.com)的免费域名。\n\n- 创建自己的代理：\n  - 登陆或注册[`Cloudflare`](https://cloudflare.com)添加自己的域名，并修改域名的NS记录\n  - [创建`Worker`服务](https://dash.cloudflare.com/?account=workers)，选择`HTTP 处理程序`\n  - 复制[`index.js`](https://raw.githubusercontent.com/hacs-china/gh-proxy/master/index.js)中的代码，并张贴至Worker的代码编辑器中\n  - 部署并在触发器中添加自定义域名，Worker分配的域名是无法被访问的\n  - 访问`https://your.mirror.domain/api/`检查是否生效\n  - 在HA的集成与服务页面找到已添加的HACS，点击`选项`\n  - 填入地址`https://your.mirror.domain/api`\n\n\n\u003ca name=\"faq\"\u003e\u003c/a\u003e\n## 常见问题\n\n- [极速版和官方HACS的差别有那些？](https://github.com/hacs-china/integration/compare/main...china)\n\n\n------\n\n## 🎉 `Hassio`/`Supervisor`加载项(`Add-ons`)商店镜像：https://gitee.com/hassio 🎉\n\n------\n\n\n# HACS (Home Assistant Community Store)\n\n_Manage (Install, track, upgrade) and discover custom elements for Home Assistant directly from the UI._\n\n## What?\n\nHACS is a integration that gives the user a powerful UI to handle downloads of custom needs.\n\n**Highlights of what HACS can do:**\n\n- Help you discover new custom elements.\n- Help you download new custom elements.\n- Help you keep track of your custom elements.\n  - Manage(download/update/remove)\n  - Shortcuts to repositories/issue tracker\n\n## Useful links\n\n- [General documentation](https://hacs.xyz/)\n- [Configuration](https://hacs.xyz/docs/use/configuration/basic)\n- [FAQ](https://hacs.xyz/docs/faq)\n- [GitHub](https://github.com/hacs)\n- [Discord](https://discord.gg/apgchf8)\n- [Become a GitHub sponsor? ❤️](https://github.com/sponsors/ludeeus)\n- [BuyMe~~Coffee~~Beer? 🍺🙈](https://buymeacoffee.com/ludeeus)\n\n\n## Issues\n\n~~If~~ When you experience issues/bugs with this the best way to report them is to open an issue in **this** repo.\n\n[Issue link](https://hacs.xyz/docs/help/issues)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhacs-china%2Fintegration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhacs-china%2Fintegration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhacs-china%2Fintegration/lists"}