> 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).

# USB Passthrough

Cách cấu hình passthrough thiết bị USB trong VergeOS, bao gồm thiết lập host, tạo nhóm tài nguyên, cấu hình máy khách VM và chuyển thiết bị USB cho tenant.

Các thiết bị USB được kết nối với một host có thể được chuyển tiếp sang các VM (và để tenant chuyển tiếp vào VM của họ), cho phép một 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ị passthrough USB bao gồm:

* các ổ đĩ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 các 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 các nhóm tài nguyên và quy tắc tài nguyên hoạt động, xem: [**Chuyển tiếp 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 tới một **nút cụ thể** nơi các thiết bị USB được cắm vào. (*Hạ tầng > Nút* > nhấp đúp vào nút mong muốn trong danh sách.)
2. Nhấp **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 cột *****Nhóm tài nguyên***** và *****Quy tắc tài nguyên***** đã được cấu hình passthrough.**
{% endhint %}

3. **Chọn** phù 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 **Tạo tài nguyên** trê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 để nhận diện nhóm tài nguyên (tức là nhóm thiết bị); hãy dùng một tên mang tính 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ị chung cho nhóm; ví dụ, Thiết bị USB chung, Thiết bị nhập của con người, 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 hub USB mà thiết bị được cắm vào.

{% hint style="info" %}
**Hành động đặt lại của một thiết bị USB phụ thuộc vào trình điều khiển 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 một 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ị.

6. **Có thể cần khởi động lại 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) **các 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ạo tự động cho các thiết bị đã chọn của bạ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 có thể được sửa đổi khi cần; ví dụ, bộ lọc *Nút* có thể được đổ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 về Chuyển tiếp 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 > nhấp đúp vào VM mong muốn trong danh sách)
2. Nhấp **Thiết bị** trên menu bên trái.
3. Nhấp **Mới** trên menu bên trái.

{% hint style="success" %}
**Bạn cũng có thể gắn thiết bị vào VM thông qua Trình quản lý tài nguyên: từ bảng điều khiển Nhóm tài nguyên > nhấp đú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 Machine.**
{% 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 để nhận diện thiết bị, ví dụ: "khóa cấp phép exapp" hoặc để trống để 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 **Gửi** để hoàn tất việc thêm thiết bị mới.
5. Cài đặt bất kỳ trình điều khiển máy khách nào 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 một **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 **Khởi động lại** trên menu bên trái.

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

Các thiết bị USB có thể được chuyển cho tenant để tenant chuyển tiếp vào các VM của riêng họ. Khi bạn chuyển tiếp các 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 một tenant, chúng được cấp phát dày (tức là tenant sau đó sở hữu các thiết bị, nên 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 tới **bảng điều khiển tenant** (từ menu trên cùng: Tenant > Danh sách > nhấp đúp vào tenant trong danh sách.)
2. Nhấp **Các nút** trên menu bên trái.
3. **Nhấp đúp vào một trong các nút của tenant**.
4. Nhấp **Thiết bị** trên menu bên trái.
5. Nhấp **Mới** trên menu bên trái.
6. Nhập một **Tên** hoặc để trống để 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 đã được điền xong, nhấp **Gửi** để hoàn tất việc chuyển cho tenant.
11. Các thiết bị giờ sẽ sẵn sàng dưới dạng 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) các hướng dẫn ở trên. Để sử dụng thiết bị passthrough, VM phải chạy trên nút của tenant nơi thiết bị được gắn.

## Khắc phục sự cố

### VM không khởi động được sau khi nút khởi động lại

**Triệu chứng:** Một VM có thiết bị USB passthrough không khởi động được sau khi nút host của nó khởi động lại (ví dụ: sau khi cập nhật VergeOS). VM liên tục cố gắng khởi động nhưng không thể mở thiết bị USB.

**Nguyên nhân:** Quy tắc tài nguyên được tạo tự động xác định thiết bị bằng địa chỉ bus vật lý của nó (bộ lọc đường dẫn). Địa chỉ đó được gán mỗi khi thiết bị USB được liệt kê. Những thay đổi trong topology phần cứng của máy chủ—chẳng hạn như thêm hoặc tháo các thiết bị PCI—có thể làm thay đổi cách bộ điều khiển USB hiển thị các cổng của nó, dẫn đến một đường dẫn khác. Trên một số ít hệ thống, firmware của bo mạch chủ có thể liệt kê lại các cổng USB khác đi sau khi bộ điều khiển được đặt lại, làm cho đường dẫn thay đổi ngay cả khi không có sửa đổi phần cứng nào. Khi thiết bị xuất hiện ở một địa chỉ mới, quy tắc không còn khớp với một thiết bị đang hoạt động, khiến VM không thể khởi động.

**Cách khắc phục:** Chỉnh sửa quy tắc tài nguyên để khớp thiết bị bằng các ID phần cứng ổn định của nó thay vì địa chỉ vật lý:

1. Đi tới **Hạ tầng > Tài nguyên**.
2. Trong ***Quy tắc*** mục, tìm quy tắc được tạo tự động cho thiết bị USB.
3. **Nhấp đúp vào quy tắc** để mở nó để chỉnh sửa.
4. Bật **ID nhà cung cấp** (`vendor_id`) và **ID mẫu** (`model_id`) các trường lọc. ID mẫu là ID sản phẩm USB.
5. Bật **Số sê-ri** trường (chỉ các thiết bị được hỗ trợ) để ghim quy tắc vào một thiết bị cụ thể. Hầu hết các ổ USB flash, ổ HDD/SSD ngoài, webcam và máy in/máy quét của các thương hiệu uy tín đều có một số sê-ri duy nhất được lập trình sẵn từ nhà máy.
6. Tắt các trường lọc vị trí vật lý (đường dẫn và thiết bị) nếu máy chủ của bạn không gán một đường dẫn PCI nhất quán giữa các lần khởi động. Bạn cũng có thể tắt các trường này nếu muốn quy tắc khớp với thiết bị bất kể nó được cắm vào cổng USB nào.
7. Nhấp **Gửi** để lưu quy tắc.
8. Khởi động VM.

ID nhà cung cấp, ID mẫu và số sê-ri ổn định qua các lần khởi động lại, nên quy tắc sẽ khớp với thiết bị bất kể cách nó được liệt kê lại.


---

# 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.