...
Eroare Docker · Imagini, tag-uri și registry

Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

Pe scurt

Daemon-ul a găsit adresa registry-ului, dar nu a primit răspuns la timp: conexiunea e blocată de firewall, de un proxy nesetat sau e foarte lentă. Verifică rețeaua și proxy-ul daemon-ului; pentru un server fără acces la internet, mută imaginea cu docker save și docker load.

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

Ce înseamnă

Spre deosebire de no such host, aici DNS-ul a mers. Daemon-ul a trimis cererea HTTPS către registry, dar în timpul alocat nu a primit nici măcar antetele răspunsului (Client.Timeout exceeded while awaiting headers), așa că a renunțat.

Cauzele tipice:

  • un firewall de firmă blochează ieșirea spre Docker Hub (portul 443);
  • rețeaua merge doar printr-un proxy, iar serviciul Docker nu îl are configurat;
  • un VPN sau un Wi-Fi slab pierde pachetele;
  • serverul e intenționat izolat de internet (producție, rețea internă).

Mesajul poate apărea la docker pull, docker run, docker login sau în docker build (la FROM). Dacă curl -I https://registry-1.docker.io/v2/ de pe același calculator rămâne și el agățat, problema e în rețea; dacă răspunde imediat cu 401, problema e în setările de proxy ale daemon-ului.

De ce apare: cauzele frecvente

1Server fără acces la internet

Greșit
BASH
ssh server-productie
docker pull redis:7
Corect
BASH
docker save -o redis-7.tar redis:7
scp redis-7.tar server-productie:
ssh server-productie docker load -i redis-7.tar

Imaginea se mută ca fișier: save o împachetează cu toate straturile, load o pune în lista locală a celuilalt server.

2Proxy configurat doar în terminal

Greșit
BASH
export HTTPS_PROXY=http://proxy.firma.ro:3128
docker pull redis:7
Corect
BASH
sudo systemctl edit docker
# [Service]
# Environment="HTTPS_PROXY=http://proxy.firma.ro:3128"
sudo systemctl restart docker

Cererea o face daemon-ul, care nu vede variabilele din terminalul tău.

3Rețea instabilă momentan

Greșit
BASH
docker pull postgres:16
# eroare la primul timeout
Corect
BASH
docker pull postgres:16
# reîncearcă după ce rețeaua e stabilă; straturile deja descărcate rămân

Straturile complete nu se mai descarcă a doua oară, deci o nouă încercare continuă de unde a rămas.

Repară tu

Repară eroarea, direct în pagină

Serverul pe care lucrezi nu are acces la Docker Hub, iar docker pull redis:7 cade cu Client.Timeout exceeded while awaiting headers. Un coleg ți-a copiat imaginea în arhiva ~/redis-7.tar. Încarc-o în Docker și pornește din ea containerul cache.

Indiciu

docker load -i ~/redis-7.tar, apoi docker run -d --name cache redis:7.

Alte forme ale mesajului

  • Error response from daemon: Get "https://registry-1.docker.io/v2/": context deadline exceeded
  • Error response from daemon: Get "https://registry-1.docker.io/v2/": dial tcp 54.198.86.24:443: i/o timeout
  • Error response from daemon: Head "https://registry-1.docker.io/v2/library/redis/manifests/7": net/http: TLS handshake timeout

Cum o eviți pe viitor

Pe rețele de firmă, configurează proxy-ul în serviciul Docker o singură dată și verifică cu docker info (câmpurile HTTP Proxy, HTTPS Proxy). Pentru servere izolate, pregătește imaginile pe un calculator cu internet și mută-le cu docker save / docker load sau printr-un registry intern. În CI, păstrează imaginile de bază în cache, ca build-ul să nu depindă de fiecare dată de Docker Hub.

Întrebări frecvente

Diferă de „no such host”?

Da. „no such host” înseamnă că numele nu a putut fi rezolvat (DNS). „Client.Timeout” înseamnă că adresa e cunoscută, dar conexiunea nu răspunde la timp (firewall, proxy, rețea lentă).

docker save păstrează tag-ul?

Da, dacă salvezi după nume (docker save -o f.tar redis:7). Dacă salvezi după ID, imaginea ajunge fără tag și o etichetezi apoi cu docker tag.

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.