Kubernetes用Traefik作Ingress时所有插件均报unknown plugin type错误

问题现象 #

在Kubernetes环境使用Traefik作为Ingress控制器时，所有插件均无法正常使用，无插件下载日志，触发路由时出现以下错误：

time="2023-05-18T02:01:32Z" level=error msg="plugin: unknown plugin type: plugin-blockpath" routerName=dev1-api-gateway-dev1-api-gateway-dev-company-com@kubernetes entryPointName=websecure

相关配置 #

静态配置（Helm Values） #

values:
  ingressClass:
    enabled: true
    isDefaultClass: true
  ingressRoute:
    dashboard:
      enabled: false
  service:
    annotations:
      service.beta.kubernetes.io/aws-load-balancer-type: nlb
  providers:
    kubernetesCRD:
      enabled: true
    kubernetesIngress:
      enabled: true
      publishedService:
        enabled: true
  ports:
    websecure:
      tls:
        enabled: true
    web:
      redirectTo: websecure
  experimental:
    plugins:
      plugin-blockpath:
        moduleName: "github.com/traefik/plugin-blockpath"
        version: "v0.2.1"

动态配置（Middleware CRD） #

apiVersion: traefik.containo.us/v1alpha1
kind: Middleware
metadata:
  name: blockpath-health
spec:
  plugin:
    plugin-blockpath:
      Regex:
        - ^/actuator/health(.*)

Ingress注解配置 #

traefik.ingress.kubernetes.io/router.middlewares: flux-system-blockpath-health@kubernetescrd

解决步骤 #

• 确认版本兼容性：实验性插件仅支持Traefik v2.3及以上版本，检查当前Traefik版本是否与plugin-blockpath v0.2.1兼容。
• 验证静态配置传递：检查Traefik Pod的实际配置文件，确认experimental.plugins定义已正确加载：

  kubectl exec -n <traefik-namespace> <traefik-pod-name> -- cat /etc/traefik/traefik.yaml | grep -A5 experimental
  

• 检查网络访问权限：Traefik Pod需要访问GitHub下载插件，验证Pod的外网连通性：

  kubectl exec -n <traefik-namespace> <traefik-pod-name> -- curl -I https://github.com/traefik/plugin-blockpath/archive/refs/tags/v0.2.1.tar.gz
  

  若集群有网络策略，需允许Traefik Pod出站访问443端口。
• 确保插件名称完全匹配：静态配置中插件的键名（plugin-blockpath）必须和Middleware配置里的插件名称完全一致，包括大小写。
• 重新部署Traefik：修改静态配置后，重新部署使配置生效，并查看日志确认插件下载情况：

  helm upgrade traefik traefik/traefik -n <traefik-namespace> -f your-values.yaml
  kubectl logs -n <traefik-namespace> <traefik-pod-name> | grep plugin
  

• 验证Middleware引用正确性：确认注解中的Middleware存在于指定命名空间（flux-system）：

  kubectl get middleware -n flux-system blockpath-health
  

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