...
Eroare Docker · Rețele, porturi și volume

Error response from daemon: invalid pool request: Pool overlaps with other one on this address space

Pe scurt

Subrețeaua cerută pentru rețeaua nouă se suprapune cu una existentă (altă rețea Docker, un VPN sau rețeaua locală). Alege alt --subnet, care nu e folosit (docker network inspect îți arată ce e ocupat), sau lasă Docker să aleagă singur.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare rețea Docker de tip bridge primește o subrețea (de exemplu 172.18.0.0/16). Două rețele nu pot avea adrese comune, altfel nu s-ar mai ști pe unde pleacă pachetele. La docker network create --subnet ... sau la docker compose up cu ipam în compose.yaml, daemon-ul verifică intervalul și refuză cu Pool overlaps dacă se suprapune.

Se suprapune cu:

  • altă rețea Docker, creată de tine sau de alt proiect Compose cu aceeași subrețea;
  • un VPN care folosește adrese 172.16.x.x–172.31.x.x sau 10.x.x.x;
  • un proiect Compose vechi, oprit fără down, a cărui rețea a rămas.

Fără --subnet, Docker alege singur o subrețea liberă. Varianta could not find an available, non-overlapping IPv4 address pool apare când s-au terminat intervalele implicite, de obicei din cauza multor rețele rămase de la proiecte vechi.

De ce apare: cauzele frecvente

1Aceeași subrețea a doua oară

Greșit
BASH
docker network create --subnet 172.30.0.0/16 vechi
docker network create --subnet 172.30.0.0/16 magazin-net
Corect
BASH
docker network create --subnet 172.31.0.0/16 magazin-net

Intervalul nou nu are nicio adresă comună cu cel existent.

2Rețele rămase de la proiecte vechi

Greșit
BASH
docker network create magazin-net
# could not find an available, non-overlapping IPv4 address pool
Corect
BASH
docker network prune
docker network create magazin-net

prune șterge rețelele nefolosite și eliberează intervalele lor.

3Subrețea fixă în Compose

Greșit
BASH
networks:
  default:
    ipam:
      config:
        - subnet: 10.0.0.0/8
Corect
BASH
networks:
  default:
    ipam:
      config:
        - subnet: 10.42.0.0/24

Un interval mic și specific are mult mai puține șanse să se ciocnească de VPN-uri sau de alte rețele.

Repară tu

Repară eroarea, direct în pagină

Rețeaua vechi folosește deja 172.30.0.0/16, iar docker network create --subnet 172.30.0.0/16 magazin-net dă Pool overlaps with other one on this address space. Creează rețeaua magazin-net cu subrețeaua 172.31.0.0/16, fără să ștergi rețeaua vechi.

Indiciu

docker network create --subnet 172.31.0.0/16 magazin-net.

Alte forme ale mesajului

  • Error response from daemon: Pool overlaps with other one on this address space
  • failed to create network magazin_default: Error response from daemon: invalid pool request: Pool overlaps with other one on this address space
  • Error response from daemon: could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network

Cum o eviți pe viitor

Nu fixa subrețele decât dacă ai nevoie (reguli de firewall, IP-uri fixe); lasă Docker să aleagă. Dacă le fixezi, notează-le pentru tot proiectul și alege intervale mici (/24) din zone pe care nu le folosește VPN-ul firmei. Oprește proiectele Compose cu docker compose down, nu doar stop, și rulează din când în când docker network prune.

Întrebări frecvente

Cum văd ce subrețele sunt ocupate?

docker network inspect -f '{{.Name}} {{range .IPAM.Config}}{{.Subnet}}{{end}}' $(docker network ls -q) le afișează pe toate. Pe calculator, ip route arată și rețelele VPN-ului.

Pot schimba subrețeaua unei rețele existente?

Nu. O ștergi (după ce deconectezi containerele) și o creezi din nou cu alt --subnet.

Erori înrudite

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Docker de la zero, cu exerciții la fiecare lecție

Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.