Tu VM Debian arranca, su red funcionaba, pero Proxmox aún mostraba « Agente invitado no en ejecución » o no reportaba ninguna información. La opción Agente Invitado QEMU marcada en la interfaz no es suficiente para establecer el intercambio con el invitado.
El Agente Invitado QEMU instala un daemon en Debian y crea un canal de gestión entre la VM y el host. Vas a verificar ambos lados, luego aislar una falla de configuración, de servicio o de dispositivo sin modificar la red de la VM.
¿Para qué sirve el Agente Invitado QEMU en Proxmox ?
Una VM puede funcionar normalmente sin agente. Proxmox ve entonces la máquina virtual, pero no dispone del mismo nivel de información sobre el sistema Debian que corre en su interior.
El Agente Invitado QEMU ejecuta qemu-ga en el invitado. El daemon intercambia con el hipervisor a través de un dispositivo virtio-serial, generalmente expuesto en Debian bajo /dev/virtio-ports/org.qemu.guest_agent.0. Proxmox puede así solicitar información a la VM, organizar un apagado limpio y coordinar la congelación y descongelación del sistema de archivos durante ciertas copias de seguridad o ciertos snapshots.
La documentación oficial de Proxmox y la de QEMU describen esta cadena host, canal virtual y daemon invitado. El agente no reemplaza ni el controlador de red VirtIO, ni DHCP, ni el puente, ni el firewall.
Activar el agente del lado de Proxmox antes de tocar Debian
Comienza por detener la VM si planeas modificar su configuración de hardware. En la interfaz de Proxmox, abre la VM Debian, ve a Opciones, edita Agente Invitado QEMU, y luego activa la opción. Verifica también el VMID mostrado en la interfaz : servirá únicamente en el host Proxmox.
Te aconsejo verificar esta opción del lado de Proxmox antes de instalar el paquete en Debian. Así separarás una ausencia de canal virtual de un simple servicio faltante.
El equivalente en línea de comandos indicado por Proxmox es el siguiente :
qm set VMID --agent 1Reemplaza VMID por el identificador numérico de tu VM. Esta acción activa la opción del lado del host. No inicia el servicio Debian y no prueba la presencia del canal virtio-serial.
Si la configuración acaba de ser agregada y el dispositivo no aparece en el invitado, haz un apagado y luego un arranque controlado de la VM. No asumas que una conexión en caliente estará disponible en todas las configuraciones.
Instalar y arrancar qemu-guest-agent en Debian
Abre una terminal en la VM Debian. Una actualización del índice APT evita trabajar con metadatos obsoletos :
sudo apt-get update
sudo apt-get install qemu-guest-agentLuego controla la unidad systemd en lugar de encadenar inmediatamente reinicios :
sudo systemctl status qemu-guest-agent --no-pagerDeberías obtener un servicio conocido y un estado active (running). Si está instalado pero inactivo, inícialo y luego habilita su inicio con Debian :
sudo systemctl start qemu-guest-agent
sudo systemctl enable qemu-guest-agentRevisa systemctl status después de estas acciones. Un mensaje de error es más útil que un nuevo intento idéntico. La instalación del paquete no afecta la tarjeta de red, el puente o la configuración IP.
Verificar el canal virtio-serial en la VM
Un servicio activo puede esperar un dispositivo que la VM no presenta. Verifica la ruta utilizada por el Agente Invitado QEMU :
ls -l /dev/virtio-ports/org.qemu.guest_agent.0El archivo debe estar presente. Si falta, la reinstalación del paquete no solucionará nada. Primero revisa la opción Agente Invitado QEMU en Proxmox, luego la configuración de hardware de la VM. Puede que sea necesario un apagado y un arranque controlados después de la modificación.
Si la ruta existe pero Proxmox aún no recibe ninguna respuesta, lee los últimos mensajes del servicio :
sudo journalctl -u qemu-guest-agent --no-pager -n 50La manpage oficial de Debian de qemu-ga también documenta /etc/qemu/qemu-ga.conf y el transporte virtio-serial. Mantén esta pista para un error claramente relacionado con el daemon o su canal, no para una falla en la dirección IP.
Probar la respuesta desde el host Proxmox
Atención: el estado active (running) en Debian confirma el servicio, no la respuesta recibida por el host. Para verificar la sintaxis disponible en tu versión de Proxmox, comienza en el host con este preflight :
qm help agentEsta ayuda debe confirmar la forma exacta esperada por tu instalación. Luego ejecuta únicamente la forma qm agent mostrada por este preflight, con el VMID correspondiente. No doy ningún subcomando supuestamente aquí : puede variar según la versión de la herramienta, y un comando inventado no constituye una prueba.
El resultado esperado es una respuesta de información coherente con la VM mostrada en Proxmox. Compárala con el estado del agente en la interfaz. Una dirección IP visible puede ayudar, pero no es suficiente para probar el funcionamiento completo del canal de gestión.
Corregir la falla en la capa correcta
Cuando varios síntomas se parecen, esta tabla evita reinstalar Debian cuando el dispositivo falta del lado de la VM.
| Síntoma | Capa probable | Comando o control | Acción mínima |
|---|---|---|---|
| Opción inactiva | Proxmox | Opciones de la VM | Activar Agente Invitado QEMU, luego reiniciar la VM si el canal no aparece. |
| Unidad desconocida | Debian | systemctl status qemu-guest-agent | Instalar el paquete con APT, luego revisar el estado del servicio. |
| Servicio en error | Debian | systemctl status y journalctl | Leer el primer error antes de cualquier nuevo reinicio. |
| Dispositivo ausente | virtio-serial | ls -l /dev/virtio-ports/org.qemu.guest_agent.0 | Corregir la opción o el hardware virtual del lado de Proxmox, luego realizar un ciclo de apagado y arranque. |
Si el agente responde desde el host pero la VM aún no tiene red, detén el diagnóstico del Agente Invitado QEMU en este punto. La conectividad es responsabilidad del puente, la interfaz virtual o Debian. El post Restablecer la red de una VM Proxmox, del puente al invitado cubre esta cadena sin mezclar los dos problemas.
Si el control muestra un defecto en el puente en el host, usa mejor Crear un puente Proxmox sin perder el acceso al servidor. No modifiques el puente para corregir un agente no detectado : las dos capas se comunican, pero no cumplen el mismo rol.
Validar el apagado y las copias de seguridad sin sobreprometer
Una respuesta válida desde el host permite luego controlar los beneficios esperados. Realiza un apagado de invitado controlado desde Proxmox, luego consulta la tarea y los registros del host. La VM debe detenerse adecuadamente en lugar de sufrir un corte forzado.
Para una copia de seguridad o snapshot que utiliza la congelación del sistema de archivos, verifica también los mensajes de tarea. La congelación y descongelación mejoran la coherencia del sistema de archivos. No garantizan la coherencia aplicativa de todas las bases de datos : una base aún debe seguir su propio procedimiento de copia de seguridad.
Aquí están las cuatro pruebas a reunir antes de considerar la instalación finalizada :
- la opción Agente Invitado QEMU está activa del lado de Proxmox ;
- el paquete y el servicio están presentes en Debian ;
- el dispositivo virtio-serial existe bajo la ruta esperada ;
- el host recibe una respuesta después del preflight
qm help agenty la prueba adaptada a su versión.
El canal está validado cuando estos cuatro controles coinciden. Si responde, deja la red tranquila : no falta un agente para reparar un puente.