NoteBook FanControl Linux版技术手册

NoteBook FanControl Linux版技术手册

nbfc-linux NoteBook FanControl ported to Linux 项目地址: https://gitcode.com/gh_mirrors/nb/nbfc-linux

概览

NoteBook FanControl（简称NBFC）是一款专为Linux系统设计的笔记本风扇控制工具，由C语言重写自Stefan Hirschmann的原C#版本。本手册旨在指导您完成安装、配置以及高级使用的全过程，确保您的设备能够根据温度智能调节风扇速度，提升用户体验。

安装指南

Arch Linux

通过AUR安装：yay -S nbfc-linux 或手动编译：使用PKGBUILD文件位于pkgbuilds/nbfc-linux-git/PKGBUILD

Debian/Ubuntu

下载最新版本 .deb 文件：0.2.7版本示例，查看全部版本：GitHub 页面。

Fedora

下载最新 .rpm 文件：0.2.7版本示例，更多版本见：GitHub 页面。

NixOS

可以采用声明式或命令式安装方法，详细步骤参阅项目文档中的[nixos-installation-new.md]和[nixos-installation.md]。

其他Linux发行版

通用手动编译安装流程：

1. 执行 ./autogen.sh
2. 配置安装路径 ./configure --prefix=/usr --sysconfdir=/etc
   • 对于OpenRC系统使用 --with-init-system=openrc
   • 对于System-V-Init系统使用 --with-init-system=systemv
3. 编译 make
4. 管理员权限下安装 sudo make install

特殊系统配置

对于需要特定版本的Fedora，需自行编辑pkgbuilds/rpm/nbfc-linux.spec并编译。

项目的使用说明

启动GUI配置

安装后，以管理员身份运行 sudo nbfc-qt 来配置NBFC-Linux。

命令行配置

首次运行前，需指定或选择配置文件。

• 自动匹配配置：sudo nbfc config --set auto
• 推荐配置：sudo nbfc config --recommend
• 手动设置配置：sudo nbfc config --set <MODEL> 之后，启动服务：sudo nbfc start

查询和服务管理

检查状态：nbfc status -a 开机自启设置：sudo systemctl enable nbfc_service

项目API使用文档

虽然NBFC主要是通过命令行界面(CLI)和图形用户界面(GUI)来交互，但其核心逻辑支持了如下的概念：

• 温度算法：平均(Average)、最低(Min)、最高(Max)。
• 温度源配置：允许用户通过JSON配置文件定义不同风扇对应不同的温度计算策略及来源。

例如配置示例显示了如何指定风扇和对应的温度监控策略：

{
    ...
    "FanTemperatureSources": [
        { ... }, { ... }, { ... } // 每个对象定义一个风扇的温度监测策略
    ]
}

这些配置直接影响NBFC的服务行为。

附录：系统差异

NBFC-Linux在文件路径、服务文件命名等方面与原始的NBFC在Windows上有区别。例如，配置文件从XML转换为了JSON格式，系统服务文件命名更新等。

注意事项与故障排除

使用时确保依赖模块（如ec_sys或acpi_ec）已正确配置或加载，否则可能需手动编译。NBFC-Linux不直接支持旧有的Autostart选项，依赖于systemd服务进行自动启动控制。

本文档提供了安装至高级配置的全面指导，确保您能有效利用NBFC/Linux来优化您的笔记本散热管理。

nbfc-linux NoteBook FanControl ported to Linux 项目地址: https://gitcode.com/gh_mirrors/nb/nbfc-linux