https://github.com/swaggymacro/fanx

Web platform for intelligent fan control and monitoring on Dell servers, built with .NET 8 and Blazor. Features real-time monitoring, smart fan speed adjustment, multi-channel notifications, permission management, and multilingual UI. 基于 .NET 8 和 Blazor 的戴尔服务器风扇智能监控与控制平台，支持实时监控、智能调速、多通知渠道、权限管理与多语言界面。
https://github.com/swaggymacro/fanx

blazor bmc dell fan fan-control idrac ipmitool server

Last synced: 11 months ago
JSON representation

Web platform for intelligent fan control and monitoring on Dell servers, built with .NET 8 and Blazor. Features real-time monitoring, smart fan speed adjustment, multi-channel notifications, permission management, and multilingual UI. 基于 .NET 8 和 Blazor 的戴尔服务器风扇智能监控与控制平台，支持实时监控、智能调速、多通知渠道、权限管理与多语言界面。

• Host: GitHub
• URL: https://github.com/swaggymacro/fanx
• Owner: SwaggyMacro
• License: gpl-3.0
• Created: 2025-07-16T08:00:48.000Z (11 months ago)
• Default Branch: master
• Last Pushed: 2025-07-17T07:58:38.000Z (11 months ago)
• Last Synced: 2025-07-17T11:11:05.134Z (11 months ago)
• Topics: blazor, bmc, dell, fan, fan-control, idrac, ipmitool, server
• Language: HTML
• Homepage:
• Size: 4.29 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ![.NET](https://img.shields.io/badge/.NET-8.0-blue) ![Version](https://img.shields.io/badge/version-1.0.0-brightgreen) [![English](https://img.shields.io/badge/EN-README-blue)](README_EN.md)

# FanX

Jump to: [English Version](README_EN.md)

FanX 是一款基于 .NET 8 和 Blazor 的风扇控制与监控平台，主要用于戴尔服务器（支持 BMC 的理论上应该也可以用），能够实时监控设备运行状态，并根据自定义或智能规则动态调节风扇转速，在确保系统温度和功率在安全范围内可降低一定的噪音。  

**iDrac `3.30.30.30` 版本以上不再支持手动调速**，唯一方法只有降级**iDrac**，降级有风险。

## 核心功能

- 实时监控：

  - 功率（Power）

  - 风扇转速（Fan Speed）

  - CPU 温度

  - 主板进出口温度（Inlet/Outlet Temperature）

- 自定义规则通知：

  - 当温度或转速达到设定阈值时，触发通知

  - 支持单个或多个风扇目标监控和通知

  - 通知渠道支持：企业微信机器人、Webhook、Telegram 机器人、邮箱

- 智能风扇控制：

  - 根据温度自动调整一个或多个风扇的转速

  - 规则示例：当 CPU 温度 ≥ 70℃ 时，将风扇 A 转速设置为 80%，风扇 B 转速设置为 60%

  - 支持多级温度—转速映射曲线，精细化控制

- IPMI 接口支持（Linux/Windows）：

  - 通过 ipmitool 与 BMC 通信（Windows 环境自带 ipmitool，Linux 需手动安装），获取传感器数据或下发控制指令

  - 支持 Red Hat、Ubuntu 等常见发行版一键安装依赖（Linux）

- 日志与历史数据：

  - 支持日志保留天数设置和传感器数据保留策略

  - 可视化历史曲线展示温度、转速和功率变化趋势

- 用户及权限管理：

  - 管理员与普通用户分级权限

  - 支持注册、登录、重置密码等功能

- 多语言支持：

  - 支持中文和英文界面切换

- 深色/浅色主题切换

- 支持 Docker 部署

## 依赖要求

- .NET 8 SDK 或运行时

  - Linux 用户可以通过包管理器安装：

    ```bash

    # Ubuntu/Debian

    sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0

    # RHEL/CentOS/Fedora

    sudo dnf install -y dotnet-sdk-8.0

    ```

  - Windows 用户可以从 [.NET 官网](https://dotnet.microsoft.com/download/dotnet/8.0) 下载安装程序。

- ipmitool（Linux 用户需要手动安装，Windows 用户自带）

    - Linux 用户可以通过包管理器安装 ipmitool：

    ```bash

        # Ubuntu/Debian

        sudo apt-get update && sudo apt-get install -y ipmitool

        # RHEL/CentOS/Fedora

        sudo dnf install -y ipmitool

    ```

## 快速上手

### 从 Release 下载

1. 前往 [Release 页面](https://github.com/SwaggyMacro/FanX/releases) 下载最新版本的压缩包。

2. 解压缩下载的文件。

3. 运行应用程序：

   Linux 用户可以使用以下命令运行：

   ```bash

    dotnet FanX.dll

    ```

   Windows 用户可以直接双击 `FanX.exe` 运行。

4. 在浏览器中访问以下地址，使用管理员账号登录并开始配置：

    - http://localhost:5136

    - 默认管理员账号：

      - 账号：`admin`

      - 密码：`admin123`

### Docker 部署

你可以使用项目中提供的 [docker-compose.yml](docker-compose.yml) 文件进行 Docker 部署，这样可以在容器化环境中运行 FanX，所有依赖都将自动管理。

或者你也可以直接使用 Docker 命令部署：

```bash

docker run -d \

  --name fanx \

  -p 5136:5136 \

  -v /docker/fanx/data:/app/data \

  -v /docker/fanx/logs:/app/logs \

  -v /etc/timezone:/etc/timezone:ro \

  -v /etc/localtime:/etc/localtime:ro \

  realswaggymacro/fanx:latest

```

   

### 克隆并运行

1. 克隆仓库：

   ```bash

   git clone https://github.com/SwaggyMacro/FanX.git

   cd FanX

   ```

2. 安装依赖（Linux）：

   ```bash

   # Ubuntu/Debian

   sudo apt-get update && sudo apt-get install -y ipmitool

   # RHEL/CentOS/Fedora

   sudo dnf install -y ipmitool

   ```

3. 无需手动编辑配置文件，系统提供默认配置并支持在界面中调整通知和数据库连接等设置。

4. 编译并运行：

   ```bash

   dotnet build

   dotnet run --project FanX/FanX.csproj

   ```

5. 在浏览器访问以下地址，使用管理员账号登录并开始配置：

    - http://localhost:5136

    - 默认管理员账号：

      - 账号：`admin`

      - 密码：`admin123`

## 如何使用

- 登录后，您可以在 `/ipmi-config` 页面配置 BMC(iDrac) 地址、用户名和密码。

- 在 `/fan-control` 页面定义自定义或智能风扇控制规则。

- 在 `/notifications` 页面配置通知渠道和规则，包括企业微信机器人、Webhook、Telegram 机器人、邮箱等。

- 在 `/settings` 页面设置日志保留天数、传感器数据保留策略等。(默认30天)

> 如果你需要手动调控风扇，可以在 `/fan-control` 页面设置为手动控制，然后前往 `/debug` 页面手动调节风扇转速，支持单个风扇手动调节。

## 配置说明

- `/ipmi-config` 页面：配置 BMC(iDrac) 地址、用户名、密码

- `/fan-control` 页面：定义自定义或智能风扇控制规则

- `/notifications` 页面：配置通知渠道和规则，包括企业微信机器人、Webhook、Telegram 机器人、邮箱等

- `/settings` 页面：设置日志保留天数、传感器数据保留策略等

## 玩法

比如你可以设置一个智能规则，规则如下图，可实现内容：

- CPU1 > 80度 给 123号风扇 80% 转速, CPU2 > 80度 给 456号风扇 80% 转速

- CPU1 > 70度 给 123号风扇 50% 转速, CPU2 > 70度 给 456号风扇 50% 转速

- CPU1 > 60度 给 123号风扇 30% 转速, CPU2 > 60度 给 456号风扇 30% 转速

- CPU1 > 50度 给 123号风扇 20% 转速, CPU2 > 50度 给 456号风扇 15% 转速

  - 因为我这 CPU1 温度会比 CPU2 高，所以我设置了在 CPU1 侧的123号风扇转速更高

- CPU1 < 50度 给 123号风扇 10% 转速, CPU2 < 50度 给 456号风扇 10% 转速

> 同时你也可以根据进风口温度和出风口温度来设置风扇转速，或者根据功率来设置风扇转速。

![玩法示例](Screenshot/screenshot_smart_rule_example.png)

## 已测试设备

- Dell PowerEdge R720xd

理论上支持BMC的服务器都可以使用，如 T640, R510, R720, R720xd, R730, R730xd, R740, R740xd 等。

## 贡献与反馈

欢迎提 Issue 或 Pull Request，或在项目主页上讨论交流！

## 使用截图

![控制台](Screenshot/screenshot_dashboard_cn.png)

![控制台图表](Screenshot/screenshot_dashboard_chart_cn.png)

![风扇控制](Screenshot/screenshot_fancontrol_cn.png)

![智能规则](Screenshot/screenshot_smart_rule_cn.png)

![通知配置](Screenshot/screenshot_notification_cn.png)

![Telegram 通知](Screenshot/screenshot_tg.png)

![企业微信机器人](Screenshot/screenshot_wecom.png)

---

© 2025 SwaggyMacro