Files
fn_nas/README.md
2025-06-30 18:05:54 +08:00

97 lines
2.5 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 飞牛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. **反馈即授权**
用户反馈将被视为授权开发者用于插件改进(不含敏感个人信息)。
**继续使用本插件即表示您已阅读、理解并接受上述免责条款。**