Anexgohan/pankha

# Pankha 风扇控制 (पंखा)

_{No install required}

**Pankha 风扇控制** 是一个开源的、适用于任何 PC 的风扇和温度管理系统——无论是单一台式机、服务器，还是家庭实验室集群。构建更智能的风扇曲线，降低噪音，降低温度，并通过一个网络仪表板管理所有机器。支持 Windows 和 Linux。免费，可自行托管，无遥测数据收集。           ## 什么是 Pankha 风扇控制？ **Pankha 风扇控制** 是一款开源软件，让您能完全控制系统的散热。 构建自定义风扇曲线，实时监控温度，并根据您的精确偏好调整转速和噪音——无论是在单个台式机、家庭实验室，还是一个服务器集群上。 无论您管理一台机器还是一百台机器，它的运行方式都相同。网络仪表板可在任何设备上的任何浏览器中运行。代理程序轻量级，后端可自行托管，并且您的硬件信息绝不会离开您的网络。 它旨在支持单个 Windows 或 Linux PC，或多个服务器、虚拟机、NAS、PC——能够处理任何规模的设备。 ## 功能特性 - **更安静的 PC，更低的温度：** 具有滞后和步进功能的智能风扇曲线，消除了原始 BIOS 风扇配置文件导致的始终全力运行的噪音和温度骤升。 - **将所有信息整合到‘一个仪表板’中：** 统一的网络用户界面，适用于 1 台或 100 台系统，可在 Windows、Linux 或 IPMI/BMC 控制的服务器上运行，在一个仪表板上管理您所有机器的风扇和温度，包括 Windows、Linux、带直通设备的虚拟机（如 GPU、PCIe 卡、HBA 等）以及 x64 或 ARM 架构的设备。 - **可视化配置编辑器：** 拖放式曲线编辑器，支持导入/导出，以便您可以在不同机器之间构建、共享和重用风扇配置文件。 - **真实硬件控制：** 直接 PWM 控制与实时转速反馈，支持针对单个风扇的策略，以及始终在线的紧急温度超驰控制。 - **实时监控：** 通过 WebSocket 实时传输 CPU、GPU、NVMe、主板和芯片组的温度、转速和历史数据。 - **设计安全：** 如果后端不可达，代理程序会回退到可配置的安全风扇转速，并带有本地紧急温度超驰控制。 - **轻量且快速：** Linux 代理程序是单个 Rust 二进制文件，内存占用低于 15MB，CPU 占用低于 1%。Windows 代理程序作为 .NET 8 服务运行，内存占用低于 25MB，CPU 占用低于 1%，并具备完整的 LibreHardwareMonitor 访问权限。IPMI/BMC 代理程序占用的资源更少。 - **开源，可自行托管：** AGPL-3.0 许可，无云服务，无遥测数据。PostgreSQL 后端，单容器 Docker 部署。 ## 支持的系统与架构 Pankha 旨在通过一个界面管理您所有硬件的散热配置文件。无论您是在调整游戏台式机、个人 Linux 机器，还是同时管理多台计算机，Pankha 都能让您的系统占用资源更少，控制更加绝对。 | 功能 / 系统 | 🪟 Windows 桌面 | 🐧 Linux 系统 | 💻 集中仪表板 | | :--- | :--- | :--- | :--- | | **理想用途** | 游戏主机、工作站、虚拟或远程桌面 | 日常使用机、服务器、主机/节点、带直通设备的虚拟机 | 任何现代网络浏览器（手机/PC） | | **技术栈** | C# / .NET（原生客户端） | Rust（轻量级二进制文件） | TypeScript / React 后端 | | **部署方式** | 快速安装 `.msi` 包 | 预配置的独立二进制文件 | 一键 Docker Compose 设置 | | **资源占用** | 几乎为零的后台内存和 CPU 占用 | 几乎为零的后台内存和 CPU 占用 | 低开销的 WebSocket 中心 | | **硬件链接** | 通过 LibreHardwareMonitor | 直接内核级设备映射 | 实时聚合数据流 | | **安装** | 全自动/引导式安装 | 即时预配置二进制文件 | 自托管或本地执行 | ## Pankha 风扇控制适用于谁？ **任何希望对散热进行比原生工具更多控制的人。** 从单个安静的台式机到服务器集群——相同的仪表板，相同的工作流程。 - **PC 组装者和游戏玩家：** 用智能自定义风扇曲线取代原始 BIOS 风扇曲线；在不牺牲散热的前提下使您的台式机更安静。 - **Windows 用户：** 一个无需云服务、无需账户的风扇工具，无需为每台机器进行配置。 - **Linux 桌面和服务器用户：** 在无头服务器（Debian、Ubuntu、RHEL、Proxmox、TrueNAS）上实现 PWM 风扇控制，无需图形界面。 - **家庭实验室爱好者和自托管者：** 从一个地方管理 Proxmox 主机、NAS 和虚拟化主机。 - **服务器管理员：** 为通过 IPMI/BMC 控制的 Dell PowerEdge、HP ProLiant 和 Supermicro 硬件提供可读的风扇曲线和网络用户界面，解决即使在空闲时风扇也持续高速运转的问题。 - **任何管理多台机器的人：** 配置一个或多个配置文件，并应用到任意多的机器上。 ## 截图

Agent widget	Temperature sensors
Fan control with RPM feedback	Fan profiles
Customisable profile editor	Profile import / export

## 快速开始 ### 概述： 1. 部署后端服务器（Docker） 2. 在您希望控制的每台机器上安装相应的代理程序（Linux、Windows、IPMI/BMC） 3. 打开仪表板，开始调整您的风扇曲线！ ###  服务器（Docker） ``` wget -O compose.yml https://github.com/Anexgohan/pankha/releases/latest/download/compose.yml wget -O .env https://github.com/Anexgohan/pankha/releases/latest/download/example.env docker compose pull && docker compose up -d ``` 在 `http://localhost:3143`（或您配置的 `PANKHA_PORT`）打开仪表板。 [](https://github.com/Anexgohan/pankha/wiki/Server-Installation) ###  Linux 代理程序（Rust） **A. 推荐方式 - 通过“一体化部署”进行一行安装** 在仪表板中，打开 **部署 → 一体化部署**，配置您的选项，并复制生成的命令。它看起来会是这样： ``` # 这是一个例子 wget -qO- "http://:/api/deploy/linux?token=" | bash # 或 curl -sSL "http://:/api/deploy/linux?token=" | bash ``` **B. 手动安装**

显示 x64 / ARM64 手动安装（wget 或 curl）

#####   Intel / AMD x64： 使用 wget： ``` wget -O pankha-agent https://github.com/Anexgohan/pankha/releases/latest/download/pankha-agent-linux_x64 chmod +x pankha-agent ``` 或使用 curl： ``` curl -fsSLo pankha-agent https://github.com/Anexgohan/pankha/releases/latest/download/pankha-agent-linux_x64 chmod +x pankha-agent ``` #####  ARM64（Raspberry Pi 5 等）： 使用 wget： ``` wget -O pankha-agent https://github.com/Anexgohan/pankha/releases/latest/download/pankha-agent-linux_arm64 chmod +x pankha-agent ``` 或使用 curl： ``` curl -fsSLo pankha-agent https://github.com/Anexgohan/pankha/releases/latest/download/pankha-agent-linux_arm64 chmod +x pankha-agent ``` 然后进行配置（适用于两者）： ``` sudo ./pankha-agent --setup ``` 列出所有命令：`./pankha-agent --help`

### [](https://github.com/Anexgohan/pankha/wiki/Agents-Linux) ###  Windows 代理程序（.NET 8）： 从最新版本下载 **[pankha-agent-windows_x64.msi](https://github.com/Anexgohan/pankha/releases/latest/download/pankha-agent-windows_x64.msi)**。安装程序会设置后台服务和托盘应用。右键单击托盘图标 → **设置** → 设置后端 URL。完成。 从仪表板控制您的风扇并监控您的温度！ [](https://github.com/Anexgohan/pankha/wiki/Agents-Windows) ##  Pankha 风扇控制的工作原理       一个中心化的**后端**（包含 Node.js、PostgreSQL 和 WebSocket 中心的 Docker 容器）协调运行在您想要控制的每台机器上的轻量级**代理程序**。 **组件** - **后端** - Node.js + Express + WebSocket + PostgreSQL，作为单个 Docker 容器部署。 - **前端** - React + TypeScript + Vite，直接作为网络 GUI 仪表板在 `http://:` 上提供服务。 - **Linux 代理程序** - 单个 Rust 二进制文件，内存占用 <15MB，CPU 占用 <1%，通过 `sysfs` 访问硬件，零运行时依赖。 - **Windows 代理程序** - 自安装 .NET 8 服务，内存占用 <25MB，CPU 占用 <1%，能够通过 LibreHardwareMonitor 完全访问任何 Windows 机器上的所有传感器和风扇。 **工作原理** - 代理程序每隔几秒钟（可配置）通过 WebSocket 将传感器和风扇读数推送到后端；后端计算增量，并且仅在需要时广播变化以最小化带宽。 - 后端评估您的风扇曲线，并实时将控制命令发送回代理程序。 - 前端连接到后端以显示实时传感器读数和风扇转速，并将配置文件更新、配置和用户更改发送回后端。 - 如果后端不可达，代理程序进入**故障安全模式** - 使用可配置的安全风扇转速和本地紧急温度超驰控制。 ``` Browser <-HTTP/WebSocket-> Backend (Docker) <-WebSocket-> Agents <-Direct-> Hardware ``` [](https://github.com/Anexgohan/pankha/wiki/Architecture) ##  文档 [](https://github.com/Anexgohan/pankha/wiki)

 - [安装](https://github.com/Anexgohan/pankha/wiki/Server-Installation) - [配置](https://github.com/Anexgohan/pankha/wiki/Server-Configuration)

 - [Linux](https://github.com/Anexgohan/pankha/wiki/Agents-Linux) - [Windows](https://github.com/Anexgohan/pankha/wiki/Agents-Windows) - [设置](https://github.com/Anexgohan/pankha/wiki/Agents-Advanced-Settings)

 - [API 参考](https://github.com/Anexgohan/pankha/wiki/API-Reference) - [风扇配置文件](https://github.com/Anexgohan/pankha/wiki/Fan-Profiles)

 - [故障排除](https://github.com/Anexgohan/pankha/wiki/Troubleshooting) - [从源码构建](https://github.com/Anexgohan/pankha/wiki/Development-Build)

## 许可证 Pankha 风扇控制根据 [AGPL-3.0](LICENSE) 许可 。商业许可同样可用 - 请参阅 [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md)。

标签：Awesome, Docker容器, MITM代理, Web仪表板, WSL, 免费软件, 可视化界面, 多人体追踪, 多系统, 家庭实验室, 性能优化, 攻击面发现, 无遥测, 服务器管理, 检测绕过, 测试用例, 温度控制, 硬件控制, 系统管理, 自动化攻击, 自托管, 请求拦截, 远程管理, 集中管理, 风扇曲线