O que é o QEMU Guest Agent e por que a VM não mostra IP

O guest agent é o canal entre o hipervisor e o interior da máquina. Sem ele o IP fica vazio, pedidos de desligamento não chegam e do painel não se diz nada para dentro.

AtlasPVE ·

Este verbete responde a

  • qemu guest agent não funciona
  • proxmox vm não mostra endereço ip
  • acessar uma vm do proxmox sem ssh
  • executar comando dentro de uma vm do proxmox
  • instalar qemu-guest-agent

Olhar uma máquina virtual no painel do Proxmox e achar o campo de IP vazio é um momento comum. A causa quase sempre é a mesma: o QEMU Guest Agent não está rodando dentro da máquina.

Como é o canal

O guest agent é um canal entre o hipervisor e o interior da máquina. Ele não fala pela rede, e sim por uma porta serial virtual. Essa distinção importa: o canal se mantém mesmo quando a rede da máquina está quebrada, e nenhuma porta de rede é aberta para ele.

O que se perde sem ele

Sem agente, o Proxmox não enxerga dentro da máquina. O campo de IP fica vazio, porque quem informa é a própria máquina. Um pedido de desligamento também não chega: ao apertar o botão, o hipervisor não consegue enviar um sinal de desligamento limpo para dentro, e só lhe resta puxar o cabo. Congelar o sistema de arquivos para um backup consistente falha pelo mesmo motivo.

Como se instala

No Debian e no Ubuntu o pacote se chama qemu-guest-agent, e depois de instalar é preciso habilitar o serviço. No RHEL, Rocky e AlmaLinux o pacote tem o mesmo nome. A maioria das imagens de nuvem já o traz. Depois, o sinalizador de agente precisa estar ligado na configuração da máquina e ela precisa ser reiniciada uma vez; com o sinalizador desligado o canal nunca se estabelece.

É uma nova superfície de ataque

Não, e a razão está em onde o privilégio já mora. Quem tem root no host Proxmox já alcança disco, memória e console da máquina. O guest agent não amplia esse privilégio, apenas o leva para um canal ordenado. O ganho é concreto: chegar à máquina não exige mais abrir porta SSH, distribuir senhas ou decorar um IP.

Fontes

A documentação oficial do Proxmox. Em inglês, e é ela que dá a palavra final neste assunto.

Verbetes relacionados

Como isso aparece dentro do Atlas?

Ir para a página do produto