When installing HACS in China, it is recommended to use the HACS Fast Version or proxy acceleration, which supports various installation methods.
Due to network environment restrictions, it is recommended to use the HACS Fast Version or proxy acceleration when installing HACS (Home Assistant Community Store) in China. Here are several common installation methods:
Method 1: One-click command installation (recommended)
Execute in the Home Assistant terminal (Terminal & SSH plugin or host SSH):
wget -O - https://get.hacs.vip | bash -
# or
curl -fsSL get.hacs.vip | bash
Applicable for haos/hassio/supervised versions. If it is core/docker version, you need to enter the HA configuration directory first before executing. Restart Home Assistant after installation. https://github.com/hacs-china
Here I am using the docker version of HomeAssistant for installation, the effect is as follows
/config # wget -O - https://get.hacs.vip | bash -
Connecting to get.hacs.vip (198.23.254.39:443)
writing to stdout
- 100% |********************************************************************| 6882 0:00:00 ETA
written to stdout
INFO: Archive URL: https://ghrp2.hacs.vip/hacs-china/integration/releases/latest/download/hacs.zip
INFO: Trying to find the correct directory...
INFO: Found Home Assistant configuration directory at '/config'
INFO: Creating custom_components directory...
INFO: Changing to the custom_components directory...
INFO: Downloading...
Connecting to ghrp2.hacs.vip (93.90.73.5:443)
saving to '/config/custom_components/latest.zip'
latest.zip 100% |********************************************************************| 17.9M 0:00:00 ETA
'/config/custom_components/latest.zip' saved
INFO: Unpacking...
INFO: Copying new files...
INFO: Removing temp files...
INFO: Installation complete.
INFO: Installation successful!
INFO: Remember to restart Home Assistant before you configure it.
INFO: Please restart Home Assistant
After restarting the container, add integration, search for HACS to add it.
Effect after installation is complete
Method 2: Add-on installer
- Add the add-on repository: https://gitee.com/hacs-china/addons
- Find and install "HACS Fast Version Installer" in the add-on store.
- Start the add-on, observe the logs, and restart HA. https://github.com/hacs-china
Method 3: Manual installation
- Download the HACS Fast Version installation package (available at hacs-china (https://github.com/hacs-china) or related websites).
- Access the HA configuration directory (e.g., /config) via samba/ftp/ssh.
- Create a new hacs folder under custom_components and copy the extracted files into it.
- Restart HA and add the HACS integration. http://hasshome.net/h-nd-75.html
Method 4: Docker installation
If you are using Docker, you can directly use the accelerated image:
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
Or use Compose, see hacs-china repository (https://github.com/hacs-china).https://github.com/hacs-china
Proxy acceleration
The HACS Fast Version supports custom Github API proxy addresses, commonly used free proxies include:
• https://ghapi.hacs.vip
• https://ghapi-cf.hacs.vip/api
• https://hacs-china.chrome7.com/api
If you encounter slow or failed loading of the integration list, you can set the proxy in the HACS options. https://github.com/hacs-china
Notes
• The first authorization of HACS still requires scientific internet access, it is recommended to prepare a proxy in advance.
• The HACS Fast Version shares configuration with the official version and can be switched at any time.
• Detailed tutorials and common questions can refer to the hacs-china official documentation (https://github.com/hacs-china) or HACS and (domestic) installation preparation (https://www.hachina.io/).