Could not connect to Redis at 127.0.0.1:6379: Connection refused
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
docker run --rm redis:7 redis-cli set cos:ana 3docker exec cache redis-cli set cos:ana 3exec rulează clientul chiar lângă serverul care merge în containerul cache.
2localhost în aplicație
environment:
REDIS_URL: redis://localhost:6379environment:
REDIS_URL: redis://cache:6379În aceeași rețea Docker, serviciul Redis se găsește după nume.
3Port nepublicat pe calculator
docker run -d --name cache redis:7
redis-cli pingdocker run -d --name cache -p 127.0.0.1:6379:6379 redis:7
redis-cli pingPublicat pe 127.0.0.1, portul e accesibil doar de pe calculatorul tău.
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.
Reparația
docker exec cache redis-cli set cos:ana 3
docker exec cache redis-cli get cos:anaOK
3De ce merge
Containerul nou pornit cu docker run --rm avea propriul 127.0.0.1, fără niciun server Redis, deci conexiunea era refuzată. docker exec cache redis-cli rulează clientul în containerul cache, unde 127.0.0.1:6379 e chiar serverul. Comanda set scrie cheia, iar get cos:ana o citește înapoi.
Alte forme ale mesajului
Could not connect to Redis at localhost:6379: Connection refusedError: connect ECONNREFUSED 127.0.0.1:6379redis.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
MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017 Clientul (mongosh sau aplicația) încearcă MongoDB pe 127.0.0.1, adică în propriul container, unde nu rulează niciun server. Folosește numele containerului bazei în conexiune (mongodb://mongo:27017/magazin), cu ambele containere în aceeași rețea, sau rulează mongosh cu docker exec în containerul bazei. 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. ping: bad address 'cache' Containerul nu poate traduce numele altui container în adresă IP, pentru că sunt pe rețeaua bridge implicită, unde Docker nu oferă DNS după nume. Creează o rețea proprie (docker network create magazin) și leagă ambele containere de ea; acolo numele containerelor se rezolvă automat. Î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.
