K8S使用NGINX Ingress访问API返回Connection Refused问题排查
问题根因与修复方案
Connection Refused 属于TCP握手阶段的网络层拒绝,和Ingress规则匹配、后端服务可用性没有关系。如果是Ingress配置错误、后端服务不通,请求会成功连接到Ingress进程后,返回404、502、503这类HTTP状态码,不会直接在连接建立阶段就被拒绝。
- 核心问题本质
你当前访问的目标IP 192.168.0.17的80端口上,没有任何进程监听,所以内核会直接拒绝所有发往这个地址:端口的请求。Kubespray默认部署的NGINX Ingress环境,90%的这类报错都来自这个原因。 - 优先级最高的排查动作
先执行命令查看NGINX Ingress Controller的Service配置:kubectl get svc -n ingress-nginx
默认安装的Ingress Controller Service大多是ClusterIP类型,既没有绑定MetalLB的LoadBalancer地址,也没有在节点上开放80/443对应的NodePort端口。
你已经配置了MetalLB Layer2模式,正确的暴露方式是把Ingress Controller对应的Service修改为LoadBalancer类型,MetalLB会自动从你配置的地址池里分配一个独立的VIP(属于192.168.0.0/24网段,不会复用节点本身的IP),这个VIP才会正常监听80/443端口。
如果你想直接用节点IP访问,需要确认Ingress Controller的Service是NodePort类型,此时80/443端口会映射到节点30000-32767范围的随机端口,必须用节点IP:NodePort的形式访问,直接访问节点的80端口是永远不会通的。 - 快速验证方法
在发起curl请求的机器上执行命令:telnet 192.168.0.17 80
如果命令直接返回连接失败,就可以完全确认80端口无监听的问题。 - 待修正的配置不一致问题(端口通了之后处理)
你贴出的Ingress YAML和集群中实际运行的Ingress规则完全不匹配:- YAML定义的Host为
k8s.customhostname.com,但集群实际生效的Ingress规则Host为k8s.domain.com - YAML绑定的后端服务为
svc-api,但集群实际的后端指向是svc-smouapimapes
说明你目前应用的Ingress配置根本不是你贴出的YAML内容,等端口监听问题解决后,需要重新把正确的Ingress配置应用到集群,避免后续出现404错误。
- YAML定义的Host为
- 无影响的报错说明
你在Ingress详情里看到的default-http-backend not found报错,不会导致连接被拒绝,只是代表当请求没有匹配到任何Ingress规则时,没有默认后端返回404页面,不影响核心转发功能。
落地修复步骤
- 编辑NGINX Ingress Controller的Service,将类型改为LoadBalancer:
kubectl edit svc -n ingress-nginx ingress-nginx-controller # 修改spec.type字段值为LoadBalancer,保存退出
- 等待1-2分钟,查看Service分配的EXTERNAL-IP(即MetalLB分配的VIP):
kubectl get svc -n ingress-nginx
- 将域名
k8s.domain.com的A记录解析到这个EXTERNAL-IP,替代原来指向节点IP 192.168.0.17的配置。 - 重新应用正确的Ingress配置,确认Host、后端服务名、端口和实际部署的API服务完全匹配。
内容的提问来源于stack exchange,提问作者Enin Kaduk
相关产品推荐
相关产品推荐

