Как установить qemu-guest-agent
Гостевой агент ставится в два шага: пакет внутри машины и опция в Proxmox.
Шаг 1. Пакет внутри машины
Как его поставить, зависит от системы в машине:
Debian или Ubuntuapt
sudo apt update
sudo apt install qemu-guest-agentRHEL, 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). Перезагрузка изнутри гостевой системы не подойдёт: канал связи с агентом добавляется только при новом запуске машины.
То же из терминала узла (номер машины — свой); новый запуск машины всё равно нужен:
qm set 100 --agent 1Зачем он нужен
Агент — служба внутри машины, через которую Proxmox общается с гостевой системой:
- на странице Summary машины видны её IP-адреса;
- Shutdown выключает систему через агента — надёжнее, чем сигнал кнопки питания;
- перед резервной копией в режиме Snapshot и перед снимком агент «замораживает» файловые системы, и копия получается целостной.
Проверка
На узле Proxmox (номер машины — свой):
qm agent 100 pingЕсли агент работает, команда завершается молча, без сообщений. Сообщение об ошибке значит, что опция в Proxmox выключена, машину после её включения не запускали заново или служба внутри не работает. Внутри машины проверьте службу:
systemctl status qemu-guest-agentЕсли она не запущена, выполните sudo systemctl start qemu-guest-agent. В Debian и Ubuntu служба запускается сама, когда в машине есть канал связи с Proxmox, поэтому после нового запуска машины обычно ничего делать не нужно.
Подводные камни
- Опция включена, а агента внутри нет. Proxmox будет ждать ответа агента при Shutdown, и выключение закончится по тайм-ауту. Либо поставьте агента, либо выключите опцию.
- Агент мешает резервным копиям баз данных в Windows. Некоторые программы (например, SQL Server) сами делают целостные копии через службу теневого копирования, и «заморозка» агентом может им помешать. Её можно отключить: Options → QEMU Guest Agent → снять флажок заморозки файловых систем — но тогда копии могут быть несогласованными.