绿联NAS dxp系列接入 Home Assistant

通过 Home Assistant自带的MQTT组件接入绿联NAS的运行数据，温度信息。
绿联NAS的散热风扇不能自己调整转速曲线，通过 Home Assistant进行自动化的转速调整

2026-01-06更新
修复新系统更新后导致网络上传下载不更新的问题，采用websocket的方式让NAS自动推送 CPU使用率、网络速率，实现于APP、WEB、PC一致的更新频率。只需要在docker容器种点击更新即可，如果没提示更新 就右键检查更新

兼容最新系统

近期看到一个可通过参数配置的形式调整风扇温控，可以尝试一下綠聯更改風扇參數
https://club.ugnas.com/forum.php?mod=viewthread&tid=1431
来自: 绿联NAS私有云社区

再次声明：

需要管理员账号登录 ！！！
需要管理员账号登录 ！！！

效果预览



部署教程

镜像拉取

1. docker pull yougood/ugreen-ha

复制代码

或者直接图形化拉取


创建容器

1. docker run -d -p 1883:1883 --name ugreen-ha -e UGREEN_SERVER="http://ip:port" -e UGREEN_USERNAME="username" -e UGREEN_PASSWORD="password" yougood/ugreen-ha

复制代码

变量说明

• UGREEN_SERVER：你的NAS地址（http://ip:port）不能使用https端口，可以使用局域网地址，也可以使用docker网关地址：默认采用birdge网络模式启动，ip就是你的子网网关：比如172.17.0.1
• UGREEN_USERNAME：NAS管理员用户名
• UGREEN_PASSWORD：NAS管理员密码
• MQTT_SERVER：mqtt服务器地址，默认：使用内置MQTT服务，需要使用其他MQTT服务设置这个地址 和 下面的账号就可以了
• MQTT_USERNAME：mqtt服务器用户名，默认：mqtt
• MQTT_PASSWORD：mqtt服务器密码，默认：password
  

注意这个子网地址，对应的就是你的子网网关172.17.0.1


创建完成后直接启动，配置没有问题的话日志会打印你的nas信息



Home Assistant 添加集成


这里的MQTT配置的IP和端口 取决于你自己的网络配置，端口就是刚刚部署的docker映射出来的端口，比如我的是39078 这里就填39078

• 添加MQTT设备后正常应该是可以出现设备的，如果没有出现设备，就重启一下docker中的项目，或者点击MQTT服务的 右边的 ... 进行重新加载
• 正常情况下就会出现你的设备名称
  

自动化相关
自动化这个可以自由发挥，这里简单介绍几个温度过高就开启全速风扇，温度正常就开启普通风扇

### 硬盘温度高开启全速风扇


### 硬盘温度正常调整正常风扇

docker部署部分能不能写详细一些，完全运行不起来

没有车的老司机 发表于 2025-10-16 14:11
docker部署部分能不能写详细一些，完全运行不起来

提供一些docker运行的日志，一共只要修改三个参数即可运行 服务地址 账号和密码就行，如果你在nas的docker运行不修改网络的情况下 UGREEN_SERVER = http://172.17.0.1:[你自己的nas端口]

oshima 发表于 2025-10-16 14:57
提供一些docker运行的日志，一共只要修改三个参数即可运行 服务地址 账号和密码就行，如果你在nas的docke ...

我再试试

oshima 发表于 2025-10-16 14:57
提供一些docker运行的日志，一共只要修改三个参数即可运行 服务地址 账号和密码就行，如果你在nas的docke ...

你上面的截图有几个地方会误导，比如MQTT的配置，地址应该写局域网nas地址，而不是途中的127.0.0.1，端口也不是1883，而是在docker创建时，分配的端口号

没有车的老司机 发表于 2025-10-16 15:14
你上面的截图有几个地方会误导，比如MQTT的配置，地址应该写局域网nas地址，而不是途中的127.0.0.1，端口 ...

因为我的Home Assistant是用host网络部署的 所有先127.0.0.1是能正常连接的，端口1883是我程序的端口 也是mqtt的端口，这个要你们自己修改成你们docker的分配端口或者 自己把端口修改成1883

2025-10-16 16:46:00 ERROR 请求失败：cdoe:1024,debug:Err - code: 1024, message: Login has expired, please login again!
2025-10-16 16:46:30 ERROR 收到信息：{"code":1010,"msg":"Token不可为空!","debug":"Err - code: 1010, message: Token cannot be empty!","data":{},"time":0.000194102}
2025-10-16 16:47:00 ERROR 收到信息：{"code":1010,"msg":"Token不可为空!","debug":"Err - code: 1010, message: Token cannot be empty!","data":{},"time":0.000261312}
2025-10-16 16:47:00 ERROR 收到信息：{"code":1010,"msg":"Token不可为空!","debug":"Err - code: 1010, message: Token cannot be empty!","data":{},"time":0.000313864}
请问这个错误是什么原因

没有车的老司机 发表于 2025-10-16 16:50
2025-10-16 16:46:00 ERROR 请求失败：cdoe:1024,debug:Err - code: 1024, message: Login has expired, pl ...

你这个就是能连上nas了，前面有提示过登录账号登录成功吗？ 检查一下账号密码
还有就是 这个需要使用管理员账号登录，有些接口只有管理员有权限

oshima 发表于 2025-10-16 16:58
你这个就是能连上nas了，前面有提示过登录账号登录成功吗？ 检查一下账号密码
还有就是 这个需要使用管理 ...

有提示账号登录成功，也是管理员账户，ha里面也有信息更新，就是没隔一段实际日志就有这一段错误信息。

没有车的老司机 发表于 2025-10-16 17:00
有提示账号登录成功，也是管理员账户，ha里面也有信息更新，就是没隔一段实际日志就有这一段错误信息。 ...

哦哦 这个不用管的，因为token会过期，我会自动重新登录的，到时候我改一下日志输出就好了