添加 fnhelp 帮助文档、飞牛NAS产品SKU及配件清单更新

fnhelp/virtual-machine/passthrough.md

@@ -0,0 +1,51 @@
+# 如何使用虚拟机硬件直通？
+
+硬件直通是一种虚拟化技术，它允许虚拟机直接访问宿主机上的物理硬件设备，而不是通过虚拟化层进行仿真。
+
+## 应用场景
+
+1. **显卡直通**：支持物理显示器输出，提升图形处理性能；
+2. **声卡直通**：实现音响或耳机的高质量音频输出；
+3. **USB设备直通**：便于读取USB存储设备或连接其他USB设备；
+4. **网卡直通**：满足网络加速和复杂的家庭组网需求。
+
+> **【硬件直通的风险和限制】**
+>
+> 硬件直通可能带来一定风险和限制，错误配置可能导致**设备冲突**或**系统崩溃**。在操作前，请充分了解以下风险：
+>
+> 1. **存储直通风险**：错误直通SATA、NVMe或USB存储设备可能损坏宿主机上的数据，且不可逆，请务必提前备份；
+> 2. **网卡直通风险**：请确保宿主机保留可用网卡，否则可能导致宿主机网络中断；
+> 3. **显卡直通风险**：直通显卡成功率并不高，且有可能造成宿主机崩溃，需谨慎操作。
+>
+> 不建议非专业用户尝试硬件直通操作。
+
+## 1. 开启硬件直通选项
+
+打开虚拟机应用，在侧边栏点击 **硬件**，找到 **硬件直通选项** 的 **开启** 按钮，在仔细阅读 **《硬件直通技术免责声明》** 后， 点击 **确认开启**。
+
+## 2. 虚拟机配置硬件直通
+
+在创建虚拟机或编辑虚拟机界面， **添加设备** 按钮在 **硬件直通选项** 开启后便激活可点击。
+
+### 2.1 添加 USB 设备
+
+1. 点击 **添加硬件** 按钮，点击 **添加 USB 设备**
+2. 选择需要直通给当前虚拟机的 USB 设备
+3. 点击 **确定** 按钮保存
+
+### 2.2 添加 PCI 设备
+
+1. 点击 **添加硬件** 按钮，点击 **添加 PCI 设备**
+2. 在列表中选择需要直通的 PCI 设备
+3. 由于 PCI 设备根据 IOMMU 分组进行内存隔离，所以直通时需要将同一 IOMMU 分组的 PCI 设备一并直通
+4. 点击 **确定** 按钮保存
+
+## 3. 虚拟机详细日志指引
+
+由于多方面因素影响，虚拟机可能启动失败，可在日志中查询相关详细原因。
+
+日志路径：`/var/apps/trim.vm/var/log/error.log`
+
+---
+
+*来源：飞牛 fnOS 帮助中心*