You need to enable JavaScript to run this app. K8S使用NGINX Ingress访问API返回Connection Refused问题排查
优惠活动
大模型
产品
解决方案
定价
更多

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错误。
  • 无影响的报错说明
    你在Ingress详情里看到的default-http-backend not found报错,不会导致连接被拒绝,只是代表当请求没有匹配到任何Ingress规则时,没有默认后端返回404页面,不影响核心转发功能。

落地修复步骤

  1. 编辑NGINX Ingress Controller的Service,将类型改为LoadBalancer:
kubectl edit svc -n ingress-nginx ingress-nginx-controller
# 修改spec.type字段值为LoadBalancer,保存退出
  1. 等待1-2分钟,查看Service分配的EXTERNAL-IP(即MetalLB分配的VIP):
kubectl get svc -n ingress-nginx
  1. 将域名k8s.domain.com的A记录解析到这个EXTERNAL-IP,替代原来指向节点IP 192.168.0.17的配置。
  2. 重新应用正确的Ingress配置,确认Host、后端服务名、端口和实际部署的API服务完全匹配。

内容的提问来源于stack exchange,提问作者Enin Kaduk

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.19 09:36:04