> 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/generic-pci-passthrough.md).

# 一对一 PCI 直通

一对一 PCI 直通是指一次将单个虚拟机访问权限授予一个物理连接到主机节点的 PCI 设备。虚拟机客户操作系统会像该设备直接连接一样使用它。

## 主机安装/配置

{% hint style="danger" %}
**在进行以下操作之前，务必阅读并熟悉** [**PCI 直通风险和注意事项**](/run-the-platform/zh/xi-tong-guan-li/device-pass-overview.md#pci-passthrough-risksprecautions) **进行直通配置。**
{% endhint %}

1. 导航到 **资源管理器仪表板** (**基础架构** > **资源** 从顶部菜单 **—或—** 主仪表板 > 资源） **—或—** 导航到 **特定节点仪表板** (**基础架构** > **节点** ，可通过顶部菜单 \*-或-**主仪表板 > 节点**，然后在列表中双击所需节点。）
2. 单击 **PCI 设备**.
3. 在列表中选择所需设备，然后单击 **创建资源** 左侧菜单中的。
4. **选择现有的 PCI 设备资源组** 从列表中 **—或—** **创建新的 PCI 资源组**.

### 创建 PCI 设备资源组

1. **名称**：用于标识资源组（即设备池）的标签；请使用具有描述性的名称，以便用户能够轻松识别此组中的设备类型，例如 *PCI GPU*
2. **类型**: ***PCI***
3. **描述**：可选字段，用于提供有关资源组的更多管理文本。
4. **类别**：从下拉列表中选择最合适的分类。此字段仅用于为资源组应用关联图标，不影响功能。
5. 单击 **提交** 以完成新资源组的创建。
6. **关联节点可能需要重启**；资源管理器仪表板顶部将出现一条消息。

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

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

## 虚拟机/客户配置

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

{% hint style="success" %}
**你也可以通过资源管理器将设备附加到虚拟机；这种方法允许一次向虚拟机添加多个设备。在资源组仪表板中 > 双击所需的 PCI 组 > 查看机器设备 > 新建；从机器下拉列表中选择虚拟机。**
{% endhint %}

4. 设备条目表单字段：

* **名称**：提供一个名称，以便充分标识设备类型；或者留空，让系统自动生成设备名称。
* **类型**: ***PCI***
* **描述**（可选）：可在此处输入额外文本用于管理目的。
* **资源组**：从下拉列表中选择合适的 PCI 资源组
* **数量**：指定要附加到虚拟机的 PCI 设备数量（来自此资源组）。

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

## 将 PCI 设备直通给租户

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

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

1. 导航到所需的 **租户仪表板** （从顶部菜单：租户 > 列表 > 在列表中双击该租户。）
2. 单击 **节点** 左侧菜单中的。
3. **双击其中一个租户节点**.
4. 单击 **设备** 左侧菜单中的。
5. 单击 **新建** 左侧菜单中的。
6. 输入一个 **名称** ，或者留空让系统自动创建名称；此名称将用于在租户中创建的资源组。
7. **类型**: ***PCI***
8. **描述**：提供一个位置，用于存储有关该设备池的额外管理信息。
9. **数量**：要传入租户资源组的设备数量。
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/generic-pci-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.