基于Traefik的Kubernetes Ingress按规则添加自定义请求头

嘿，这个场景我太懂了——3000+个Ingress资源不仅创建起来麻烦，后续维护更是噩梦。给你几个基于Traefik特性的优雅解决方案，不用再一个个造Ingress：

方案1：用Traefik Middleware结合动态变量（适合头值可从Host提取的场景） #

如果你的自定义请求头值可以从请求Host中提取（比如Host是site1.example.com，头是X-Site: site1），那这个方案最省心，只需要1个Ingress + 1个Middleware就能搞定所有Host。

首先创建一个Traefik Middleware，利用Traefik的模板变量和正则捕获来动态生成请求头：

apiVersion: traefik.containo.us/v1alpha1
kind: Middleware
metadata:
  name: dynamic-site-header
spec:
  headers:
    customRequestHeaders:
      # 用正则捕获Host里的站点标识，替换到请求头中
      X-Site-Identifier: "{{ regexpCapture `^([a-z0-9-]+)\.your-domain\.com$` .Request.Host 1 }}"

然后创建一个通配符Ingress，关联这个Middleware：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: multi-site-ingress
  annotations:
    traefik.ingress.kubernetes.io/router.middlewares: default-dynamic-site-header@kubernetescrd
spec:
  rules:
    - host: "*.your-domain.com"
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: your-backend-service
                port:
                  number: 80

这样所有匹配*.your-domain.com的请求，都会自动带上根据Host生成的自定义请求头，完全不用为每个站点单独配置。

方案2：用Traefik IngressRoute + 批量生成资源（适合头值独立的场景） #

如果每个站点的请求头值是完全独立的（比如site1对应X-Header: foo，site2对应X-Header: bar），可以用Traefik的IngressRoute自定义资源——它支持在单个资源里定义多个路由规则，比原生Ingress灵活太多。

首先，你可以为每个站点创建对应的Middleware：

apiVersion: traefik.containo.us/v1alpha1
kind: Middleware
metadata:
  name: add-header-site1
spec:
  headers:
    customRequestHeaders:
      X-Custom-Header: "Value-for-site1"
---
apiVersion: traefik.containo.us/v1alpha1
kind: Middleware
metadata:
  name: add-header-site2
spec:
  headers:
    customRequestHeaders:
      X-Custom-Header: "Value-for-site2"

然后在一个IngressRoute里批量添加路由规则：

apiVersion: traefik.containo.us/v1alpha1
kind: IngressRoute
metadata:
  name: multi-site-route
spec:
  entryPoints:
    - web
  routes:
    - match: Host(`site1.your-domain.com`)
      kind: Rule
      middlewares:
        - name: add-header-site1
      services:
        - name: your-backend-service
          port: 80
    - match: Host(`site2.your-domain.com`)
      kind: Rule
      middlewares:
        - name: add-header-site2
      services:
        - name: your-backend-service
          port: 80
    # 继续添加更多站点的规则...

当然，手动写3000个规则不现实，你可以用Kustomize生成器、Helm模板或者简单的Python/Shell脚本批量生成这些资源YAML，比维护3000个独立Ingress要轻松得多。

方案3：用Traefik File Provider（适合批量静态映射场景） #

如果你的站点和请求头的映射关系是固定的静态数据，还可以用Traefik的File Provider来配置路由——把所有路由规则写到一个配置文件里，通过ConfigMap挂载到Traefik Pod中。

比如创建一个ConfigMap：

apiVersion: v1
kind: ConfigMap
metadata:
  name: traefik-file-config
data:
  routes.toml: |
    [[http.routers]]
      entryPoints = ["web"]
      rule = "Host(`site1.your-domain.com`)"
      middlewares = ["add-header-site1"]
      # 关联K8s中的后端服务
      service = "your-backend-service@kubernetes"

    [[http.routers]]
      entryPoints = ["web"]
      rule = "Host(`site2.your-domain.com`)"
      middlewares = ["add-header-site2"]
      service = "your-backend-service@kubernetes"

    [[http.middlewares]]
      [http.middlewares.add-header-site1.headers]
        customRequestHeaders = { X-Custom-Header = "Value-for-site1" }

    [[http.middlewares]]
      [http.middlewares.add-header-site2.headers]
        customRequestHeaders = { X-Custom-Header = "Value-for-site2" }

然后修改Traefik的Deployment，挂载这个ConfigMap到Traefik的配置目录（比如/etc/traefik/config/），让Traefik加载这个文件配置。后续更新只需要修改ConfigMap，不用操作成百上千个K8s资源。

注意事项 #

• 确保你的Traefik版本是v2.x及以上，上述特性都是从v2开始支持的
• 用正则匹配Host时，尽量简化正则表达式，避免影响Traefik的路由性能
• 批量生成资源时，优先用模板工具（比如Helm、Kustomize），比手动编写更易维护

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