dockerdaan/r510-denoiser

R510-Denoiser

镜像概述

R510-Denoiser是一款支持MQTT协议的风扇控制器，专为Dell R510服务器及其他配备IDRAC6的设备设计。其核心功能是通过MQTT协议实现风扇转速的远程控制，同时具备HomeAssistant自动发现能力（需在HomeAssistant的MQTT集成中启用MQTT发现功能）。

安全警告

为使本项目正常工作，需将主机的/dev/ipmi0设备暴露给Docker容器，此配置未经充分测试。IPMI协议除风扇控制外，还具备关闭整个机箱电源等强大功能。请务必评估相关安全风险，并谨慎部署。

环境变量

必填变量

• FANNAME：风扇的友好名称，不可包含空格（未对输入进行规范化处理）
• MQTTHOST：MQTT服务器的IP地址或主机名

可选变量

• MQTTPORT：MQTT服务器端口，默认值为1883
• MQTTCLIENTNAME：连接MQTT服务器时使用的客户端名称，默认值为r510-denoiser
• //TODO：添加认证相关配置

安装方法

Docker Compose

注意：不支持Swarm模式（因需设备映射）

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  r510-denoiser:
    image: dockerdaan/r510-denoiser:latest
    environment:
      - FANNAME=myr510fan  # 替换为实际风扇名称，不含空格
      - MQTTHOST=192.168.1.100  # 替换为MQTT服务器IP或主机名
      # 可选环境变量
      # - MQTTPORT=1883
      # - MQTTCLIENTNAME=r510-denoiser
    devices:
      - /dev/ipmi0:/dev/ipmi0  # 设备映射
    restart: unless-stopped

执行部署命令：

bash
docker-compose up -d

Portainer

1. 新建容器，镜像选择 dockerdaan/r510-denoiser:latest
2. 在"Env"标签页添加必填环境变量：
   • FANNAME：风扇名称（不含空格）
   • MQTTHOST：MQTT服务器地址
   • （可选）添加MQTTPORT和MQTTCLIENTNAME
3. 在"Runtime & Resources"标签页添加设备映射：/dev/ipmi0:/dev/ipmi0
4. 启动容器

使用说明

HomeAssistant集成

若安装配置正确，风扇设备将自动出现在HomeAssistant的MQTT集成中，可直接通过HomeAssistant界面进行控制。

手动MQTT控制

通过MQTT主题 $FANNAME/fansetpoint 发送指令进行手动控制，接受以下值：

• 整数：1-100（表示风扇转速百分比）
• 字符串：auto（恢复Dell默认风扇曲线）

示例：若FANNAME为myr510fan，发送50到主题myr510fan/fansetpoint，可将风扇转速设置为50%。