Network

Overlay network packet delivery failed: UDP port 4789 (VXLAN) blocked between cluster nodes. – Docker OVERLAY_VXLAN_BLOCKED

OVERLAY_VXLAN_BLOCKED

La comunicazione tra container su nodi Swarm differenti non funziona perché il traffico UDP sulla porta 4789 (o ESP protocollo 50 per encryption) è scartato dal firewall.

Categoria: DockerGruppo: NetworkConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

La comunicazione tra container su nodi Swarm differenti non funziona perché il traffico UDP sulla porta 4789 (o ESP protocollo 50 per encryption) è scartato dal firewall.

Messaggio originale

Overlay network packet delivery failed: UDP port 4789 (VXLAN) blocked between cluster nodes.

Contesto e parole chiave

Alias

  • Docker overlay network communication failed
  • UDP port 4789 blocked

Messaggi alternativi

  • comunicazione rete overlay fallita porta UDP 4789 VXLAN bloccata da firewall

Prodotti

  • Docker Engine / Docker Compose / BuildKit / containerd

Piattaforme

  • Docker Desktop su macOS
  • Docker Desktop su Windows
  • Linux

Parole chiave

  • compose
  • container
  • docker
  • docker.network.overlay-vxlan-port-blocked
  • errore-docker-overlay-network-vxlan-udp-4789-blocked
  • Network
  • OVERLAY_VXLAN_BLOCKED

Cause possibili

Origine del problema per Docker Network: comunicazione di rete Overlay fallita (Porta VXLAN bloccata)

La comunicazione tra container su nodi Swarm differenti non funziona perché il traffico UDP sulla porta 4789 (o ESP protocollo 50 per encryption) è scartato dal firewall.

molto comune

Diagnosi

Diagnostica container e log per Docker Network: comunicazione di rete Overlay fallita (Porta VXLAN bloccata)

Eseguire comandi di ispezione dei container e controllare i log del demone Docker con journalctl o docker logs.

Come leggere il risultato. Mostra le eccezioni a runtime dell'applicazione, segnali di terminazione o errori di rete interna.

docker
docker logs --tail 50 <container_id>

Risoluzione

Procedura di risoluzione per Docker Network: comunicazione di rete Overlay fallita (Porta VXLAN bloccata)

Difficoltà: mediaRischio: basso

Applicare la configurazione raccomandata nelle specifiche ufficiali Docker e BuildKit.

  1. Ispezionare i parametri di avvio nel file Dockerfile o docker-compose.yml
  2. Verificare i vincoli di memoria, permessi e compatibilità delle porte
  3. Riavviare il container o eseguire una compilazione pulita senza cache

Domande frequenti

Come risolvere il problema OVERLAY_VXLAN_BLOCKED in Docker?

La comunicazione tra container su nodi Swarm differenti non funziona perché il traffico UDP sulla porta 4789 (o ESP protocollo 50 per encryption) è scartato dal firewall.

Approfondimenti

Schede correlate