首页/云/Kubernetes 速查/ingress-nginx 控制器全局配置
本包目录(307 条)
kubectl 基础56 条工作负载36 条
网络与服务55 条
配置与存储54 条调度与资源52 条集群运维与排障54 条

ingress-nginx 控制器全局配置

控制器的 ConfigMap 里配置全局参数(请求体上限、SSL 协议、可信代理 IP 等),影响该控制器下所有 Ingress,改动需谨慎评审。

Kubernetes 速查云更新于 2026-10-12

查看与修改

查看与修改
kubectl -n ingress-nginx get cm ingress-nginx-controller -o yaml
kubectl -n ingress-nginx edit cm ingress-nginx-controller
kubectl -n ingress-nginx rollout restart deploy/ingress-nginx-controller

常用键(示例)

常用键(示例)
data:
  client-max-body-size: "50m"
  ssl-protocols: "TLSv1.2 TLSv1.3"
  use-forwarded-headers: "true"
  proxy-real-ip-cidr: "10.0.0.0/8"
全局键与 Ingress 级注解同名时注解优先;改完全局配置对该控制器所有站点生效。

易错点

  • 改 ConfigMap 不会自动重载:需要重启/重载控制器 Pod 才生效
  • 把不安全协议加回 ssl-protocols 会拉低整体安全基线,变更要走评审

数据来源与参考

  • ingress-nginx 官方文档 · ConfigMap
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌