Перед установкой агента в гостевой ОС убедитесь, что он включён в настройках виртуальной машины:

1. Остановите ВМ (если она запущена).
2. В веб-интерфейсе Proxmox выберите ВМ → Hardware → Options → QEMU Guest Agent → включите галочку Enable.
3. Сохраните изменения и запустите ВМ.

Установка гостевого агента на примере Debian 12.10 / Ubuntu 24.04.2

1. Подключитесь к виртуальной машине (через консоль Proxmox или SSH).
2. Обновите пакеты и установите qemu-guest-agent:

   sudo apt update
   sudo apt install -y qemu-guest-agent

3. Запустите службу и включите автозагрузку:

   sudo systemctl start qemu-guest-agent
   sudo systemctl enable qemu-guest-agent

4. Проверьте статус:

   sudo systemctl status qemu-guest-agent

   Должен быть статус active (running).

Установка агента одной командой:

sudo apt update && sudo apt install -y qemu-guest-agent && sudo systemctl start qemu-guest-agent && sudo systemctl enable qemu-guest-agent && sudo systemctl status qemu-guest-agent

Проверка работы в Proxmox

1. В веб-интерфейсе Proxmox выберите ВМ → Summary.
2. В разделе QEMU Guest Agent должна отображаться информация (IP-адрес, hostname и т. д.), если агент работает корректно.
3. Также можно проверить через CLI Proxmox:

   qm agent <VMID> ping

   (где <VMID> — ID вашей виртуальной машины). Ответ должен быть pong.

Дополнительные настройки (опционально)

• Автоматическое монтирование дисков: Убедитесь, что в /etc/fstab используются опции noauto,x-systemd.automount, чтобы избежать блокировок при перезагрузке.
• Сброс пароля через Proxmox: После установки гостевого агента вы сможете сбрасывать пароли ВМ через веб-интерфейс.

Решение возможных проблем

• Если агент не запускается, проверьте журнал:

  journalctl -u qemu-guest-agent -b

• Убедитесь, что в настройках ВМ в Proxmox нет опции Enable KVM hardware virtualization, если ВМ использует архитектуру, отличную от хоста (может мешать работе агента).
• Для LXC-контейнеров гостевой агент не требуется (функциональность доступна "из коробки").

После настройки гостевой агент обеспечит корректную работу live-миграции, мониторинга ресурсов и управления ВМ из Proxmox.

Как можно отблагодарить:

• Оформить удобную для вас подписку на Boosty.to
• Разово поддержать через DonationAlerts