Ingress-nginx 的全局配置需通过 Kubernetes 中的 ConfigMap 资源实现。通过修改对应 ConfigMap 的配置,可对集群内所有 Ingress 规则生效的 Nginx 参数进行统一管控,适用于需全局标准化配置的场景(如统一日志级别、全局请求大小限制等)。

一、配置示例:全局修改日志与请求大小参数

本示例将演示通过 ConfigMap 实现三项全局配置:修改 Nginx 日志级别、禁止访问日志输出、设置全局最大请求正文大小。

步骤 1:进入目标 ConfigMap 配置页面

按照以下路径导航至 Ingress-nginx 对应的 ConfigMap 配置界面:
「配置中心」>「配置」> 找到名称为ingress-nginx-controller的 ConfigMap(此为Ingress-nginx全局配置的默认 ConfigMap 名称),点击进入配置编辑页面。
ConfigMap 查找示意图:

步骤 2:添加/修改全局配置参数

在 ConfigMap 的配置编辑区域,添加以下全局配置项(根据实际需求调整参数值):
配置添加示意图:

重要注意事项:ConfigMap 中的 key 和 value 均只能为字符串类型。若需配置布尔值(如 true/false)或数值(如 100、50m),必须用引号将其包裹,示例:”true”、”false”、”50m”,否则配置会失效。

步骤 3:提交配置并生效

完成配置参数添加后,保存并提交 ConfigMap 的修改。
关键说明:通过 ConfigMap 进行的配置修改为全局生效,将作用于集群内所有通过 Ingress-nginx 转发的流量对应的 Nginx 服务,无需重启 Ingress-nginx 组件,配置提交后会自动同步生效。

二、验证全局配置生效情况

配置提交后,可通过查看 Ingress-nginx 底层 Nginx 的配置文件,验证全局配置是否已生效。
底层 Nginx 配置变化示意图:

从示意图中可清晰看到,新增的全局配置已成功同步到底层 Nginx 配置中,说明全局配置生效。

三、更多全局配置参考

关于 Ingress-nginx 支持的所有全局 ConfigMap 配置项(如连接超时时间、负载均衡算法、HTTPS 相关全局配置等),可参考官方文档:https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap

作者:admin  创建时间:2023-12-11 15:22
最后编辑:吴升斌  更新时间:2026-01-30 18:08