如何通过更新Ingress配置隐藏K8s中Nginx版本信息

问题根源排查 #

你遇到的server-tokens注解不生效，大概率是两个原因：

1. Ingress资源配置不完整：缺少spec.ingressClassName: nginx，导致ingress-nginx控制器未识别并处理该Ingress，注解完全没起作用。
2. 全局配置优先级覆盖：部分版本中，控制器的全局ConfigMap配置优先级高于单个Ingress的注解，若全局未关闭server tokens，注解会被忽略。

可行解决方案 #

方案1：修复现有Ingress资源配置 #

编辑你的Ingress YAML，补充必要的ingressClassName和路由规则，确保控制器能识别并应用注解：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/server-tokens: "off"
  name: your-ingress-name
  namespace: your-app-namespace
spec:
  ingressClassName: nginx  # 必须匹配ingress-nginx控制器的IngressClass
  rules:
  - host: mysite.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: your-service-name
            port:
              number: 80  # 替换为你的应用服务端口

应用配置：

kubectl apply -f your-ingress.yaml

验证：等待30秒后执行curl -IL mysite.com，Server头应变为nginx（无版本号）。

方案2：全局关闭Server版本号（kubectl方式） #

如果方案1无效，直接修改控制器的全局ConfigMap，确保所有Ingress都生效：

1. 编辑ingress-nginx控制器的ConfigMap：

kubectl edit configmap ingress-nginx-controller -n ingress-nginx

2. 在data块中添加或修改配置：

server-tokens: "off"

3. 重启控制器Pod加载新配置：

kubectl rollout restart deployment ingress-nginx-controller -n ingress-nginx

4. 再次验证curl -IL mysite.com。

方案3：改用Helm管理Ingress-Nginx（满足helm update需求） #

若后续想更便捷地管理配置，可卸载现有静态部署的控制器，改用Helm安装：

1. 卸载现有控制器：

kubectl delete -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v0.47.0/deploy/static/provider/baremetal/deploy.yaml

2. 添加Helm仓库并安装指定版本：

helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update
helm install ingress-nginx ingress-nginx/ingress-nginx \
  --namespace ingress-nginx \
  --create-namespace \
  --set controller.config.server-tokens="off" \
  --version v0.47.0

3. 后续更新配置只需执行：

helm upgrade ingress-nginx ingress-nginx/ingress-nginx \
  --namespace ingress-nginx \
  --set controller.config.server-tokens="off"

进阶：完全隐藏Server响应头 #

如果需要彻底移除Server头（而非仅去掉版本号），可在Ingress注解中添加：

nginx.ingress.kubernetes.io/configuration-snippet: |
  more_clear_headers Server;

该配置依赖ingress-nginx默认启用的more_clear_headers模块，无需额外安装组件。

内容的提问来源于stack exchange，提问作者Carlos Petros