Error response from daemon: Get "https://registry.firma.ro/v2/": tls: failed to verify certificate: x509: certificate signed by unknown authority
Daemon-ul nu are încredere în certificatul TLS al registry-ului, de obicei pentru că e semnat de autoritatea internă a firmei sau un proxy inspectează traficul. Pune certificatul CA al firmei în /etc/docker/certs.d/registry.firma.ro/ca.crt (sau în certificatele sistemului) și repornește Docker.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când vorbește cu un registry prin HTTPS, daemon-ul verifică cine a semnat certificatul serverului. Dacă autoritatea (CA) nu e în lista de încredere, conexiunea e oprită: x509: certificate signed by unknown authority.
În firme, cauza e aproape mereu una din două: registry-ul intern (registry.firma.ro, Harbor, Nexus, GitLab) are un certificat emis de CA-ul firmei, sau un proxy de securitate interceptează traficul spre internet și îl resemnează cu propriul certificat, deci și Docker Hub pare „semnat de necunoscut”.
Reparația corectă e să adaugi CA-ul firmei: pentru un singur registry, în /etc/docker/certs.d/<registry>/ca.crt (Docker îl citește la fiecare conexiune), sau în certificatele de încredere ale sistemului, urmat de repornirea daemon-ului. Varianta insecure-registries dezactivează verificarea și nu e o soluție pentru producție.
De ce apare: cauzele frecvente
1Registry intern cu CA-ul firmei
docker pull registry.firma.ro/echipa/api:1.0sudo mkdir -p /etc/docker/certs.d/registry.firma.ro
sudo cp firma-ca.crt /etc/docker/certs.d/registry.firma.ro/ca.crt
docker pull registry.firma.ro/echipa/api:1.0Docker caută CA-uri suplimentare în folderul cu numele exact al registry-ului (inclusiv portul, dacă există).
2Proxy care inspectează HTTPS
docker pull node:20-alpine
# x509 și pentru Docker Hubsudo cp firma-ca.crt /usr/local/share/ca-certificates/firma-ca.crt
sudo update-ca-certificates
sudo systemctl restart dockerProxy-ul semnează toate site-urile cu CA-ul firmei. Adăugat în sistem, e acceptat pentru orice registry.
3Certificat pus în imagine, nu pe gazdă
COPY firma-ca.crt /usr/local/share/ca-certificates/# certificatul trebuie pe calculatorul care rulează daemon-ul
sudo cp firma-ca.crt /etc/docker/certs.d/registry.firma.ro/ca.crtPull-ul îl face daemon-ul de pe gazdă. CA-ul din imagine ajută doar programele care rulează în container.
Repară eroarea, direct în pagină
La docker pull registry.firma.ro/echipa/api:1.0 primești x509: certificate signed by unknown authority. Echipa de infrastructură ți-a dat CA-ul firmei în ~/firma-ca.crt. Instalează-l pentru registry-ul registry.firma.ro, ca daemon-ul să aibă încredere în el (parola sudo este academia).
Indiciu
Daemon-ul caută CA-uri suplimentare în /etc/docker/certs.d/<numele registry-ului>/ca.crt.
Reparația
sudo mkdir -p /etc/docker/certs.d/registry.firma.ro
sudo cp ~/firma-ca.crt /etc/docker/certs.d/registry.firma.ro/ca.crt
ls -l /etc/docker/certs.d/registry.firma.ro-rw-r--r-- 1 root root ... ca.crtPe un calculator real, urmează din nou docker pull registry.firma.ro/echipa/api:1.0.
De ce merge
Pentru fiecare registry, Docker citește certificatele din /etc/docker/certs.d/<registry>/. Fișierul ca.crt de acolo devine o autoritate de încredere doar pentru acel registry, deci certificatul serverului, semnat de CA-ul firmei, trece verificarea. Folderul are nevoie de drepturi de root, de aceea comenzile rulează cu sudo. Nu ai dezactivat verificarea TLS, ci i-ai spus lui Docker cine e semnatarul.
Alte forme ale mesajului
x509: certificate signed by unknown authorityError response from daemon: Get "https://registry-1.docker.io/v2/": tls: failed to verify certificate: x509: certificate signed by unknown authorityERROR: failed to solve: failed to do request: Head "https://registry.firma.ro/v2/echipa/api/manifests/1.0": tls: failed to verify certificate: x509: certificate signed by unknown authority
Cum o eviți pe viitor
Cere de la echipa de infrastructură certificatul CA al firmei (fișier .crt în format PEM) și instalează-l o dată, la configurarea calculatorului. Pentru fiecare registry intern, folderul din /etc/docker/certs.d/ trebuie să aibă exact numele din imagine (registry.firma.ro:5000, dacă are port). Evită insecure-registries, care acceptă orice certificat.
Întrebări frecvente
Trebuie să repornesc Docker după ce pun ca.crt în certs.d?
Pentru /etc/docker/certs.d/ nu e obligatoriu, daemon-ul citește folderul la fiecare conexiune. Pentru certificatele sistemului (update-ca-certificates) da, repornește-l cu sudo systemctl restart docker.
Pe Docker Desktop unde pun certificatul?
Docker Desktop folosește certificatele de încredere ale sistemului (Keychain pe macOS, magazinul de certificate pe Windows). Instalează CA-ul acolo și repornește Docker Desktop.
Erori înrudite
Error response from daemon: Get "https://registry-1.docker.io/v2/": unauthorized: incorrect username or password Docker Hub a refuzat perechea utilizator + parolă la docker login. Folosește numele de utilizator Docker Hub (nu adresa de email) și, dacă ai autentificare în doi pași sau ești în firmă, un Personal Access Token în locul parolei, dat cu --password-stdin. docker: Error response from daemon: pull access denied for ngnix, repository does not exist or may require 'docker login': denied: requested access to the resource is denied Docker nu găsește imaginea cerută pe Docker Hub: de obicei numele e scris greșit (ngnix în loc de nginx) sau e o imagine privată ori una locală care nu există încă. Corectează numele sau construiește imaginea înainte, iar pentru cele private rulează docker login. Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? Comanda docker (clientul) nu găsește serviciul Docker (daemon-ul dockerd) care face de fapt treaba. Pornește Docker Desktop sau serviciul cu sudo systemctl start docker, apoi verifică cu docker info. Î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.
