Docker Engine

Pool overlaps with other one on this address space – Docker NETWORK_POOL_OVERLAPS

NETWORK_POOL_OVERLAPS

L'errore Pool overlaps with other one on this address space compare quando Docker tenta di creare una rete con una subnet che si sovrappone a una rete già esistente o a una rete raggiungibile dall'host. È comune con subnet personalizzate in Compose, VPN e ambienti con molte reti residue. La diagnosi confronta le subnet di docker network inspect con le reti locali prima di scegliere un intervallo libero.

Categoria: DockerGruppo: Docker EngineConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 20 volte

Cosa significa questo errore?

L'errore Pool overlaps with other one on this address space compare quando Docker tenta di creare una rete con una subnet che si sovrappone a una rete già esistente o a una rete raggiungibile dall'host. È comune con subnet personalizzate in Compose, VPN e ambienti con molte reti residue. La diagnosi confronta le subnet di docker network inspect con le reti locali prima di scegliere un intervallo libero.

Messaggio originale

Pool overlaps with other one on this address space

Contesto e parole chiave

Alias

  • network subnet overlap
  • non-overlapping IPv4 address pool

Messaggi alternativi

  • Impossibile creare una rete non sovrapposta
  • La subnet della rete Docker si sovrappone a un'altra rete

Prodotti

  • Docker Engine networking

Piattaforme

  • Linux
  • macOS
  • Windows

Parole chiave

  • docker network ipam
  • docker pool overlaps
  • docker subnet overlap

Cause possibili

Subnet già usata da un'altra rete Docker

Un progetto precedente o un'altra installazione Compose occupa lo stesso intervallo privato.

molto comune

Subnet in conflitto con LAN o VPN

La rete scelta per i container coincide con una rete fisica o con un tunnel instradato dall'host.

comune

Diagnosi

Subent delle reti Docker esistenti

Elencare e ispezionare le reti per raccogliere i blocchi IP già assegnati.

Come leggere il risultato. Le subnet già presenti non devono intersecare quella richiesta.

bash
docker network ls && docker network inspect $(docker network ls -q)

Reti dell'host e VPN

Confrontare le reti Docker con routing e interfacce locali.

Come leggere il risultato. Una sovrapposizione con la LAN o VPN può rompere anche la connettività dopo la creazione.

bash
ip route

Risoluzione

Scelta di una subnet privata non sovrapposta

Difficoltà: mediaRischio: medioRichiede amministratore

Definire esplicitamente un blocco libero e coerente nel file Compose o nel comando di creazione.

  1. Raccogliere le subnet in uso.
  2. Scegliere un intervallo privato non sovrapposto.
  3. Impostare ipam.config.subnet nel file Compose.
  4. Ricreare il progetto e verificare le rotte.

Rimozione mirata delle reti obsolete

Difficoltà: mediaRischio: altoRichiede amministratore

Eliminare solo reti non più usate dopo aver verificato i container collegati.

  1. Identificare le reti senza container utili.
  2. Scollegare o fermare i progetti interessati.
  3. Rimuovere solo le reti obsolete.
  4. Ricreare la rete con una subnet verificata.
bash
docker network rm nome_rete

Non usare prune alla cieca: può rimuovere reti necessarie ad altri progetti locali.

Domande frequenti

È sicuro usare docker network prune?

Solo dopo aver verificato che le reti non siano più usate: la pulizia rimuove reti non collegate e può interrompere progetti locali che si aspettano di ritrovarle.

Approfondimenti

Schede correlate