> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/usb-passthrough.md).

# USB 直通

连接到主机的 USB 设备可以传递给虚拟机（以及租户传递给其虚拟机），使设备看起来并表现得仿佛直接连接在虚拟机内部一样。

示例 USB 直通设备包括：

* 包含软件许可证密钥的驱动器
* 安防摄像头/监控设备
* 键盘/鼠标（支持在多个虚拟机之间使用；对于专用硬件，这通常比双启动/多启动虚拟机配置更方便）

## 主机安装/配置

以下说明将通过为每个所选设备自动创建一条新规则并将设备附加到资源组来配置设备直通。有关资源组和资源规则如何工作的更多信息，请参见： [**设备直通 - 资源规则**](/run-the-platform/zh/xi-tong-guan-li/device-pass-overview.md#resource-rules).

1. 导航到 **资源管理器仪表板** (*基础设施 > 资源*) **—或—** 导航到 **特定节点** USB 设备所插入的位置。（*基础设施 > 节点* > 在列表中双击所需节点。）
2. 单击 **USB 设备**。将显示检测到的 USB 设备列表。

{% hint style="success" %}
**在以下列中显示值的 USB 设备 *****资源组***** 和 *****资源规则***** 列中已配置为直通。**
{% endhint %}

3. **选择** 合适的 **USB 设备** ，从列表中。

{% hint style="info" %}
**所有所选设备都会添加到同一个资源组（资源池）中，但每个设备都会单独创建一条资源规则。**
{% endhint %}

4. 单击 **创建资源** 左侧菜单中的。
5. **创建新的 USB 资源组** **—或—** **选择 USB 资源组** ，从列表中。

### USB 资源组字段

* **名称**：用于标识资源组（即设备池）的标签；请使用具有描述性的名称，以便用户能够轻松识别该组中的设备类型。
* **类型**: ***USB***.
* **描述**：（可选）用于提供有关资源组的更多管理说明的字段。
* **类别**：允许为该组选择通用设备分类；例如，通用 USB 设备、人机输入设备、媒体等。此字段仅用于应用相关图标，不影响功能。

#### USB 设置

* **允许访客重置**：勾选后，虚拟机用户可以重置 USB 设备。
* **允许访客重置全部**：勾选后，虚拟机用户可以重置设备所插入的 USB 集线器。

{% hint style="info" %}
**USB 设备的重置操作取决于设备驱动程序；某些设备支持重置，某些则不支持。**
{% endhint %}

在选择资源组或创建新资源组后，\**成功* 消息应会出现，表明已为设备创建资源规则。

6. **关联节点可能需要重启**；资源管理器仪表板顶部将出现一条消息。

{% hint style="warning" %}
**请遵循正确的** [**维护模式**](/run-the-platform/zh/yun-wei/maintenance-mode.md) **在重启节点时的操作流程，以避免影响工作负载。**
{% endhint %}

资源组仪表板包含为所选设备自动生成的资源规则。您可以点击单个规则查看配置详情。系统创建的规则可根据需要修改；例如， *节点* 筛选条件可以更改为 *-- 无 --* 以包含来自所有节点的匹配设备。有关资源规则的信息可在此处获得： [**设备直通概述 - 资源规则**](/run-the-platform/zh/xi-tong-guan-li/device-pass-overview.md#resource-rules)

## 虚拟机/客户配置

1. 导航到 **虚拟机仪表板** （从顶部菜单：虚拟机 > 列表 > 在列表中双击所需 VM）
2. 单击 **设备** 左侧菜单中的。
3. 单击 **新建** 左侧菜单中的。

{% hint style="success" %}
**您也可以通过资源管理器将设备附加到 VM：从资源组仪表板 > 双击所需的 SR-IOV 组 > 查看机器设备 > 新建；从机器下拉列表中选择 VM。**
{% endhint %}

### 设备条目表单字段

* **名称**：提供一个用于标识该设备的名称，例如“exapp license key”，或者留空以允许系统自动生成设备名称。
* **类型**: ***USB***
* **描述**（可选）：可在此处输入额外文本用于管理目的。
* **资源组**：从下拉列表中选择适当的 USB 资源组
* **USB 设置**：见上文。

4. 单击 **提交** 以完成添加新设备。
5. 安装任何所需的客户端驱动程序；如有需要，请查阅设备硬件文档。
6. 该虚拟机将需要 **重启** 才能附加该设备。在虚拟机仪表板中，单击顶部出现消息中的 *重启* 链接，或单击 **重启** 左侧菜单中的。

## 将 USB 设备直通给租户

USB 设备可以传递给租户，由租户再传递给其自己的虚拟机。将 USB 设备直通给租户时，会在租户内创建一个新的资源组。

{% hint style="info" %}
**当设备共享给租户时，它们会进行厚置备（即租户随后拥有这些设备，因此即使未使用，也不能分配给其他虚拟机或租户。)**
{% endhint %}

1. 导航到所需的 **租户仪表板** （从顶部菜单：租户 > 列表 > 在列表中双击该租户。）
2. 单击 **节点** 左侧菜单中的。
3. **双击其中一个租户节点**.
4. 单击 **设备** 左侧菜单中的。
5. 单击 **新建** 左侧菜单中的。
6. 输入一个 **名称** ，或者留空让系统自动创建名称；此名称将用于在租户中创建的资源组。
7. **类型**: ***USB***.
8. **描述**：提供一个存储有关该设备/设备池的其他管理信息的地方。
9. **USB 设置**：见上文。
10. 填写完字段后，单击 **提交** 以完成传递给租户。
11. 这些设备现在将作为可附加到租户虚拟机的资源组可用。请遵循 [**虚拟机/客户配置**](#vmguest-configuration) 上面的说明。为了使用直通设备，虚拟机必须运行在连接该设备的租户节点上。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/usb-passthrough.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.