Skip to content
VDS · Operačné systémy

Guest agent: prečo je dôležitý a ako ho preinštalovať

Čo poskytuje qemu-guest-agent, ako zistiť, že zmizol, a ako ho obnoviť na Debiane, Ubuntu, AlmaLinux a Windows Server.

Aktualizované 23. augusta 2026

Panel získava časť svojich údajov nie zvonku, ale z malej služby vo vnútri systému — qemu-guest-agent. Neotvára porty ani sa nedotýka siete: komunikácia prebieha cez interný virtualizačný kanál.

Čo poskytuje

  • Reálne využité miesto na disku v kruhu v Prehľade. Bez agenta panel pozná len veľkosť obrazu.
  • Šetrný reštart a vypnutie: systém dostane signál a služby sa korektne zastavia namiesto tvrdého vypnutia.
  • Presný zoznam sieťových adries stroja.

Bez agenta stroj ďalej beží; panel toho len menej zobrazuje a reštarty sa stávajú riskantnými — so všetkými rizikami pre databázu a súborový systém.

Ako zistiť, že chýba

Prvým príznakom je, že v Prehľade na /hosting/vds/m/<id> zmizne využité miesto na disku. V takom prípade panel sám zobrazí inštalačný príkaz pre tvoj systém.

Skontroluj zvnútra:

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

Ak v /dev/virtio-ports nie je žiadne zariadenie, služba sa spustí a hneď sa uspí: kanál pre ňu neexistuje.

Inštalácia

Debian a Ubuntu:

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

AlmaLinux a CentOS Stream:

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

Windows Server 2022 a 2025: agent je súčasťou sady ovládačov virtio-win. Nainštaluj virtio-win-guest-tools, potom v snap-in “Služby” over, že QEMU Guest Agent beží a má nastavené automatické spustenie.

Po niekoľkých sekundách obnov Prehľad — využité miesto by sa malo zobraziť.

Prečo mizne

PríčinaČo sa stalo
Inštalácia s minimálnou sadou balíkovAgent tam nebol už od začiatku
apt autoremoveOdstránený ako “nepotrebná závislosť”
Čistenie “Extra služieb”Služba bola zakázaná manuálne
Preinštalovanie OSČistý obraz bez tvojej vlastnej konfigurácie

Môžeš ho kedykoľvek bezpečne vrátiť späť: služba nevytvára citeľnú záťaž a nedotýka sa siete.

Časté chyby

  • Služba je active, ale v paneli nie sú žiadne údaje — počkaj, kým sa grafy aktualizujú, a skontroluj zariadenie v /dev/virtio-ports.
  • Unit qemu-guest-agent.service not found — balík nie je nainštalovaný, nie je pokazený.
  • Agent je nainštalovaný, ale reštarty sú stále riskantné — skontroluj automatické spustenie: systemctl is-enabled qemu-guest-agent.

Agent nenahrádza prístup k stroju. Ak sa systém nedá nabootovať, nepomôže ti — to dokáže záchranný disk.