docker: invalid containerPort: 80a
Portul containerului din -p (partea din dreapta) nu e un număr valid: o literă în plus, un nume de serviciu (http), un spațiu sau o variabilă goală. Scrie -p PORT_GAZDA:PORT_CONTAINER cu numere între 1 și 65535, de exemplu -p 8080:80. Pentru portul gazdei, eroarea e invalid hostPort.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
-p 8080:80 înseamnă: portul 8080 al calculatorului duce la portul 80 al containerului. Clientul docker verifică ambele numere înainte să creeze containerul și refuză cu cod 125:
invalid containerPort: 80acând portul din dreapta nu e un număr (80a,http,$PORTgol);invalid hostPort: 99999când portul din stânga e în afara intervalului 1–65535.
Cauzele frecvente sunt greșelile de scriere, variabilele de mediu nesetate (-p 8080:$APP_PORT, care devine -p 8080:), un protocol scris greșit (80/tpc) și caracterele invizibile copiate din documente sau chat (spații speciale, cratime lungi).
Forma completă e [IP:]PORT_GAZDA:PORT_CONTAINER[/tcp|udp], de exemplu 127.0.0.1:5432:5432.
De ce apare: cauzele frecvente
1Port scris greșit
docker run -d -p 8080:80a nginxdocker run -d -p 8080:80 nginxPortul containerului trebuie să fie un număr.
2Variabilă goală
docker run -d -p 8080:$APP_PORT api # APP_PORT nu e setatdocker run -d -p 8080:${APP_PORT:-3000} api${VAR:-3000} pune o valoare implicită când variabila lipsește.
3Port al gazdei prea mare
docker run -d -p 80800:80 nginxdocker run -d -p 8080:80 nginxPorturile valide sunt între 1 și 65535; altfel apare invalid hostPort.
Repară eroarea, direct în pagină
Comanda din documentația echipei, docker run -d --name web -p 8080:80a nginx:1.27-alpine, cade cu docker: invalid containerPort: 80a. Pornește containerul web din nginx:1.27-alpine cu portul 80 al containerului publicat pe portul 8080 al calculatorului și verifică pagina.
Indiciu
nginx ascultă în container pe portul 80; partea din dreapta lui -p e doar un număr.
Reparația
docker run -d --name web -p 8080:80 nginx:1.27-alpine
curl -s localhost:8080 | head -n 4De ce merge
Clientul validează porturile din -p înainte să creeze containerul, iar 80a nu e un număr, deci comanda era refuzată. Cu -p 8080:80, containerul pornește, Docker leagă portul 8080 al calculatorului de portul 80 al lui nginx, iar curl localhost:8080 primește pagina de bun venit.
Alte forme ale mesajului
docker: invalid hostPort: 80800docker: invalid containerPort: httpError response from daemon: invalid port specification: "80a"
Cum o eviți pe viitor
Scrie porturile ca numere, în forma GAZDĂ:CONTAINER, și verifică după pornire cu docker ps (coloana PORTS) sau docker port nume. În scripturi, dă valori implicite variabilelor (${PORT:-8080}). Când copiezi comenzi din documente, rescrie de mână opțiunile cu cratimă, ca să eviți caracterele invizibile.
Întrebări frecvente
Pot folosi nume de servicii, ca http, în loc de 80?
Nu. -p acceptă doar numere (sau intervale ca 8000-8010:8000-8010). Numele de servicii din /etc/services nu sunt înțelese.
Care port e al calculatorului și care al containerului?
Stânga e calculatorul (pe el deschizi localhost:8080), dreapta e containerul (portul pe care ascultă aplicația, de obicei cel din EXPOSE).
Erori înrudite
docker: Error response from daemon: driver failed programming external connectivity on endpoint magazin: Bind for 0.0.0.0:8080 failed: port is already allocated. Portul de pe calculator din -p 8080:80 e deja folosit de alt container (sau de alt program). Găsește-l cu docker ps --filter publish=8080, oprește-l, sau publică pe alt port, de exemplu -p 8081:80. Error: No public port '80/tcp' published for web docker port arată doar porturile publicate pe calculator cu -p. Containerul tău a fost pornit fără -p 8080:80 (sau cu alt port intern), deci portul 80 nu e accesibil din afară. Recreează containerul cu -p, de exemplu docker run -d --name web -p 8080:80 nginx. curl: (7) Failed to connect to localhost port 8080 after 0 ms: Couldn't connect to server Pe calculator nu ascultă nimic pe portul 8080: containerul nu publică portul (lipsește -p 8080:80), e oprit sau portul din dreapta nu e cel pe care ascultă aplicația. Verifică cu docker ps coloana PORTS și recreează containerul cu -p 8080:80. Î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.
