qemu-guest-agent в Proxmox: как поставить, проверить и заставить работать

Я, как и ты, однажды увидел в journalctl:

EXT4-fs error (device sda1): ext4_journal_check_start:61: Detected aborted journal
failed to connect to guest agent

Я подумал: «ну ок, починю». Поставил qemu-guest-agent. Запустил. Служба — active (running). А qm agent 111 ping — молчит.

Я начал думать, что:
— сломался Proxmox
— гостевая ОС не та
— я не тот
— мир рушится

Но нет. Просто всё работает не так, как в мануале.

Что такое qemu-guest-agent?

Это маленький демон внутри виртуалки, который говорит хосту:
«Эй, Proxmox! Я готов. Можешь делать снапшот. Я заморозил FS. Давай.»

Без него Proxmox делает бэкап «на лету», но не знает, когда «сейчас безопасно».
Итог: повреждение журнала ext4, «грязный» снапшот, возможная потеря данных.

Как поставить (на Debian/Ubuntu)

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

Проверь:

systemctl status qemu-guest-agent

Если видишь active (running) — служба запущена. Но это ещё не значит, что Proxmox её видит.

Что делать, если qm agent ping молчит

Даже если служба работает, qm agent 111 ping может не отвечать. Вот что проверить:

1. Включи QEMU Guest Agent в настройках VM

Зайди в веб-интерфейс Proxmox → VM → Options → QEMU Guest Agent
Поставь галочку: Enable the QEMU Guest Agent
Тип: VirtIO (не ISA!)

2. Перезагрузи VM

Без перезагрузки канал связи не создастся.

qm stop 111 && qm start 111

3. Проверь, есть ли устройство в гостевой системе

Зайди в VM и выполни:

ls /dev/virtio-ports/

Должно быть:
org.qemu.guest_agent.0

Если нет — Proxmox не создал устройство. Проверь галочку и перезагрузи.

4. Перезапусти службу внутри VM

Иногда служба стартует до появления устройства.

sudo systemctl restart qemu-guest-agent

5. Проверь на хосте

qm agent 111 ping

Если молчит — попробуй:

qm agent 111 get-osinfo

Если видишь JSON с информацией о системе — агент работает!

Даже если служба qemu-guest-agent внутри ВМ вроде работает, команда:

qm agent 111 ping

может ничего не возвращать. Это не означает, что агент сломан. Скорее всего — канал связи не настроен.

1. Включи QEMU Guest Agent в настройках ВМ

Зайди в веб-интерфейс Proxmox → выбери свою ВМ → вкладка Options → строка QEMU Guest Agent

Поставь галочку: Enable the QEMU Guest Agent
Убедись, что тип: VirtIO (не ISA!)

Без этой галочки устройство /dev/virtio-ports/org.qemu.guest_agent.0 не появится — и агент работать не будет.

2. Перезагрузи виртуальную машину

Настройка вступает в силу только после перезагрузки.

qm stop 111 && qm start 111

Простой reboot изнутри ВМ может не помочь — нужна полная остановка и запуск через qm.

3. Проверь, появилось ли устройство в гостевой системе

Зайди в ВМ и выполни:

ls /dev/virtio-ports/

Должно отобразиться:

org.qemu.guest_agent.0

Если файла нет — значит, Proxmox не создал канал. Вернись к шагу 1 и проверь галочку.

4. Перезапусти службу внутри ВМ

Иногда служба стартует до появления устройства и просто падает.

sudo systemctl restart qemu-guest-agent

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

sudo systemctl status qemu-guest-agent

Убедись, что статус active (running).

5. Проверь работу агента на хосте

На Proxmox-хосте выполни:

qm agent 111 ping

Если молчит — не паникуй. Попробуй:

qm agent 111 get-osinfo

Если видишь JSON с информацией об ОС, имени хоста, версии — значит, агент работает. Просто ping не всегда отвечает мгновенно.

Зачем это всё нужно?

Когда qemu-guest-agent работает:

Бэкапы чистые — без EXT4-fs error и aborted journal
Снапшоты безопасны — ФС корректно замораживается (fs-freeze)
Мягкое выключение: qm shutdown 111 (без --force)
Proxmox видит: IP, имя, нагрузку, состояние дисков

Вывод

Если в логах видишь:

aborted journal
EXT4-fs error
Buffer I/O error

— не гадай.
Поставь qemu-guest-agent, включи в настройках ВМ, перезагрузи.

Это не «можно». Это надо.
Иначе ты не админ.
Ты просто человек, который нажимает кнопки —
и потом копается в крешах, как в помойке.

Зачем это всё?

Когда qemu-guest-agent работает:

Бэкапы чистые — без EXT4-fs error
Файловая система замораживается при снапшоте
Можно корректно выключать VM: qm shutdown 111
Proxmox видит IP, нагрузку, имя хоста

Вывод

Если у тебя в логах aborted journal — не гадай. Поставь qemu-guest-agent, включи в настройках VM, перезагрузи.

Это не «можно». Это надо.

Иначе ты не админ. Ты просто человек, который нажимает кнопки и потом копается в крешах.

Категории