connect ECONNREFUSED 127.0.0.1:3000
Adresa a fost găsită, dar nimic nu acceptă conexiuni pe acel port. Cel mai des: folosești localhost din n8n rulat în Docker (localhost e containerul n8n, nu calculatorul tău) sau serviciul țintă e oprit. Folosește adresa reală a serviciului (host.docker.internal, numele serviciului din Docker Compose sau domeniul public).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
connect ECONNREFUSED 127.0.0.1:3000 înseamnă că n8n a încercat să deschidă o conexiune spre adresa și portul indicate și a fost refuzat imediat: nu ascultă niciun program acolo. n8n îl poate afișa și ca „The service refused the connection - perhaps it is offline”.
Cel mai frecvent scenariu: n8n rulează în Docker, iar URL-ul este http://localhost:3000. În container, localhost (127.0.0.1) este chiar containerul n8n, nu calculatorul tău și nici alt container. Serviciul tău nu e acolo, deci conexiunea e refuzată. Reparația: http://host.docker.internal:3000 (serviciu pe calculatorul gazdă, pe Docker Desktop), numele serviciului din docker-compose.yml (http://api:3000) dacă sunt în aceeași rețea Docker, sau adresa publică.
Alte cauze: serviciul țintă e oprit, ascultă pe alt port, ascultă doar pe 127.0.0.1 al altei mașini, sau un firewall respinge conexiunea.
De ce apare: cauzele frecvente
1localhost din containerul n8n
http://localhost:3000/comenzi (n8n în Docker, API pe calculator)http://host.docker.internal:3000/comenzihost.docker.internal indică spre calculatorul gazdă din interiorul containerului.
2Două servicii în Docker Compose
http://localhost:5432 (n8n spre containerul api)http://api:3000 (numele serviciului din compose)Containerele din aceeași rețea Compose se găsesc după numele serviciului.
3Serviciul țintă e oprit sau pe alt port
http://192.168.1.20:8080 (aplicația ascultă pe 8000)http://192.168.1.20:8000Portul trebuie să fie cel pe care ascultă efectiv aplicația.
Repară eroarea, direct în pagină
Nodul Comenzi ERP cere http://localhost:3000/comenzi și nu ajunge la serviciu (în n8n real: „connect ECONNREFUSED 127.0.0.1:3000”; n8n rulează în Docker, deci localhost e chiar containerul). API-ul de comenzi este publicat la https://api.exemplu.ro/comenzi. Schimbă URL-ul și rulează: nodul trebuie să dea cele 4 comenzi.
Indiciu
localhost din containerul n8n nu este calculatorul pe care rulează serviciul.
Reparația
Comenzi ERP → URL: https://api.exemplu.ro/comenzi, apoi Execute workflow: 4 comenzi (5001–5004).
În instalarea ta reală, adresa ar fi http://host.docker.internal:3000/comenzi sau numele serviciului din Docker Compose.
De ce merge
Din interiorul containerului, localhost înseamnă containerul n8n, unde nu ascultă nimic pe portul 3000. Cererea trebuie trimisă la adresa la care serviciul e accesibil din rețeaua lui n8n, aici domeniul public al API-ului. Cu URL-ul corect, nodul primește lista celor 4 comenzi.
Alte forme ale mesajului
The service refused the connection - perhaps it is offlineconnect ECONNREFUSED ::1:5678ECONNREFUSED
Cum o eviți pe viitor
- Când n8n rulează în Docker, nu folosi
localhostpentru alte servicii. - Pune n8n și serviciile lui în aceeași rețea Docker Compose și folosește numele serviciilor.
- Verifică din containerul n8n:
docker exec -it n8n wget -qO- http://api:3000/health. - Pentru servicii externe, folosește domeniul public, nu adrese IP locale.
Întrebări frecvente
De ce din browser merge http://localhost:3000?
Pentru că browserul rulează pe calculatorul tău, unde serviciul chiar ascultă pe 3000. n8n din Docker are propriul localhost.
Ce e host.docker.internal pe Linux?
Pe Docker Desktop (Mac, Windows) există implicit. Pe Linux îl adaugi la pornirea containerului cu --add-host=host.docker.internal:host-gateway sau în compose, la extra_hosts.
Erori înrudite
getaddrinfo ENOTFOUND api.exmplu.ro n8n nu a găsit serverul: numele de domeniu din URL nu există sau nu poate fi rezolvat prin DNS (greșeală de scriere, subdomeniu greșit, adresă internă inaccesibilă din n8n). Verifică URL-ul literă cu literă; pentru adrese interne, asigură-te că n8n le poate accesa. The connection timed out, consider setting the 'Retry on Fail' option in the node settings Serverul nu a răspuns în timpul permis (ETIMEDOUT / timeout of ...ms exceeded): e lent, supraîncărcat sau inaccesibil din rețeaua n8n. Activează Retry On Fail pentru căderi ocazionale, mărește Options → Timeout pentru operații lente și verifică dacă n8n poate ajunge la server. Invalid URL Textul din câmpul URL nu e o adresă completă: lipsește protocolul (https://), are spații, ghilimele sau o expresie care a dat un rezultat gol. Scrie adresa completă, începând cu https://, și verifică previzualizarea expresiei. Învață n8n de la zero, cu exerciții la fiecare lecție
Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
