tigerblue77/dell_idrac_fan_controller

Dell iDRAC 风扇控制器 Docker 镜像

镜像概述和主要用途

本 Docker 镜像提供了一个 Dell iDRAC 风扇控制器解决方案，允许用户监控和管理 Dell 服务器的风扇速度。通过使用此镜像，系统管理员可以根据服务器负载和温度自定义风扇控制策略，从而实现更好的散热管理、降低噪音水平并提高服务器能效。

核心功能和特性

• 实时监控 Dell 服务器硬件温度
• 基于温度阈值自动调节风扇速度
• 支持自定义风扇控制策略
• 提供 Web 界面用于配置和监控
• 支持通过 iDRAC API 进行远程管理
• 轻量级设计，资源占用低
• 支持日志记录和报警功能

使用场景和适用范围

• Dell PowerEdge 系列服务器的风扇管理
• 需要降低服务器机房噪音的环境
• 对服务器功耗有严格要求的数据中心
• 运行在非标准环境或高温环境中的服务器
• 需要自定义散热策略的高性能计算场景
• 希望通过 Docker 容器化方式管理服务器硬件的环境

详细使用方法和配置说明

前提条件

• 运行 Docker 的主机
• 网络可达的 Dell iDRAC 接口
• iDRAC 管理员账户凭证
• 适当的网络权限（默认使用 8080 端口）

基本使用方法

使用 docker run 命令

bash
docker run -d \
  --name dell-idrac-fan-controller \
  -p 8080:8080 \
  -e IDRAC_HOST=192.168.0.100 \
  -e IDRAC_USER=root \
  -e IDRAC_PASSWORD=calvin \
  -e TEMP_THRESHOLD_LOW=35 \
  -e TEMP_THRESHOLD_HIGH=65 \
  tigerblue77/dell-idrac-fan-controller

使用 docker-compose

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  idrac-fan-controller:
    image: tigerblue77/dell-idrac-fan-controller
    container_name: dell-idrac-fan-controller
    ports:
      - "8080:8080"
    environment:
      - IDRAC_HOST=192.168.0.100
      - IDRAC_USER=root
      - IDRAC_PASSWORD=calvin
      - TEMP_THRESHOLD_LOW=35
      - TEMP_THRESHOLD_HIGH=65
      - LOG_LEVEL=info
      - CHECK_INTERVAL=30
    restart: unless-stopped

启动容器：

bash
docker-compose up -d

环境变量配置参数

Web 界面访问

启动容器后，可以通过以下 URL 访问 Web 界面：

http://<docker-host-ip>:8080

Web 界面提供以下功能：

• 实时温度监控
• 风扇速度控制
• 配置参数修改
• 日志查看
• 控制策略调整

高级配置

自定义风扇曲线

可以通过挂载配置文件来自定义风扇速度曲线：

bash
docker run -d \
  --name dell-idrac-fan-controller \
  -p 8080:8080 \
  -e IDRAC_HOST=192.168.0.100 \
  -e IDRAC_USER=root \
  -e IDRAC_PASSWORD=calvin \
  -v /path/to/custom/fan-curve.json:/app/config/fan-curve.json \
  tigerblue77/dell-idrac-fan-controller

fan-curve.json 文件示例：

json
{
  "curve": [
    {"temperature": 20, "speed": 15},
    {"temperature": 30, "speed": 20},
    {"temperature": 40, "speed": 30},
    {"temperature": 50, "speed": 45},
    {"temperature": 60, "speed": 65},
    {"temperature": 70, "speed": 85},
    {"temperature": 80, "speed": 100}
  ]
}

启用报警功能

要启用温度报警功能，可以设置以下环境变量：

bash
docker run -d \
  --name dell-idrac-fan-controller \
  -p 8080:8080 \
  -e IDRAC_HOST=192.168.0.100 \
  -e IDRAC_USER=root \
  -e IDRAC_PASSWORD=calvin \
  -e ALERT_ENABLED=true \
  -e ALERT_THRESHOLD=75 \
  -e SMTP_SERVER=smtp.example.com \
  -e SMTP_PORT=587 \
  -e SMTP_USER=alert@example.com \
  -e SMTP_PASSWORD=smtp_password \
  -e ALERT_EMAIL=admin@example.com \
  tigerblue77/dell-idrac-fan-controller

故障排除

常见问题

1. 无法连接到 iDRAC

   • 检查网络连接和防火墙设置
   • 验证 iDRAC 主机地址和端口是否正确
   • 确认 iDRAC 用户凭证是否有效

2. 风扇速度没有变化

   • 检查 iDRAC 是否启用了手动风扇控制模式
   • 验证用户是否具有管理员权限
   • 检查温度传感器是否正常工作

3. 容器启动后立即退出

   • 查看容器日志：docker logs dell-idrac-fan-controller
   • 检查是否提供了所有必填的环境变量

获取帮助

• GitHub 仓库：https://github.com/tigerblue77/Dell_iDRAC_fan_controller_Docker
• 提交 Issue：https://github.com/tigerblue77/Dell_iDRAC_fan_controller_Docker/issues

维护和更新

更新镜像

bash
docker pull tigerblue77/dell-idrac-fan-controller
docker stop dell-idrac-fan-controller
docker rm dell-idrac-fan-controller
# 重新运行容器，使用之前的启动命令

使用 Docker Compose 更新

bash
docker-compose pull
docker-compose up -d

注意事项

• 使用本工具可能会影响服务器保修，请在使用前确认相关条款
• 不当的风扇控制可能导致服务器过热和硬件损坏，请谨慎配置
• 建议先在非生产环境中测试自定义风扇策略
• 定期更新镜像以获取最新功能和安全修复
• 确保 iDRAC 固件是最新版本以获得最佳兼容性