Гостьовий агент: навіщо потрібен і як перевстановити

Що дає qemu-guest-agent, як зрозуміти, що він зник, і як відновити його на Debian, Ubuntu, AlmaLinux і Windows Server.

Оновлено 23 серпня 2026 р.

Частину даних панель бере не ззовні, а з невеликого сервісу всередині системи — qemu-guest-agent. Він не відкриває портів і не торкається мережі: обмін іде внутрішнім каналом віртуалізації.

Що він дає

Реально зайнятий дисковий простір у кільці на сторінці «Огляд». Без агента панель знає лише розмір образу.
Коректне перезавантаження й вимкнення: система отримує сигнал і зупиняє сервіси як слід, а не зазнає раптового знеструмлення.
Точний список мережевих адрес машини.

Без агента машина далі працює; панель просто показує менше, а перезавантаження стають жорсткими — з усіма ризиками для бази даних і файлової системи.

Як зрозуміти, що його немає

Перша ознака — на сторінці «Огляд» за адресою /hosting/vds/m/<id> зникає зайнятий дисковий простір. У такому разі панель сама показує команду встановлення для вашої системи.

Перевірте зсередини:

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

Якщо в /dev/virtio-ports немає пристрою, сервіс запускається й одразу засинає: каналу для нього не існує.

Встановлення

Debian і Ubuntu:

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

AlmaLinux і CentOS Stream:

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

Windows Server 2022 і 2025: агент входить до набору драйверів virtio-win. Встановіть virtio-win-guest-tools, а потім в оснастці «Служби» переконайтеся, що QEMU Guest Agent запущено й налаштовано на автоматичний запуск.

За кілька секунд оновіть сторінку «Огляд» — зайнятий простір має з'явитися.

Чому він зникає

Причина	Що сталося
Встановлення з мінімальним набором пакетів	Агента не було від самого початку
`apt autoremove`	Видалено як «непотрібну залежність»
Чищення «зайвих сервісів»	Службу вимкнули вручну
Перевстановлення ОС	Свіжий образ без вашого налаштування

Ви можете будь-коли безпечно повернути його: служба не створює помітного навантаження й не торкається мережі.

Типові помилки

Служба active, але в панелі немає даних — зачекайте, поки оновляться графіки, і перевірте наявність пристрою в /dev/virtio-ports.
Unit qemu-guest-agent.service not found — пакет не встановлено, а не зламано.
Агент встановлено, але перезавантаження все одно жорсткі — перевірте автозапуск: systemctl is-enabled qemu-guest-agent.

Агент не замінює доступ до машини. Якщо система не завантажується, допоможе не він, а рятувальний диск.