Home Assistant 是一个运行在 Python 3 上的开源家庭自动化平台。监控家里的所有设备并实现自动化控制。

采用开源项目Home Assistant，支持x86_64、armv8的DSM7系统。已集成原版HACS和xiaomi_home插件

矿神群晖SPK套件源内安装

请提前安装社群的Python3.13套件！！！

套件截图

使用须知

1、初始化过程提示

设置好账户密码后，在配置区域和语言界面点击：自动检测 即可补全参数。

2、插件安装举例

v2024.12.5的HA套件已集成原版HACS和xiaomi_home插件，搜索配置即可！

以下内容一般不不不需要再看！！！

以下内容一般不不不需要再看！！！

以下内容一般不不不需要再看！！！

套件的配置目录：/var/packages/HomeAssistant/home/.homeassistant

SSH连接群晖安装插件，过程比较简单，主要是注意最后的权限修复！！！

2.1举例安装HACS最新版

cd /var/packages/HomeAssistant/home/.homeassistant
mkdir -p custom_components/hacs
cd custom_components/hacs
wget https://ghproxy.cn/https://github.com/hacs/integration/releases/latest/download/hacs.zip
7z x hacs.zip
rm hacs.zip
#修复权限
cd /var/packages/HomeAssistant/home/.homeassistant
chown -R HomeAssistant:HomeAssistant custom_components

以上操作完毕后，配置--系统 右上角 重新启动（也可直接重启套件），耐心等待。。。重启OK后 F5 刷新浏览器，配置--添加集成 里面搜索 HACS 启用。

2.2举例安装xiaomi_home最新版

cd /var/packages/HomeAssistant/home/.homeassistant
mkdir -p custom_components/xiaomi_home
cd custom_components/xiaomi_miot
wget https://ghproxy.cn/https://github.com/XiaoMi/ha_xiaomi_home/releases/latest/download/xiaomi_home.zip
7z x xiaomi_home.zip
rm xiaomi_home.zip
#修复权限
cd /var/packages/HomeAssistant/home/.homeassistant
chown -R HomeAssistant:HomeAssistant custom_components

以上操作完毕后，配置--系统 右上角 重新启动（也可直接重启套件），耐心等待。。。重启OK后 F5 刷新浏览器，配置--添加集成 里面搜索 xiaomi_home 启用。

注意：小米账号登陆ok后跳转的 http://homeassistant.local:8123 如果无法访问，只需修改为你实际的IP和端口即可。

如果打开插件提示无法联网，可修改跳过ping验证：
/var/packages/HomeAssistant/home/.homeassistant/custom_components/xiaomi_home/miot/miot_network.py
第190行添加：return True，注意和上一行对齐

    command = ['ping', param, '1', address]
    return True

2.3举例替换HACS为中国极速版（不建议，升级套件时会被覆盖）

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

项目地址： https://github.com/hacs-china/integration 中文介绍： https://gitee.com/hacs-china

cd /var/packages/HomeAssistant/home/.homeassistant
cd custom_components/hacs
#删除原版HACS
rm -rf *
#安装极速版HACS
wget https://ghproxy.cn/https://github.com/hacs-china/integration/releases/latest/download/hacs.zip
7z x hacs.zip
rm hacs.zip
#修复权限
cd /var/packages/HomeAssistant/home/.homeassistant
chown -R HomeAssistant:HomeAssistant custom_components

以上操作完毕后，配置--系统 右上角 重新启动（也可直接重启套件），耐心等待。。。重启OK后 F5 刷新浏览器，配置--添加集成 里面搜索 HACS 启用。

3、套件重置账户密码

#最后的admin是你之前的用户名，admin123是你要修改的密码
/var/packages/HomeAssistant/target/bin/hass --script auth --config /var/packages/HomeAssistant/home/.homeassistant change_password admin admin123
#权限修复，完毕后重启套件生效
chown -R HomeAssistant:HomeAssistant /var/packages/HomeAssistant/home/.homeassistant/.storage/auth_provider.homeassistant

实在记不住密码。。。建议手写记到小本本上。。。

连用户名都忘记了？？？列出全部用户：

/var/packages/HomeAssistant/target/bin/hass --script auth --config /var/packages/HomeAssistant/home/.homeassistant list

Docker版本的参考官方教程：https://www.home-assistant.io/docs/locked_out/#forgot-password