fn_nas/README.md

飞牛NAS集成

此集成支持在Home Assistant中监控和控制飞牛NAS设备

📊 功能列表

• ​硬件监控​
  • 硬盘温度
  • 硬盘健康状态
  • 硬盘通电时间
• ​系统监控​
  • 系统运行状态
  • CPU温度监控
• ​设备控制​
  • 设备重启按钮
  • 设备关机按钮
  • 电源开关（支持网络唤醒开机）
  • 飞牛虚拟机开关机控制
  • 飞牛docker开关控制
• ​UPS信息​
  • UPS电量显示
  • UPS负载
  • UPS状态

---

🔧 飞牛NAS端配置

现已支持非root用户访问，无需配置ssh，需要开启飞牛SSH服务

💻 Home Assistant安装

1. 进入HACS商店​
2. 添加自定义存储库：

https://github.com/anxms/fn_nas

3. 搜索"飞牛NAS"，点击下载
4. ​重启Home Assistant服务

⚙️ 集成配置

1. 添加新集成 → 搜索"飞牛NAS"
2. 配置参数：
   • NAS IP地址（必填）
   • SSH端口（默认：22）
   • SSH用户名和密码
   • MAC地址（用于网络唤醒）
   • 扫描间隔（推荐≥300秒）

⚠️ 注意事项

• 确保NAS与Home Assistant在同一局域网
• 首次配置后请等待5分钟完成初始数据采集
• 频繁扫描可能导致NAS负载升高
• 网络唤醒功能需在BIOS中启用Wake-on-LAN

🔄 问题排查

测试SSH连接

ssh root@<NAS_IP> -p <端口>

若连接失败，请检查：

• 防火墙设置
• SSH服务状态
• 路由器端口转发配置

---

📌 建议使用固定IP分配给NAS设备以确保连接稳定

免责声明

1. 非官方性质
   本插件为非官方第三方开发，与飞牛NAS官方无任何关联。

2. 使用风险自担
   使用本插件可能导致不可预见的系统问题或数据风险，用户需自行承担所有使用风险。

3. 无质量保证
   插件开发者在法律允许的最大范围内：

   • 不保证功能的完整性或准确性
   • 不承担因使用插件导致的任何直接/间接损失
   • 不提供任何明示或暗示的保证

4. 数据安全责任
   用户需自行确保插件操作不会危及：

   • 系统稳定性
   • 数据完整性
   • 网络安全性

5. 反馈即授权
   用户反馈将被视为授权开发者用于插件改进（不含敏感个人信息）。

继续使用本插件即表示您已阅读、理解并接受上述免责条款。