如何用本地命令查看Kubernetes Nginx Ingress控制器支持的注解？

首先要明确：你遇到的前缀差异是因为两个不同的Nginx Ingress控制器：

• Kubernetes社区维护的版本（通常叫ingress-nginx）：使用nginx.ingress.kubernetes.io/前缀注解
• NGINX官方维护的版本（nginx-ingress-controller）：使用nginx.org/前缀注解

针对官方版本的控制器，以下是几个本地查看支持注解的方法：

1. 运行控制器容器查看内置帮助 #

直接拉取对应版本的控制器镜像，运行帮助命令过滤注解相关内容：

docker run --rm nginx/nginx-ingress:latest nginx-ingress-controller --help | grep -i annotation

如果需要更详细的说明，可以去掉grep，查看完整的帮助文档，里面会列出所有支持的注解及用途。

2. 通过Helm Chart查看配置（若用Helm安装） #

如果是用Helm部署的控制器，直接查看Chart的values文件，里面会标注支持的注解和对应的配置逻辑：

helm show values nginx-stable/nginx-ingress | grep -A 3 -B 3 annotation

这种方法能直观看到注解与控制器配置的关联。

3. 查看控制器Pod的启动参数或日志 #

进入运行中的控制器Pod，查看启动时的参数说明，或者检查日志中的初始化信息：

kubectl exec -it <nginx-ingress-controller-pod-name> -n <namespace> -- nginx-ingress-controller --help

部分控制器会在启动日志中打印支持的核心注解列表，也可以通过kubectl logs <pod-name> -n <namespace>查看。

补充：社区版控制器的本地查看方法 #

如果你实际使用的是Kubernetes社区版ingress-nginx，可以通过以下命令查看：

kubectl exec -it <ingress-nginx-controller-pod-name> -n <namespace> -- /nginx-ingress-controller --help | grep -i annotation

或者查看其Pod内/usr/share/doc/nginx-ingress目录下的本地文档文件。

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