Skip to content
VDS · Sistem operasi

Guest agent: mengapa penting dan cara memasangnya ulang

Apa yang disediakan qemu-guest-agent, cara mengetahui bahwa ia menghilang, dan cara memulihkannya di Debian, Ubuntu, AlmaLinux, dan Windows Server.

Diperbarui 23 Agustus 2026

Panel mendapatkan sebagian datanya bukan dari luar, melainkan dari layanan kecil di dalam sistem — qemu-guest-agent. Layanan ini tidak membuka port atau menyentuh jaringan: komunikasinya berjalan melalui kanal virtualisasi internal.

Apa yang disediakannya

  • Ruang disk terpakai yang sebenarnya pada ring Overview. Tanpa agent, panel hanya mengetahui ukuran image.
  • Reboot dan shutdown yang mulus: sistem menerima sinyal dan menghentikan layanan dengan benar alih-alih pemutusan daya mendadak.
  • Daftar alamat jaringan mesin yang akurat.

Tanpa agent, mesin tetap berjalan; panel hanya menampilkan lebih sedikit, dan reboot menjadi sulit — dengan segala risiko terhadap database dan file system.

Cara mengetahui agent tidak ada

Tanda pertamanya adalah di Overview pada /hosting/vds/m/<id> ruang disk terpakai menghilang. Dalam kasus ini, panel sendiri menampilkan perintah instalasi untuk sistem Anda.

Periksa dari dalam:

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

Jika tidak ada device di /dev/virtio-ports, layanan akan mulai lalu langsung tertidur: kanal untuknya tidak ada.

Instalasi

Debian dan Ubuntu:

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

AlmaLinux dan CentOS Stream:

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

Windows Server 2022 dan 2025: agent adalah bagian dari set driver virtio-win. Instal virtio-win-guest-tools, lalu di snap-in “Services” pastikan QEMU Guest Agent berjalan dan diatur untuk mulai otomatis.

Setelah beberapa detik, segarkan Overview — ruang terpakai seharusnya muncul.

Mengapa agent bisa hilang

PenyebabApa yang terjadi
Instalasi dengan set paket minimalAgent memang tidak pernah ada sejak awal
apt autoremoveDihapus sebagai “dependensi yang tidak diperlukan”
Pembersihan “layanan tambahan”Layanan dinonaktifkan secara manual
Instal ulang OSImage baru tanpa konfigurasi kustom Anda

Anda dapat mengembalikannya kapan saja dengan aman: layanan ini tidak menimbulkan beban yang berarti dan tidak menyentuh jaringan.

Error umum

  • Layanan berstatus active tetapi tidak ada data di panel — tunggu grafik diperbarui dan periksa keberadaan device di /dev/virtio-ports.
  • Unit qemu-guest-agent.service not found — paketnya belum terinstal, bukan rusak.
  • Agent sudah terinstal tetapi reboot masih sulit — periksa autostart: systemctl is-enabled qemu-guest-agent.

Agent tidak menggantikan akses ke mesin. Jika sistem tidak mau boot, bukan agent yang membantu Anda — melainkan rescue disk.