Перейти к содержимому
VDS · Операционные системы

Гостевой агент: зачем он и как поставить обратно

Что даёт 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.

Агент не заменяет доступ к машине. Если система не грузится, помогает не он, а диск восстановления.