适用范围：腾讯云容器服务（Tencent Kubernetes Engine ，TKE）, 以下简称 TKE。
为什么需要获取客户端真实源 IP？当需要能感知到服务请求来源去满足一些业务需求时，就需要后端服务能准确获取到请求客户端的真实源 IP， 比如以下场景：
对服务请求的来源有做审计的需求，如异地登陆告警。
针对安全攻击或安全事件溯源需求，如 APT 攻击、DDoS 攻击等。
业务场景数据分析需求，如业务请求区域统计。
其他需要获取客户端地址的需求。
在 TKE 使用场景下如何获取客户端真实源 IP？在TKE中默认的外部负载均衡器是 腾讯云负载均衡器，作为服务流量的访问首入口，腾讯云负载均衡器会将请求流量负载转发到 Kubernetes 工作节点的 Kubernets Service（默认），此负载均衡过程会保留客户端真实源 IP（透传转发），但在 Kubernetes Service 转发场景下，无论是使用 iptbales 还是 ipvs 的负载均衡转发模式，转发时都会对数据包做 SNAT，即不会保留客户端真实源 IP，为了能够准确的获取到客户端的真实源 IP，在 TKE 使用场景下，主要有四种方法获取客户端真实源 IP，下面将逐个展开介绍下。
一、通过 Service 资源的配置选项保留客户端源 IP要启用保留客户端 IP 功能，可在 Service 资源中配置字段 Service.spec.externalTrafficPolicy，此字段表示服务是否希望将外部流量路由到节点本地或集群范围的端点。有两个选项值：Cluster（默认）和 Local 方式，如下图所示：
Cluster 表示隐藏了客户端源 IP， LoadBalancer 和 NodePort 类型服务流量可能会被转发到其他节点的 Pods； Local 表示保留客户端源 IP 并避免 LoadBalancer 和 NodePort 类型的服务流量转发到其他节点的 Pods，详情请参考 kubernets设置外部负载均衡器说明。相关 YAML 配置示例如下：
apiVersion: v1 kind: Service metadata: name: example-Service spec: selector: app: example-Service ports: - port: 8765 targetPort: 9376 externalTrafficPolicy: Local type: LoadBalancer优点：只需要修改 Kubernets Service 资源配置即可。
缺点：会存在潜在的 Pods（Endpoints）流量负载不均衡风险。
二、通过TKE原生的 CLB 直通 Pod 转发模式获取使用TKE原生支持的 CLB 直通 Pod 的转发功能（CLB 透传转发，并绕过 Kubernetes Service 流量转发），后端 Pods 收到的请求的源IP即是客户端真实源IP，此方式无论是在四层还是七层服务的转发场景下都适用，转发原理如下图：
详细介绍和配置请参考文档 TKE场景下腾讯云CLB直通Pod使用场景介绍。
优点：TKE原生支持的功能特性，只需在控制台按照文档配置即可。
缺点：集群需要开启 VPC-CNI 模式网络，详情参考文档 VPC-CNI 模式说明
三、通过 HTTP Header 获取在七层（HTTP/HTTPS）服务转发场景下，可以通过获取 Http Header 中 X-Forwarded-For 和 X-Real-IP 字段的值来获取客户端真实源 IP， TKE 中有两种场景使用方式，原理介绍如下：
在场景一中，腾讯云负载均衡器（CLB 七层） 默认会将客户端真实源IP放到 HTTP Header 的 X-Forwarded-For 和 X-Real-IP 字段，当服务流量在经过 Service 四层转发后会保留上述字段，后端通过WEB服务器代理配置或应用代码方式获取到客户端真实源IP，详情参考请文档 负载均衡如何获取客户端真实 IP - 最佳实践 - 文档中心 - 腾讯云；
在场景二中， Nginx Ingress 服务部署需要 Nginx Ingress 能直接感知客户端真实源 IP，可以采用保留客户端源IP的配置方式（详情参考 kubernets设置外部负载均衡器说明 ），或通过 CLB 直通 Pod 的方式（详情参考 TKE场景下腾讯云CLB直通Pod使用场景介绍），当 Nginx Ingress 在转发请求时会通过 X-Forwarded-For 和 X-Real-IP 字段来记录客户端源 IP，后端可以通过此字段获得客户端真实源 IP。
下面详细介绍在 TKE 中两种场景的配置使用方法：
场景一：使用 TKE Ingress 获取真实源 IP
在TKE控制台先为工作负载创建一个主机端口访问方式的 Service 资源，如下图：