1,461 22/03/2026 07/04/2026 3 min

Quando si utilizza KVM con libvirt, una rete bridge è essenziale per garantire che i guest possano comunicare con il mondo esterno. Tuttavia, molti utenti si sono imbattuti nell'errore 'Network Bridge Unavailable', che può interrompere il flusso di lavoro. Questo articolo esplora un caso concreto di un ambiente di virtualizzazione dove è necessario affrontare e risolvere questo problema, ottimizzando nel contempo le performance dei guest.

Prerequisiti

  • Accesso a un server Linux con KVM e libvirt installati.
  • Permessi di amministrazione per modificare le configurazioni di rete.
  • Conoscenze di base sulla configurazione delle reti in Linux.

Step 1: Identificare l'errore nel log di libvirt

Iniziamo controllando i log di libvirt per identificare il messaggio di errore specifico.

sudo journalctl -xe | grep libvirt

# Output: libvirt: Network Bridge Unavailable

Perché funziona: I log forniscono dettagli fondamentali su problemi relativi alla rete di virtualizzazione.

Step 2: Verificare la configurazione del bridge

Assicuriamoci che il bridge di rete sia configurato correttamente nel file di configurazione di libvirt. Accediamo al file:

sudo nano /etc/network/interfaces

Controlliamo che ci sia una configurazione simile a questa:

auto br0
iface br0 inet dhcp
  bridge_ports eth0

# Output: Configuration of bridge br0 containing eth0

Perché funziona: Questa configurazione assicura che il bridge br0 utilizzi l'interfaccia fisica eth0 per ottenere un indirizzo IP tramite DHCP.

Step 3: Riavviare il servizio di rete

Dopo aver confermato che la configurazione è corretta, riavviamo il servizio di rete per applicare le modifiche:

sudo systemctl restart networking

# Output: No errors should be displayed.

Perché funziona: Riavviare il servizio di rete rielabora le configurazioni, attivando il bridge specificato.

Step 4: Controllare lo stato del bridge

Verifichiamo che il bridge sia attivo con il seguente comando:

brctl show

# Output: br0 8000.000000000000 noe eth0

Perché funziona: Questo comando mostra le interfacce di rete configurate nel bridge e verifica che sia attivo.

Step 5: Testare la connettività del guest

Una volta confermato che il bridge è configurato correttamente e attivo, dobbiamo testare la connettività dal guest. Accediamo al guest e proviamo a pingare un indirizzo esterno:

ping 8.8.8.8

# Output: PING 8.8.8.8 (8.8.8.8) 56 data bytes

Perché funziona: Effettuando un ping a un indirizzo noto, verifichiamo che il guest possa accedere a Internet tramite il bridge configurato.

Verifica finale

Controlla nuovamente i log di libvirt per assicurarti che non ci siano messaggi di errore presenti, utilizzando il comando:

sudo journalctl -xe | grep libvirt

Troubleshooting

  • Errore: Network Bridge Interface Missing
    Causa: Il bridge non è stato creato.
    Fix: Creare il bridge manualmente con brctl addbr br0.
  • Errore: Cannot find interface
    Causa: L'interfaccia fisica non esiste o non è attiva.
    Fix: Controllare il nome dell'interfaccia con ip a.
  • Errore: Address already in use
    Causa: Un'altra interfaccia sta usando lo stesso indirizzo IP.
    Fix: Cambiare la configurazione IP nel file /etc/network/interfaces.

Conclusione

Abbiamo affrontato un problema comune nella gestione delle reti bridge in KVM/libvirt, risolvendo l'errore 'Network Bridge Unavailable'. Ora il tuo guest dovrebbe essere in grado di connettersi correttamente a Internet. Come prossimo passo, considera di monitorare le performance del tuo ambiente KVM per ottimizzare ulteriormente le risorse assegnate ai guest.