> 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/vi/quan-tri-he-thong/usb-passthrough.md).

# Passthrough USB

Các thiết bị USB được kết nối với máy chủ có thể được chuyển cho VM (và cho tenant chuyển tiếp vào các VM của họ), cho phép thiết bị xuất hiện và hoạt động như thể nó được gắn trực tiếp bên trong VM.

Ví dụ về các thiết bị USB passthrough bao gồm:

* ổ đĩa chứa khóa cấp phép phần mềm
* camera an ninh/thiết bị giám sát
* bàn phím/chuột (hỗ trợ sử dụng giữa nhiều VM; thường thuận tiện hơn so với cấu hình VM khởi động kép/đa khởi động cho phần cứng chuyên dụng)

## Cài đặt/Cấu hình máy chủ

Các hướng dẫn sau sẽ cấu hình passthrough thiết bị bằng cách tự động tạo một quy tắc mới cho mỗi thiết bị được chọn và gắn thiết bị đó vào nhóm tài nguyên. Để biết thêm thông tin về cách nhóm tài nguyên và quy tắc tài nguyên hoạt động, xem: [**Truyền qua thiết bị - Quy tắc tài nguyên**](/run-the-platform/vi/quan-tri-he-thong/device-pass-overview.md#resource-rules).

1. Đi tới **Bảng điều khiển Trình quản lý tài nguyên** (*Hạ tầng > Tài nguyên*) **-HOẶC-** Điều hướng đến một **nút cụ thể** nơi các thiết bị USB được cắm vào. (*Hạ tầng > Nút* > bấm đúp vào nút mong muốn trong danh sách.)
2. Nhấp vào **Thiết bị USB**. Danh sách các thiết bị USB được phát hiện sẽ hiển thị.

{% hint style="success" %}
**Một thiết bị USB hiển thị giá trị trong *****Nhóm tài nguyên***** và *****Quy tắc tài nguyên***** các cột đã được cấu hình cho passthrough.**
{% endhint %}

3. **Chọn** thích hợp **thiết bị USB** từ danh sách.

{% hint style="info" %}
**Tất cả các thiết bị đã chọn sẽ được thêm vào cùng một nhóm tài nguyên (resource pool), nhưng mỗi thiết bị sẽ có một quy tắc tài nguyên riêng được tạo.**
{% endhint %}

4. Nhấp vào **Tạo tài nguyên** ở menu bên trái.
5. **Tạo một nhóm tài nguyên USB mới** **-HOẶC-** **Chọn một nhóm tài nguyên USB** từ danh sách.

### Các trường của Nhóm tài nguyên USB

* **Tên**: nhãn dùng để xác định nhóm tài nguyên (tức là nhóm thiết bị); hãy dùng một tên mô tả để người dùng có thể dễ dàng nhận biết loại thiết bị trong nhóm này.
* **Loại**: ***USB***.
* **Mô tả**: (tùy chọn) trường để cung cấp thêm văn bản quản trị về nhóm tài nguyên.
* **Lớp**: cho phép chọn một phân loại thiết bị tổng quát cho nhóm; ví dụ: Thiết bị USB chung, Thiết bị nhập liệu, Phương tiện, v.v. Trường này chỉ được dùng để áp dụng biểu tượng tương ứng và không ảnh hưởng đến chức năng.

#### Cài đặt USB

* **Cho phép khách đặt lại**: Khi được chọn, người dùng VM có thể đặt lại thiết bị USB.
* **Cho phép khách đặt lại tất cả**: Khi được chọn, người dùng VM có thể đặt lại bộ chia USB mà thiết bị được cắm vào.

{% hint style="info" %}
**Hành động đặt lại của thiết bị USB phụ thuộc vào trình điều khiển của thiết bị; một số thiết bị hỗ trợ đặt lại và một số thì không.**
{% endhint %}

Sau khi nhóm tài nguyên được chọn hoặc nhóm mới được tạo, một \**Thành công* thông báo sẽ xuất hiện cho biết các quy tắc tài nguyên đã được tạo cho thiết bị (các thiết bị).

6. **Có thể cần khởi động lại nút (các nút) liên quan**; một thông báo sẽ xuất hiện ở đầu bảng điều khiển Trình quản lý tài nguyên.

{% hint style="warning" %}
**Hãy tuân thủ đúng** [**Chế độ Bảo trì**](/run-the-platform/vi/van-hanh/maintenance-mode.md) **quy trình khi khởi động lại một nút để tránh gián đoạn khối lượng công việc.**
{% endhint %}

Bảng điều khiển nhóm tài nguyên chứa các quy tắc tài nguyên đã được tự động tạo cho các thiết bị bạn chọn. Bạn có thể nhấp vào từng quy tắc để xem chi tiết cấu hình. Một quy tắc do hệ thống tạo ra có thể được sửa đổi khi cần; ví dụ, *Node* bộ lọc có thể được thay đổi thành *-- Không có --* để bao gồm các thiết bị khớp từ tất cả các nút. Thông tin về các quy tắc tài nguyên có tại: [**Tổng quan truyền qua thiết bị - Quy tắc tài nguyên**](/run-the-platform/vi/quan-tri-he-thong/device-pass-overview.md#resource-rules)

## Cấu hình VM/khách

1. Đi tới **bảng điều khiển VM** (từ menu trên cùng: Máy ảo > Danh sách > bấm đúp vào VM mong muốn trong danh sách)
2. Nhấp vào **Thiết bị** ở menu bên trái.
3. Nhấp vào **Mới** ở menu bên trái.

{% hint style="success" %}
**Bạn cũng có thể gắn thiết bị vào VM qua Trình quản lý tài nguyên: từ bảng điều khiển Nhóm tài nguyên > bấm đúp vào Nhóm SR-IOV mong muốn > Xem thiết bị máy > Mới; chọn VM từ danh sách thả xuống Máy.**
{% endhint %}

### Các trường của biểu mẫu nhập thiết bị

* **Tên**: cung cấp một tên để xác định thiết bị, ví dụ "exapp license key" hoặc để trống để cho phép hệ thống tự động tạo tên thiết bị.
* **Loại**: ***USB***
* **Mô tả**(tùy chọn): có thể nhập thêm văn bản tại đây cho mục đích quản trị.
* **Nhóm tài nguyên**: chọn nhóm tài nguyên USB phù hợp từ danh sách thả xuống
* **Cài đặt USB**: xem ở trên.

4. Nhấp vào **Gửi** để hoàn tất việc thêm thiết bị mới.
5. Cài đặt mọi trình điều khiển máy khách cần thiết; nếu cần, hãy tham khảo tài liệu phần cứng của thiết bị.
6. VM sẽ cần **khởi động lại** để gắn thiết bị. Từ bảng điều khiển VM, nhấp vào *Khởi động lại* liên kết trên thông báo xuất hiện ở đầu bảng điều khiển, hoặc nhấp vào **Khởi động lại** ở menu bên trái.

## Chuyển tiếp một thiết bị USB cho tenant

Thiết bị USB có thể được chuyển cho tenant để tenant chuyển tiếp vào các VM của chính họ. Khi bạn chuyển tiếp thiết bị USB cho tenant, một nhóm tài nguyên mới sẽ được tạo bên trong tenant.

{% hint style="info" %}
**Khi các thiết bị được chia sẻ cho tenant, chúng được cấp phát dày (tức là tenant sau đó sở hữu các thiết bị, vì vậy chúng không thể được gán cho các VM hoặc tenant khác ngay cả khi không sử dụng.)**
{% endhint %}

1. Điều hướng đến **bảng điều khiển tenant** (từ menu trên cùng: Tenants > List > nhấp đúp vào tenant trong danh sách.)
2. Nhấp vào **Các nút** ở menu bên trái.
3. **Nhấp đúp vào một trong các nút tenant**.
4. Nhấp vào **Thiết bị** ở menu bên trái.
5. Nhấp vào **Mới** ở menu bên trái.
6. Nhập một **Tên** hoặc để trống để cho hệ thống tự động tạo tên; tên này sẽ được dùng cho nhóm tài nguyên được tạo trong tenant.
7. **Loại**: ***USB***.
8. **Mô tả**: cung cấp nơi để lưu trữ thêm thông tin quản trị về thiết bị/nhóm thiết bị.
9. **Cài đặt USB**: xem ở trên.
10. Khi các trường đã hoàn tất, nhấp vào **Gửi** để hoàn tất việc chuyển cho tenant.
11. Thiết bị (các thiết bị) giờ đây sẽ khả dụng như một nhóm tài nguyên để gắn vào các VM của tenant. Hãy làm theo [**Cấu hình VM/khách**](#vmguest-configuration) hướng dẫn ở trên. Để sử dụng thiết bị chuyển qua, VM phải chạy trên nút của tenant nơi thiết bị được gắn.


---

# 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/vi/quan-tri-he-thong/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.