如何让K8s Ingress匹配NGINX负载均衡器传递的Host头？

以下是针对该问题的具体排查和解决步骤：

一、确认外部NGINX的请求头转发配置 #

确保外部NGINX不仅传递Host头，同时配置X-Forwarded-Host辅助头，部分Ingress Controller会优先读取这个头来匹配规则。示例配置如下：

server {
    listen 80;
    server_name your-public-domain.com;

    location / {
        proxy_pass http://your-ingress-cluster-entrypoint;
        # 传递原始请求的Host头
        proxy_set_header Host $host;
        # 补充X-Forwarded-Host供Ingress识别
        proxy_set_header X-Forwarded-Host $host;
        # 其他必要的转发头，保证链路信息完整
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

注意：$host变量会优先取请求的原始Host头，若请求无Host则使用server_name，需确保其值与Ingress规则中配置的主机名完全一致。

二、配置Ingress Controller保留原始Host头 #

如果使用的是官方NGINX Ingress Controller，默认会用Ingress资源中配置的host覆盖请求头，需修改控制器配置开启保留原始Host的功能：

1. 修改ConfigMap：

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: nginx-ingress-controller
     namespace: ingress-nginx
   data:
     use-forwarded-headers: "true"
     preserve-host: "true"
   

2. 添加启动参数（在Ingress Controller的Deployment中）：

   args:
     - /nginx-ingress-controller
     - --publish-service=$(POD_NAMESPACE)/ingress-nginx-controller
     - --election-id=ingress-controller-leader
     - --controller-class=k8s.io/ingress-nginx
     - --ingress-class=nginx
     - --configmap=$(POD_NAMESPACE)/nginx-ingress-controller
     - --preserve-host=true
     - --use-forwarded-headers=true
   

修改完成后重启Ingress Controller Pod使配置生效。

三、核对Ingress资源的主机规则 #

确保Ingress资源中spec.rules[*].host的值与外部NGINX传递的Host头完全匹配，包括大小写、通配符格式（如需）。示例Ingress配置：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-service-ingress
spec:
  rules:
  - host: your-public-domain.com  # 必须与外部传递的Host头完全一致
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: your-internal-service
            port:
              number: 80

四、验证请求头传递情况 #

可以在集群内部服务中打印请求头，确认Host和X-Forwarded-Host是否正确传递。比如用一个简单的测试Nginx服务：

server {
    listen 80;
    location / {
        return 200 "Host: $host\nX-Forwarded-Host: $http_x_forwarded_host\n";
    }
}

访问公网地址后查看返回内容，确认头信息是否符合预期。

内容的提问来源于stack exchange，提问作者Yash patel