...
Eroare n8n · HTTP Request și API-uri

connect ECONNREFUSED 127.0.0.1:3000

Pe scurt

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

Greșit
JSON
http://localhost:3000/comenzi   (n8n în Docker, API pe calculator)
Corect
JSON
http://host.docker.internal:3000/comenzi

host.docker.internal indică spre calculatorul gazdă din interiorul containerului.

2Două servicii în Docker Compose

Greșit
JSON
http://localhost:5432   (n8n spre containerul api)
Corect
JSON
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

Greșit
JSON
http://192.168.1.20:8080   (aplicația ascultă pe 8000)
Corect
JSON
http://192.168.1.20:8000

Portul trebuie să fie cel pe care ascultă efectiv aplicația.

Repară tu

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.

Alte forme ale mesajului

  • The service refused the connection - perhaps it is offline
  • connect ECONNREFUSED ::1:5678
  • ECONNREFUSED

Cum o eviți pe viitor

  • Când n8n rulează în Docker, nu folosi localhost pentru 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

← Toate erorile n8n

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ță 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.