如何在ingress-nginx控制器中针对特定Ingress资源使用Lua插件？

云原生阿岚

2026-7-10

Ingress-Nginx Lua插件：全局生效与按需启用配置

当前配置会让所有请求经过插件

你现在在ingress-nginx的全局ConfigMap里设置了plugins: auth-lua，这属于全局启用——所有经过这个ingress-nginx实例的请求，都会触发这个Lua插件的逻辑。

是否需要在Ingress资源中配置？

全局启用模式下不需要额外配置；但如果要实现仅部分Ingress使用插件，必须先调整全局配置，再在目标Ingress上添加对应注解。

实现部分Ingress启用插件的步骤

取消全局插件自动生效
编辑ingress-nginx的全局ConfigMap，删掉plugins: auth-lua这一行，然后重启ingress-nginx Deployment。此时插件仍然挂载在nginx容器里，但不会主动对任何请求生效。

给目标Ingress添加启用注解
针对需要启用认证的Ingress资源，添加nginx.ingress.kubernetes.io/configuration-snippet注解，指定在请求的access阶段执行你的Lua脚本：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: your-target-ingress
  annotations:
    nginx.ingress.kubernetes.io/configuration-snippet: |
      access_by_lua_file /etc/nginx/lua/plugins/auth-lua/main.lua;
spec:
  rules:
    - host: your-domain.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: your-backend-service
                port:
                  number: 80

这样只有这个Ingress对应的请求会走你的认证逻辑，其他Ingress的请求完全不受影响。