fnos-fan-control

解决什么问题？

飞牛NAS 默认的风扇策略往往不够灵活：低负载时噪音大，高负载时散热不积极。fnos-fan-control 让你完全掌控风扇行为——从保守到激进，从固定转速到智能曲线，一个 FPK 应用搞定。

下载安装

最新版本下载

历史版本请前往 GitHub Releases 页面查看。

安装前提

• 飞牛NAS (fnOS) x86 平台
• Python 3.11+：在飞牛应用中心搜索 python312 并安装

安装步骤

第一步：下载 FPK 安装包

点击上方下载链接，保存 .fpk 文件到本地。

第二步：上传安装

打开飞牛管理界面 → 应用中心 → 点击右上角「手动安装」→ 上传 .fpk 文件。

第三步：配置密码（可选）

安装向导中会提示设置访问密码。如果不需要密码认证，留空即可。

第四步：访问管理界面

安装完成后，在飞牛桌面点击应用图标，或直接访问：

http://你的NAS地址:端口

端口号在安装完成后会显示。

命令行安装（高级）

# 通过 CLI 安装
appcenter-cli install-fpk fan-control-1.1.1.fpk -v 1

卸载与重装

如果安装时提示”检查用户组失败”，以 root 执行清理脚本：

# 清理脚本随应用安装自动释放到 /tmp
bash /tmp/cleanup-fan-control.sh

如果服务器重启过导致脚本丢失，手动执行：

userdel fan-control 2>/dev/null
groupdel fan-control 2>/dev/null
for vol in $(ls -d /vol* 2>/dev/null); do
  for dir in @appconf @appdata @apphome @appmeta @apptemp @appcenter; do
    rm -rf "$vol/$dir/fan-control"
  done
done
rm -rf /var/apps/fan-control

清理完成后重新上传安装即可。

自行打包

git clone https://github.com/AriesOxO/fnos-fan-control.git
cd fnos-fan-control

# 上传到 fnOS 服务器打包
scp -r src/ user@nas:/tmp/fpk-src/
ssh user@nas 'cd /tmp/fpk-src && fnpack build'

使用教程

运行模式详解

自定义温控曲线

温控曲线是 fnos-fan-control 的核心功能，让你精确定义「什么温度对应多少转速」。

自动生成曲线：

1. 在 Web 管理界面选择「自动模式」
2. 点击「编辑曲线」展开编辑器
3. 选择节点数（2-10 个）和温度范围
4. 点击「自动生成」— 系统自动生成低温平缓、高温陡峭的智能曲线
5. 点击「保存」，编辑器自动收拢

手动微调曲线：

1. 展开曲线编辑器
2. 直接修改每个节点的温度值和对应的转速百分比
3. SVG 图表实时预览调整效果
4. 满意后点击「保存」

曲线设计建议：

多风扇区域控制

如果你的 NAS 有多个风扇，可以为每个风扇区域独立配置：

• 独立绑定 PWM 通道 — 每个区域指定控制哪个物理风扇
• 独立选择温度来源 — CPU 温度、主板温度等
• 独立温控曲线 — 不同位置的风扇可以用不同策略

密码认证

安装时可设置访问密码，支持两种认证方式：

• Cookie 模式 — 浏览器登录后自动保持会话
• Header 模式 — API 调用时在请求头传入密码，便于自动化集成

安全机制

系统设计以绝不让风扇停转为底线，实现了六重安全保障：

兼容性

支持的主板芯片

通用 hwmon 探测，任何有 pwm 文件的芯片均可控制：

CPU 温度传感器

REST API

提供完整的 HTTP API，便于自动化集成和二次开发：

更新日志

v1.1.1（最新）

• 修复 manifest URL 尖括号导致应用中心安装失败
• 修复 v2 配置格式下启动崩溃
• 移除设置界面多余配置项

v1.0.1

• 多设备适配：通用 hwmon 探测，支持 ITE/Nuvoton/Fintek 全系列
• 多风扇区域独立控制
• 温控曲线编辑器优化：折叠/展开、节点摘要标签
• 默认模式改为保守曲线
• GitHub Actions 自动构建 FPK

v1.0.0

• 首个正式版本

技术指标