Mac NAS Guardian

Mac NAS Guardian 是给 2014 款 Intel MacBook Pro 运行飞牛 OS 作为 NAS 场景设计的宿主机硬件控制应用。

作者：xiaoker

博客：www.xiaoker.com

许可证：非商业用途可使用，商业用途需单独授权。详见 LICENSE。

特性

• 根据 CPU 温度自动调节风扇，避免长时间高温降频或过热
• 提供背光控制能力，优先支持键盘背光
• 判断“Apple logo 常亮”是否具备软件可控条件，并在不可控时给出替代方案
• 通过飞牛 OS 中的 Web 界面完成配置、状态查看和告警

功能模块

1. 风扇自动控制

• 读取 CPU 温度
• 读取当前风扇转速
• 根据温度曲线自动设置目标转速
• 支持静音、均衡、强冷三种预设
• 支持用户自定义温度阈值
• 支持“故障回退”
  • 读不到温度时切回系统默认
  • 温度超过危险值时直接打满风扇

2. 背光控制

• 键盘背光开关
• 键盘背光亮度调节
• 定时熄灭
• NAS 模式开机自动关闭

3. 设备能力探测

启动时自动检测：

• 是否存在 applesmc
• 是否存在 coretemp
• 是否存在 smc::kbd_backlight
• 是否存在可写风扇目标接口
• 当前机型是否可能具备独立 logo 背光

如果检测结果表明 logo 不可独立控制，界面中不显示该开关，只显示说明。

安装方法

前提：

• 飞牛 OS 宿主机里有 python3
• 宿主机是 root 或有 sudo
• 内核已经暴露温度与风扇 sysfs 接口

建议先跑硬件探测：

bash /path/to/mac-nas-guardian/scripts/probe-hardware.sh

如果确认有这些接口，再安装：

sudo bash /path/to/mac-nas-guardian/scripts/install-host.sh

安装完成后访问：

http://NAS-IP:6688/

目录说明

• docs/product-spec.md：产品设计与交互方案
• docs/architecture.md：技术架构与接口设计
• deploy/docker-compose.yml：飞牛 OS 容器部署草案
• config/guardian.example.yaml：策略配置样例
• config/guardian.example.json：当前程序实际使用的配置样例
• systemd/mac-nas-guardian.service：宿主机服务
• scripts/install-host.sh：安装脚本