De QEMU Guest Agent inschakelen in pfSense

March 24, 2026

Als je pfSense als virtuele machine op Proxmox VE draait, zorgt de QEMU guest agent ervoor dat Proxmox correct met de VM kan communiceren. Het kan pfSense netjes afsluiten in plaats van de stroom te onderbreken, en het kan de IP-adressen van de VM direct in de Proxmox UI uitlezen.

Stap 1: Agent inschakelen in Proxmox

Vertel Proxmox eerst dat er een guest agent aanwezig zal zijn op de VM. In de Proxmox web UI:

  1. Selecteer de pfSense VM en ga naar Hardware > Options.
  2. Dubbelklik op QEMU Guest Agent en vink Enabled aan.
  3. Klik op OK.

Je kunt dit ook via de CLI op de Proxmox host instellen:

qm set <VMID> --agent enabled=1

Vervang <VMID> door het ID van jouw VM (bijv. 100).

Stap 2: De plugin installeren in pfSense

De guest agent is beschikbaar als FreeBSD package. Het is niet beschikbaar in de pfSense Package Manager.

  1. Open de console van de pfSense machine of verbind via SSH.
  2. Gebruik het commando pkg install -y qemu-guest-agent om de agent te installeren.

Stap 3: De workaround voor pfSense

Omdat pfSense anders omgaat met het opstarten dan standaard FreeBSD, moet je een symlink aanmaken. pfSense leest namelijk alleen bestanden met de extensie .sh tijdens het opstarten.

Voer het volgende commando uit om een link aan te maken met de .sh extensie:

ln -s /usr/local/etc/rc.d/qemu-guest-agent /usr/local/etc/rc.d/qemu-guest-agent.sh

Stap 4: Opnieuw opstarten of de service starten

Na de installatie en het aanmaken van het .sh-bestand, start je opnieuw op!

Als opnieuw opstarten geen optie is, kun je de agent service handmatig starten:

service qemu-guest-agent start

Verificatie in Proxmox

Ga terug naar de Proxmox web UI, selecteer de VM en open het tabblad Summary. De IP-adressen van de pfSense interfaces verschijnen nu onder de VM-samenvatting. De Shutdown-knop in Proxmox stuurt voortaan ook een nette ACPI-afsluitmelding in plaats van een gesimuleerde stroomonderbreking.