wget: can't connect to remote host (10.96.118.62): Connection refused
Numele serviciului s-a rezolvat (avem IP-ul), dar conexiunea e refuzată: fie targetPort-ul serviciului nu e portul pe care ascultă containerul, fie serviciul nu are endpoint-uri. Compară targetPort cu containerPort și verifică kubectl get endpoints.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la wget (busybox), rulat într-un pod. Apare după ce DNS-ul a funcționat: IP-ul din paranteză e ClusterIP-ul serviciului. Conexiunea refuzată înseamnă că pe drumul serviciu → pod nu ascultă nimeni.
Cele mai frecvente două cauze: targetPort greșit (serviciul trimite traficul pe portul 80, dar aplicația ascultă pe 8080) sau serviciul fără endpoint-uri (selectorul nu se potrivește cu etichetele podurilor, ori podurile nu sunt Ready). În al doilea caz, kube-proxy respinge direct conexiunea.
Diagnostic rapid: kubectl get endpoints NUME (dacă e gol, e o problemă de selector sau de readiness) și kubectl describe svc NUME (compară TargetPort cu portul containerului). Același mesaj în curl este curl: (7) Failed to connect ... Connection refused.
De ce apare: cauzele frecvente
1targetPort greșit
kubectl expose deploy magazin --port=80 --target-port=80 # aplicația ascultă pe 8080kubectl patch svc magazin -p '{"spec":{"ports":[{"port":80,"targetPort":8080}]}}'targetPort trebuie să fie portul containerului.
2Fără endpoint-uri
selector:
app: magazin-web # podurile au app: magazinselector:
app: magazinSelectorul alege podurile din spatele serviciului.
3Aplicația ascultă doar pe localhost
# serverul pornește pe 127.0.0.1:8080# serverul pornește pe 0.0.0.0:8080Traficul vine pe IP-ul podului, nu pe localhost.
Repară eroarea, direct în pagină
Catalogul unei edituri (catalog, academia/magazin:v1, ascultă pe 8080) e expus prin serviciul catalog cu targetPort: 80. Din podul test, wget http://catalog dă Connection refused. Schimbă targetPort la 8080, fără să schimbi portul serviciului (80).
Indiciu
kubectl describe svc catalog arată TargetPort; aplicația ascultă pe 8080.
Reparația
Eroarea și porturile:
kubectl exec test -- wget -qO- -T 2 http://catalog || true
kubectl describe svc catalog | grep -E 'TargetPort|Endpoints'wget: can't connect to remote host (10.96.109.24): Connection refused
command terminated with exit code 1
TargetPort: 80/TCP
Endpoints: 10.244.2.2:80targetPort corect:
kubectl patch svc catalog -p '{"spec":{"ports":[{"port":80,"targetPort":8080}]}}'
kubectl exec test -- wget -qO- -T 2 http://catalog | head -3service/catalog patched
Magazin Academia v1 | pod: catalog-pxbmtcghmw-bgc55De ce merge
Serviciul trimitea traficul pe portul 80 al podurilor, unde nu ascultă nimic, deci conexiunea era refuzată. Cu targetPort: 8080, serviciul ajunge la aplicație, iar clienții folosesc în continuare http://catalog pe portul 80. Nicio altă configurare a clienților nu trebuie schimbată.
Alte forme ale mesajului
curl: (7) Failed to connect to magazin port 80 after 2 ms: Couldn't connect to serverwget: can't connect to remote host (10.96.0.15): Connection refused
Cum o eviți pe viitor
- Folosește porturi cu nume (
targetPort: http) ca serviciul să urmeze portul declarat în container. - Verifică
kubectl get endpointsimediat după ce creezi un serviciu. - Testează din cluster cu un pod busybox înainte să adaugi Ingress-ul.
- Configurează aplicațiile să asculte pe
0.0.0.0, nu pe127.0.0.1.
Întrebări frecvente
De ce DNS-ul merge, dar conexiunea nu?
Pentru că DNS-ul rezolvă doar numele serviciului în ClusterIP. Dacă în spatele lui nu ascultă nimic pe portul corect, conexiunea e refuzată.
Cum văd pe ce port ascultă containerul?
kubectl get pod POD -o jsonpath='{.spec.containers[0].ports}' arată porturile declarate. Documentația imaginii spune portul real.
Erori înrudite
Endpoints: <none> Serviciul nu are niciun pod în spate: selectorul lui nu se potrivește cu etichetele podurilor sau podurile nu sunt Ready. Compară selectorul (kubectl describe svc) cu etichetele (kubectl get pods --show-labels) și corectează-l. wget: bad address 'catalog-api' Numele cerut nu există în DNS-ul clusterului: nu există niciun serviciu cu acest nume în namespace-ul podului. Creează serviciul (kubectl expose) sau folosește numele exact al serviciului existent. 502 Bad Gateway Controllerul de Ingress a găsit podurile, dar conexiunea la ele a eșuat: de obicei targetPort-ul serviciului nu e portul aplicației, sau aplicația cade în timpul cererii. Corectează targetPort-ul și verifică jurnalele podurilor. Învață Kubernetes de la zero, cu exerciții la fiecare lecție
Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.
