Глиф Учебники

Как установить qemu-guest-agent

Справочник · Proxmox VE · 2 минуты чтения

Гостевой агент ставится в два шага: пакет внутри машины и опция в Proxmox.

Шаг 1. Пакет внутри машины

Как его поставить, зависит от системы в машине:

Debian или Ubuntuapt

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

RHEL, Rocky Linux, AlmaLinux, Fedoradnf

sudo dnf install qemu-guest-agent, затем sudo systemctl start qemu-guest-agent.

Windowsс образа virtio-win

Сначала поставьте с образа драйверов virtio-win драйвер «PCI Simple Communications Controller» (папка vioserial), затем запустите с того же образа установщик guest-agent\qemu-ga-x86_64.msi. Проверка в PowerShell — Get-Service QEMU-GA. Подробнее — Как установить Windows в Proxmox.

Контейнерам LXC агент не нужен: Proxmox и так видит всё, что внутри них.

Шаг 2. Опция в Proxmox

Машина → Options → QEMU Guest Agent → Edit → отметьте Use QEMU Guest Agent → OK. Затем выключите машину (Shutdown) и включите снова (Start). Перезагрузка изнутри гостевой системы не подойдёт: канал связи с агентом добавляется только при новом запуске машины.

То же из терминала узла (номер машины — свой); новый запуск машины всё равно нужен:

Bash
qm set 100 --agent 1

Зачем он нужен

Агент — служба внутри машины, через которую Proxmox общается с гостевой системой:

Проверка

На узле Proxmox (номер машины — свой):

Bash
qm agent 100 ping

Если агент работает, команда завершается молча, без сообщений. Сообщение об ошибке значит, что опция в Proxmox выключена, машину после её включения не запускали заново или служба внутри не работает. Внутри машины проверьте службу:

Bash
systemctl status qemu-guest-agent

Если она не запущена, выполните sudo systemctl start qemu-guest-agent. В Debian и Ubuntu служба запускается сама, когда в машине есть канал связи с Proxmox, поэтому после нового запуска машины обычно ничего делать не нужно.

Подводные камни