> 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/may-ao/vm-guest-agent.md).

# Tác nhân khách VM

Tác nhân khách là một chương trình được cài đặt bên trong hệ điều hành khách, cho phép máy chủ chạy lệnh bên trong VM. Điều này cho phép sao lưu nhất quán, đáng tin cậy bằng cách đóng băng hệ thống tệp của khách trước khi chụp snapshot và tắt đúng cách một máy khách mà không phụ thuộc vào ACPI, chính sách, v.v.

## Yêu cầu

* Bật tác nhân khách cho VM
* Cài đặt tác nhân khách (bên trong hệ điều hành khách)

## Bật Guest Agent

Tác nhân khách phải được bật cho từng VM; việc này có thể thực hiện trong lúc tạo VM hoặc bằng cách chỉnh sửa một VM hiện có. Hộp kiểm Guest Agent trên bảng điều khiển VM cho biết tác nhân đã được bật hay chưa.

![agent-enabled-notconnected.png](/files/7dc22da8f5835624b976247d45e3df631acb8b95)

### Bật Guest Agent trên một VM hiện có

1. Đi tới Bảng điều khiển VM
2. Nhấp vào **Chỉnh sửa** ở menu bên trái.
3. Nhấp để chọn **Tác tử khách QEMU** ô chọn.
4. Nhấp vào **Gửi** để lưu thay đổi.

## Cài đặt phần mềm tác nhân trên các VM Windows

### Để tải xuống/cài đặt Trình cài đặt Guest Tools

Trình cài đặt tác nhân khách có thể được tải xuống từ liên kết sau (và chạy bên trong máy khách): <https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win-guest-tools.exe>

{% hint style="success" %}
Trong quá trình thiết lập trình cài đặt VirtIO, hãy nhớ chọn nút *Cài đặt* cho phần mềm thiết bị.
{% endhint %}

VM sẽ cần khởi động lại để áp dụng các thay đổi và kết nối tác nhân.

### Để tải xuống toàn bộ ISO VirtIO lên vSAN

Các hướng dẫn sau đây cho phép đặt tệp win-virtio.iso (chứa phần mềm tác nhân khách cần thiết) lên vSAN; điều này cho phép nạp phần mềm vào ổ CD-ROM của VM để dễ dàng cài đặt bên trong hệ điều hành khách.

1. Nhấp vào liên kết bên dưới để truy cập ISO VirtIO.
2. Liên kết Tải lên từ URL xuất hiện, với tất cả các trường được tự động điền sẵn; thường thì không cần thay đổi gì; tuy nhiên, nếu muốn, có thể thay đổi các trường Tên tệp, Mô tả tệp và/hoặc Mức ưu tiên.
3. Nhấp Gửi để tải tệp ISO VirtIO xuống vSAN.
4. Khi tiến trình hiển thị hoàn tất 100% (thanh tiến trình ở góc trên bên phải) thì tệp đã sẵn sàng, xuất hiện trong danh sách Tệp và có tùy chọn để chọn trên bất kỳ ổ CD nào. Xem hướng dẫn bên dưới để cài đặt phần mềm tác nhân khách từ ISO VirtIO đã tải xuống.

### Để cài đặt Guest Agent (Windows) từ ISO VirtIO

{% hint style="info" %}
VM phải có thiết bị CD-ROM
{% endhint %}

1. Đi tới **bảng điều khiển VM**.
2. Nhấp vào nút chọn CD-ROM (góc trên bên trái) ![fa-eject.png](/files/d6ace49a304486633aa17d429dcaabe1cdd4857a)
3. Chọn **virtio-win.iso (hoặc tên tệp đã được sửa đổi trong quá trình tải xuống)**.
4. Nhấp vào **Gửi** để áp dụng thay đổi CD.
5. Nhấp vào **Bảng điều khiển từ xa** trên menu bên trái để mở console vào hệ điều hành khách.
6. Đi tới **Trình quản lý Thiết bị Windows**.
7. Nhấp chuột phải vào **"PCI Simple Communications Controller"**.
8. Chọn **Cập nhật trình điều khiển**.
9. Duyệt đến **đường dẫn của ổ CD-ROM** chứa tệp ISO đã tải xuống.
10. Điều hướng đến: **vioserial\PHIÊN BẢN WINDOWS CỦA BẠN (ví dụ: 2k12R2, WIN10, v.v.)**.
11. Nhấp vào **Tiếp theo** để hoàn tất việc cập nhật trình điều khiển.
12. Trong File Explorer của Windows, **duyệt đến ổ CD-ROM** chứa ISO VirtIO.
13. Điều hướng đến thư mục **guest-agent** thư mục.
14. **Nhấp đúp** vào tệp MSI phù hợp **(qemu-ga-x86.msi\[64-bit] hoặc qemu-ga-1386.msi\[32-bit])** để khởi chạy trình cài đặt.

{% hint style="success" %}
Có thể cần khởi động lại VM để kết nối tác nhân với máy chủ.
{% endhint %}

## Cài đặt phần mềm tác nhân trên các VM Linux

Trên các VM Linux, **gói qemu-guest-agent** phải được cài đặt. Hướng dẫn cài đặt sẽ khác nhau tùy theo bản phân phối/phiên bản Linux cụ thể.

* Trên các hệ thống dùng apt để cài đặt **(dựa trên Debian/Ubuntu)**:

  ```
  apt-get install qemu-guest-agent
  ```
* Trên các hệ thống sử dụng **Yum (Red Hat)**:

  ```
  yum install qemu-guest-agent
  ```
* Một số bản phân phối sẽ yêu cầu **khởi động lại hoặc khởi chạy thủ công** tác nhân:

  ```
  systemctl start qemu-guest-agent
  ```

## Xác minh kết nối Guest Agent của VM

Khi tác nhân khách được kết nối thành công, số phiên bản sẽ hiển thị bên cạnh hộp kiểm Guest Agent đã được chọn trên bảng điều khiển VM.

![agent-connected-version.png](/files/f5ead639b4562ac3b6c38bc2d65a702f3a20d6ee)


---

# 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/may-ao/vm-guest-agent.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.