# 飞牛NAS集成

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

## 📊 功能列表

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

* * *

## 🔧 飞牛NAS端配置

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

## 💻 Home Assistant安装

1.  进入**HACS商店**​
2.  添加自定义存储库：
```shell
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连接
```shell
ssh root@<NAS_IP> -p <端口>
```
若连接失败，请检查：

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

* * *

> 📌 建议使用固定IP分配给NAS设备以确保连接稳定
# 免责声明

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

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

3. **无质量保证**  
   插件开发者在法律允许的最大范围内：
   - 不保证功能的完整性或准确性
   - 不承担因使用插件导致的任何直接/间接损失
   - 不提供任何明示或暗示的保证

4. **数据安全责任**  
   用户需自行确保插件操作不会危及：
   - 系统稳定性
   - 数据完整性
   - 网络安全性

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

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