Skip to content
VDS · Hệ điều hành

Guest agent: vì sao quan trọng và cách cài lại

qemu-guest-agent cung cấp những gì, cách nhận biết nó đã biến mất và cách khôi phục trên Debian, Ubuntu, AlmaLinux và Windows Server.

Cập nhật 23 tháng 8, 2026

Bảng điều khiển lấy một phần dữ liệu không phải từ bên ngoài mà từ một dịch vụ nhỏ bên trong hệ thống — qemu-guest-agent. Dịch vụ này không mở cổng và không chạm vào mạng: mọi liên lạc diễn ra qua kênh ảo hóa nội bộ.

Dịch vụ này cung cấp gì

  • Dung lượng đĩa thực tế đã dùng trong vòng tròn Tổng quan. Không có agent, bảng điều khiển chỉ biết kích thước của image.
  • Khởi động lại và tắt máy êm ái: hệ thống nhận tín hiệu và dừng các dịch vụ đúng cách thay vì bị cắt điện đột ngột.
  • Danh sách địa chỉ mạng của máy chính xác.

Không có agent, máy vẫn chạy bình thường; bảng điều khiển chỉ hiển thị ít hơn, và việc khởi động lại trở nên khó khăn — kèm theo mọi rủi ro cho cơ sở dữ liệu và hệ thống tệp.

Cách nhận biết agent bị thiếu

Dấu hiệu đầu tiên là trong Tổng quan tại /hosting/vds/m/<id>, dung lượng đĩa đã dùng biến mất. Trong trường hợp đó, chính bảng điều khiển sẽ hiển thị lệnh cài đặt cho hệ thống của bạn.

Kiểm tra từ bên trong:

systemctl status qemu-guest-agent
ls -l /dev/virtio-ports/org.qemu.guest_agent.0

Nếu không có thiết bị nào trong /dev/virtio-ports, dịch vụ sẽ khởi động rồi ngay lập tức đi vào trạng thái ngủ: kênh dành cho nó không tồn tại.

Cài đặt

Debian và Ubuntu:

apt update
apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

AlmaLinux và CentOS Stream:

dnf install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

Windows Server 2022 và 2025: agent là một phần của bộ driver virtio-win. Cài virtio-win-guest-tools, sau đó trong snap-in “Services” hãy đảm bảo QEMU Guest Agent đang chạy và được đặt tự động khởi động.

Sau vài giây, hãy làm mới Tổng quan — dung lượng đã dùng sẽ xuất hiện.

Vì sao agent biến mất

Nguyên nhânĐiều đã xảy ra
Cài đặt với bộ gói tối thiểuAgent vốn chưa từng có mặt
apt autoremoveBị gỡ như một “phụ thuộc không cần thiết”
Dọn dẹp “dịch vụ thừa”Dịch vụ bị vô hiệu hóa thủ công
Cài lại hệ điều hànhImage mới không có cấu hình tùy chỉnh của bạn

Bạn có thể khôi phục agent bất cứ lúc nào một cách an toàn: dịch vụ này không tạo tải đáng kể và không chạm vào mạng.

Lỗi thường gặp

  • Dịch vụ ở trạng thái active nhưng bảng điều khiển không có dữ liệu — hãy đợi biểu đồ cập nhật và kiểm tra thiết bị trong /dev/virtio-ports.
  • Unit qemu-guest-agent.service not found — gói chưa được cài, không phải bị hỏng.
  • Agent đã được cài nhưng việc khởi động lại vẫn khó khăn — hãy kiểm tra tự động khởi động: systemctl is-enabled qemu-guest-agent.

Agent không thay thế quyền truy cập vào máy. Nếu hệ thống không khởi động được, nó không phải là thứ giúp bạn — mà là đĩa cứu hộ.