docker: Error response from daemon: unable to find user app: no matching entries in passwd file.
Utilizatorul dat la -u sau la USER în Dockerfile nu există în /etc/passwd al imaginii. Creează-l în Dockerfile (RUN addgroup -S app && adduser -S -G app app) înainte de USER, sau folosește un utilizator existent (node, nobody) ori un uid numeric.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când pornești un container cu -u app sau imaginea are USER app, Docker caută numele app în fișierul /etc/passwd din imagine, nu de pe calculatorul tău. Dacă nu-l găsește, containerul nu poate porni: rămâne în starea Created, iar docker run iese cu codul 125.
Cauzele obișnuite: ai scris USER app în Dockerfile, dar ai uitat (sau ai pus după) comanda care creează utilizatorul; ai folosit un nume care există pe calculatorul tău, dar nu în imagine; ai trecut la altă imagine de bază (de la node, care are utilizatorul node, la alpine, care nu-l are).
Un uid numeric (-u 1000) nu dă eroarea asta: Docker îl folosește chiar dacă n-are nume, iar în container vezi I have no name! în prompt.
De ce apare: cauzele frecvente
1USER fără crearea utilizatorului
FROM node:20-alpine
WORKDIR /app
COPY . .
USER app
CMD ["node", "server.js"]FROM node:20-alpine
WORKDIR /app
COPY . .
RUN addgroup -S app && adduser -S -G app app
USER app
CMD ["node", "server.js"]Utilizatorul trebuie să existe în imagine înainte de USER. Pe Alpine îl creezi cu addgroup și adduser -S (fără parolă).
2Utilizatorul există pe calculator, nu în imagine
docker run -u ana alpine iddocker run -u 1000:1000 alpine idContainerul are propriul /etc/passwd. Un uid numeric merge și fără nume în imagine.
3Imaginea are deja un utilizator neprivilegiat
FROM node:20-alpine
USER nodeuserFROM node:20-alpine
USER nodeImaginea oficială node include utilizatorul node (uid 1000), gata de folosit.
Repară eroarea, direct în pagină
În ~/api, Dockerfile-ul setează USER app, dar nu creează utilizatorul, iar containerul nu pornește: unable to find user app. Repară Dockerfile-ul ca să creeze grupul și utilizatorul de sistem app înainte de USER, reconstruiește api:1.1 și rulează containerul api din el, care trebuie să afișeze API pornit și să ruleze ca app.
Indiciu
Pe Alpine: RUN addgroup -S app && adduser -S -G app app, pus înainte de linia USER app.
Reparația
Creează utilizatorul înainte de USER:
cat > Dockerfile <<'EOF'
FROM node:20-alpine
WORKDIR /app
COPY server.js .
RUN addgroup -S app && adduser -S -G app app
USER app
CMD ["node", "server.js"]
EOF
docker build -t api:1.1 .
docker run --name api api:1.1
docker run --rm api:1.1 idAPI pornit
uid=100(app) gid=101(app) groups=101(app)De ce merge
Docker caută utilizatorul din USER în /etc/passwd al imaginii. Cu addgroup -S app && adduser -S -G app app înainte de USER app, utilizatorul există când containerul pornește, deci procesul rulează ca app, fără drepturi de root. Opțiunea -S creează un utilizator de sistem, fără parolă și fără prompturi, potrivit pentru build.
Alte forme ale mesajului
unable to find user app: no matching entries in passwd filedocker: Error response from daemon: unable to find group app: no matching entries in group file.
Cum o eviți pe viitor
Creează utilizatorul și grupul în același Dockerfile, chiar înainte de USER (Alpine: addgroup -S app && adduser -S -G app app; Debian: useradd -r -s /usr/sbin/nologin app). Verifică după build cu docker run --rm imagine id. Când schimbi imaginea de bază, revizuiește liniile USER și chown: utilizatorii predefiniți diferă de la o imagine la alta.
Întrebări frecvente
De ce containerul apare Created, nu Exited?
Pentru că eroarea apare înainte de pornirea procesului principal. Containerul a fost creat, dar n-a rulat niciodată, deci nu are cod de ieșire al aplicației.
E mai bine cu nume sau cu uid?
Numele e mai lizibil în Dockerfile, uid-ul e mai previzibil la permisiunile volumelor. Multe echipe creează utilizatorul cu uid fix (adduser -S -u 10001 app) și pun USER 10001.
Erori înrudite
permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.47/containers/json": dial unix /var/run/docker.sock: connect: permission denied Daemon-ul rulează, dar utilizatorul tău nu are voie să scrie în socket-ul /var/run/docker.sock. Adaugă-te în grupul docker cu sudo usermod -aG docker $USER, apoi deloghează-te și loghează-te din nou (sau rulează newgrp docker). sh: can't create /usr/share/nginx/html/nou.html: Read-only file system Folderul în care scrii e montat doar pentru citire: un bind mount sau volum cu :ro, --mount ...,readonly sau un container pornit cu --read-only. Scrie fișierul pe calculator, în folderul montat (modificarea apare imediat în container), sau montează fără :ro dacă scrierea din container chiar e necesară. Containerul se oprește imediat după pornire: Exited (1) Exited (1) înseamnă că aplicația din container a pornit și a crăpat cu o eroare. Citește motivul cu docker logs nume: de obicei e o cale greșită în CMD, un fișier sau un modul lipsă, o variabilă de mediu obligatorie nesetată sau o eroare în cod. Î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.
