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

docker: invalid containerPort: 80a

Pe scurt

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: 80a când portul din dreapta nu e un număr (80a, http, $PORT gol);
  • invalid hostPort: 99999 câ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

Greșit
BASH
docker run -d -p 8080:80a nginx
Corect
BASH
docker run -d -p 8080:80 nginx

Portul containerului trebuie să fie un număr.

2Variabilă goală

Greșit
BASH
docker run -d -p 8080:$APP_PORT api   # APP_PORT nu e setat
Corect
BASH
docker run -d -p 8080:${APP_PORT:-3000} api

${VAR:-3000} pune o valoare implicită când variabila lipsește.

3Port al gazdei prea mare

Greșit
BASH
docker run -d -p 80800:80 nginx
Corect
BASH
docker run -d -p 8080:80 nginx

Porturile valide sunt între 1 și 65535; altfel apare invalid hostPort.

Repară tu

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.

Alte forme ale mesajului

  • docker: invalid hostPort: 80800
  • docker: invalid containerPort: http
  • Error 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

← 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.