...
Eroare Docker · Baze de date în containere

Could not connect to Redis at 127.0.0.1:6379: Connection refused

Pe scurt

redis-cli (sau aplicația) caută Redis pe 127.0.0.1, adică în propriul container sau pe calculator fără port publicat, unde nu rulează niciun server. Rulează redis-cli în containerul Redis (docker exec cache redis-cli) sau conectează-te după nume: redis-cli -h cache.

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

Ce înseamnă

Fără -h, redis-cli se conectează la 127.0.0.1:6379. Mesajul spune că acolo nu ascultă nimic: conexiunea a fost refuzată imediat.

În Docker, 127.0.0.1 înseamnă locul de unde rulezi comanda:

  • într-un container nou (docker run --rm redis:7 redis-cli), e chiar acel container, unde serverul nu rulează;
  • în containerul aplicației (REDIS_URL=redis://localhost:6379), e containerul aplicației;
  • pe calculator, merge doar dacă ai publicat portul (-p 6379:6379).

Alte cauze: containerul Redis e oprit sau a căzut (docker ps -a), ori Redis ascultă pe alt port. Dacă mesajul arată un IP de rețea Docker (172.18.x.x) sau un nume, adresa e bună, dar serverul nu răspunde încă.

De ce apare: cauzele frecvente

1redis-cli într-un container nou

Greșit
BASH
docker run --rm redis:7 redis-cli set cos:ana 3
Corect
BASH
docker exec cache redis-cli set cos:ana 3

exec rulează clientul chiar lângă serverul care merge în containerul cache.

2localhost în aplicație

Greșit
BASH
environment:
  REDIS_URL: redis://localhost:6379
Corect
BASH
environment:
  REDIS_URL: redis://cache:6379

În aceeași rețea Docker, serviciul Redis se găsește după nume.

3Port nepublicat pe calculator

Greșit
BASH
docker run -d --name cache redis:7
redis-cli ping
Corect
BASH
docker run -d --name cache -p 127.0.0.1:6379:6379 redis:7
redis-cli ping

Publicat pe 127.0.0.1, portul e accesibil doar de pe calculatorul tău.

Repară tu

Repară eroarea, direct în pagină

Redis rulează în containerul cache. Comanda docker run --rm redis:7 redis-cli set cos:ana 3 dă Could not connect to Redis at 127.0.0.1:6379: Connection refused. Salvează cheia cos:ana cu valoarea 3 chiar în serverul din containerul cache.

Indiciu

Rulează clientul în containerul serverului: docker exec cache redis-cli set cos:ana 3.

Alte forme ale mesajului

  • Could not connect to Redis at localhost:6379: Connection refused
  • Error: connect ECONNREFUSED 127.0.0.1:6379
  • redis.exceptions.ConnectionError: Error 111 connecting to localhost:6379. Connection refused.

Cum o eviți pe viitor

Pune adresa Redis într-o variabilă de mediu (REDIS_URL) cu numele serviciului, nu localhost, și pornește aplicația și Redis în aceeași rețea sau același proiect Compose. Pentru comenzi manuale, folosește docker exec cache redis-cli. Publică portul pe calculator doar dacă ai nevoie, și doar pe 127.0.0.1.

Întrebări frecvente

Cum verific dacă Redis chiar rulează?

docker ps (containerul trebuie să fie Up) și docker exec cache redis-cli ping, care răspunde PONG. docker logs cache arată Ready to accept connections.

Și dacă primesc NOAUTH Authentication required?

Conexiunea a reușit, dar Redis are parolă (--requirepass). Dă parola cu redis-cli -a parola sau în URL: redis://:parola@cache:6379.

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.