如何在Kubernetes Nginx Ingress或Istio中实现基于远程IP的SSL证书选择
Kubernetes Nginx Ingress 实现方案
Nginx Ingress 完整封装了原生Nginx的 ngx_http_geo_module、map 模块能力,不需要自定义编译镜像,可直接复刻原生Nginx基于远程访问地址选择SSL证书的逻辑,具体实现路径有两种:
- 路径1:完全复刻原生Nginx的变量拼接逻辑
- 在Nginx Ingress Controller对应的全局ConfigMap中,将geo规则填写到
http-snippet字段下(会注入到Nginx配置的http块层级,和原生Nginx的配置位置完全一致),把不同客户端网段映射为不同的命名变量,比如把公网网段映射为$client_network = public_ca、合规专网网段映射为$client_network = compliance_ca、内网网段映射为$client_network = internal_ca。 - 将不同CA对应的证书、密钥以Secret形式挂载到Controller的固定可读目录下(比如
/etc/custom-ssl-certs/),挂载时通过subPath让每个证书对应的目录名称和geo生成的变量值一一对应,目录内提前放好对应签发的tls.crt、tls.key文件,保证Nginx进程有读取权限。 - 通过ConfigMap的
ssl-snippet字段注入全局SSL配置,替换默认的证书路径引用逻辑,用变量拼接的方式指定SSL证书路径,示例配置:
这段配置会被注入到所有HTTPS虚拟Server的SSL配置块中,优先于Ingress自动生成的证书路径配置生效。ssl_certificate /etc/custom-ssl-certs/$client_network/tls.crt; ssl_certificate_key /etc/custom-ssl-certs/$client_network/tls.key;
- 在Nginx Ingress Controller对应的全局ConfigMap中,将geo规则填写到
- 路径2:轻量化拆分路由绑定证书
如果不想手动处理证书文件挂载、权限配置,可以基于geo生成的源IP变量,把不同网络来源的流量引导到独立的虚拟Server块,每个虚拟Server块对应一个独立的Ingress资源,通过Ingress的tls.secretName字段直接绑定对应CA的证书。这种方式完全沿用Ingress生态的证书管理逻辑,不需要处理自定义文件的权限问题。
Istio 实现方案
Istio 基于Envoy代理,原生支持基于源IP的TLS凭证匹配,配置门槛比Nginx Ingress更低,具体实现方式:
- 原生能力实现(Istio 1.11+版本)
Istio 从1.11版本开始,在Gateway的TLS配置层面内置了源IP匹配能力,不需要修改底层Envoy配置:- 提前把不同CA对应的证书存为独立的Kubernetes Secret,比如公网CA证书对应
public-ca-secret、合规专网CA对应compliance-ca-secret、内网CA对应internal-ca-secret。 - 在同一个Gateway资源下,为443端口配置多个Server块,每个块通过
sourceCidr字段指定匹配的客户端网段,绑定对应CA的证书,示例配置:apiVersion: networking.istio.io/v1alpha3 kind: Gateway metadata: name: dynamic-tls-gateway spec: selector: istio: ingressgateway servers: # 内网源流量优先匹配,绑定内网CA证书 - port: number: 443 name: https-internal protocol: HTTPS hosts: ["your-domain.com"] tls: mode: SIMPLE credentialName: internal-ca-secret match: - sourceCidr: ["192.168.0.0/16", "100.64.0.0/10"] # 合规专网流量匹配,绑定合规CA证书 - port: number: 443 name: https-compliance protocol: HTTPS hosts: ["your-domain.com"] tls: mode: SIMPLE credentialName: compliance-ca-secret match: - sourceCidr: ["10.0.0.0/8", "172.16.0.0/12"] # 兜底匹配公网流量,绑定公网CA证书 - port: number: 443 name: https-public protocol: HTTPS hosts: ["your-domain.com"] tls: mode: SIMPLE credentialName: public-ca-secret match: - sourceCidr: ["0.0.0.0/0"] - 注意规则顺序:Istio的匹配规则是按从上到下的顺序生效的,一定要把网段范围最小的规则放在最上面,大段的兜底规则(比如0.0.0.0/0)放在最后,避免覆盖前面的细分匹配。
- 提前把不同CA对应的证书存为独立的Kubernetes Secret,比如公网CA证书对应
- 老版本兼容方案(Istio <1.11版本)
如果使用的Istio版本没有内置的sourceCidr匹配能力,可以通过EnvoyFilter自定义TLS筛选逻辑,基于客户端源IP设置动态路由元数据,匹配对应的证书路径,实现逻辑和Nginx Ingress的geo变量方案一致。
通用配置注意事项
- 所有源IP匹配的规则生效前提,是前置的云负载均衡、上层代理已经正确开启了真实客户端IP透传(比如配置X-Forwarded-For、Proxy Protocol),不然Controller/代理拿到的源IP是上层LB的地址,会导致所有流量都匹配到默认证书。
- 要给Nginx Ingress Controller、Istio IngressGateway的ServiceAccount配置对应的Secret读取权限,避免因权限不足拉取不到证书。
- 配置完成后需要用对应网段的测试客户端发起TLS握手,校验返回的证书是否为对应CA签发,避免因为配置顺序错误、路径不匹配导致TLS握手失败。
内容的提问来源于stack exchange,提问作者Pit Wegner
相关产品推荐
相关产品推荐

