如何利用 Kubernetes Ingress 控制器底层 Nginx 机制配置全局统一下发的 TLS 安全策略

酷雪姑娘_7169

酷雪姑娘_7169

2026-06-22

155人浏览

原创

kubernetes ingress控制器可通过configmap统一配置tls策略:启用ssl-redirect、force-ssl-redirect实现http强制跳转https;设置ssl-protocols、ssl-ciphers锁定协议与密码套件;配置hsts开启严格传输安全;通过default-ssl-certificate指定默认证书secret,避免ingress中重复配置。

如何利用 kubernetes ingress 控制器底层 nginx 机制配置全局统一下发的 tls 安全策略

要让 Kubernetes Ingress 控制器(以 ingress-nginx 为例)实现全局统一下发的 TLS 安全策略,关键不是在每个 Ingress 资源里重复配置证书或重定向,而是通过控制器自身的 ConfigMap 和默认 SSL 设置,把 TLS 行为“下沉”到 Nginx 层统一管控。这样既能避免配置碎片化,又能确保所有 HTTPS 流量遵循一致的加密强度、协议版本和重定向逻辑。

修改 ingress-nginx 的全局 ConfigMap 启用强制 HTTPS 和 TLS 策略

ingress-nginx 控制器启动时会读取名为 nginx-configuration(通常位于 kube-system 命名空间)的 ConfigMap,其中的键值对直接映射为 Nginx 配置指令。你需要更新它来开启并固化 TLS 行为:

  • 启用全局 HTTPS 重定向:设置 ssl-redirect: "true" 和 force-ssl-redirect: "true",让所有匹配该 Ingress Controller 的 HTTP 请求自动 308 跳转到 HTTPS
  • 锁定 TLS 协议与密码套件:添加 ssl-protocols: "TLSv1.2 TLSv1.3" 和 ssl-ciphers: "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256...(推荐现代强密码)",禁用 TLS 1.0/1.1
  • 启用 HSTS(HTTP Strict Transport Security):加入 hsts: "true" 和 hsts-max-age: "31536000",强制浏览器后续访问只走 HTTPS

更新后执行 kubectl rollout restart deploy -n kube-system ingress-nginx-controller 使配置生效。

为所有 Ingress 统一指定默认 TLS Secret(免逐个配置)

如果你有多个域名共用同一张通配符证书或组织级证书,可以跳过在每个 Ingress 中写 tls[].secretName,改用控制器的 default SSL certificate 机制:

Kubernetes Network Policy Generator
Kubernetes Network Policy Generator

使用加权评分卡在12项标准上评估和比较隐私解决方案供应商。适用于选择隐私管理软件、比较数据保护方案等场景。

下载
  • 先将证书和私钥创建为 Secret,例如:kubectl create secret tls default-tls-secret --cert=tls.crt --key=tls.key -n kube-system
  • 在 ConfigMap 中添加字段:ssl-default-backend: "default-tls-secret"(注意:实际字段名是 default-ssl-certificate,值格式为 <namespace>/<secret-name></secret-name></namespace>,如 kube-system/default-tls-secret)
  • 这样,任何未显式声明 tls 块的 Ingress,只要其 host 匹配该证书的 SAN 或 CN,就会自动启用该证书提供 HTTPS 服务

集中管理多域名证书并按需分发

当业务涉及多个子域(如 api.example.com、app.example.com),又不想为每个都建独立 Secret,可采用以下方式提升可维护性:

  • 将多域名证书(含完整 SAN 列表)统一存入一个命名空间(如 certs)下的 Secret,例如 multi-domain-tls
  • 在各业务命名空间的 Ingress 中,通过跨命名空间引用方式使用:tls[0].secretName: multi-domain-tls + tls[0].namespace: certs(需确认你的 ingress-nginx 版本 ≥ v1.3.0 支持此语法)
  • 配合 Cert-Manager 的 ClusterIssuer 自动签发,并将生成的 Secret 同步至 certs 命名空间,实现证书生命周期全自动

验证与观测 TLS 策略是否真正生效

配置完成后不能仅依赖 Ingress 状态,需从 Nginx 实例内部验证实际加载的配置:

  • 进入任一 ingress-nginx Pod:kubectl exec -it -n kube-system deploy/ingress-nginx-controller -- cat /etc/nginx/nginx.conf | grep -A5 -B5 ssl_,确认 ssl_protocols、ssl_ciphers、return 308 等指令已写入
  • 用 openssl s_client -connect example.com:443 -tls1_1 测试是否被拒绝,再用 -tls1_2 验证是否成功握手
  • 访问 HTTP 地址,检查响应头是否含 Strict-Transport-Security,且返回状态码为 308 Permanent Redirect

不复杂但容易忽略的是:ConfigMap 修改后必须重启控制器 Pod;跨命名空间引用 Secret 需对应 Ingress Controller 版本支持;而默认证书仅对未定义 tls 块的 Ingress 生效——若已有 Ingress 显式写了 secretName,它仍会优先使用自己的配置。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

383

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3287

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

5965

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

561

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1476

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3938

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

122

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

437

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

159

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习