文档中心

容器服务

请输入

网络

通过 Ingress 获取真实客户端 IP 地址

本文主要介绍外部请求通过 Ingress 访问工作负载时，工作负载后端 Pod 获取外部请求的真实 IP 地址的方法。

注意

Nginx Ingress 功能即将下线，详情请参见【产品公告】NGINX Ingress 停止维护公告。

Flannel 网络集群

登录容器服务控制台。

在左侧导航栏中选择集群，单击目标集群名称，进入集群管理页面。

配置 ingress-nginx-controller 对应服务（Service）的转发外部流量策略Spec.externalTrafficPolicy为Local。

说明

ingress-nginx-controller 是安装 ingress-nginx 组件后，生成的 Ingress 控制器对应的 Service。

Flannel 容器网络模型的集群，其后端业务 Pod 获取客户端真实 IP 时，需要将 LoadBalancer Service 的externalTrafficPolicy设置为Local，用于将节点的 IPVS 只转发给本节点的 Nginx Ingress Pod。

在集群管理页面的左侧导航栏中，选择服务与路由 > 服务。

在 kube-system 命名空间下，找到 ingress-nginx-controller，并在对应操作列中选择... > 编辑 Yaml。

修改Spec.externalTrafficPolicy的值为Local。

单击确定，保存配置。

配置 ingress-nginx-controller 对应配置项（ConfigMap），增加获取真实客户端 IP 时必要的字段。

在集群管理页面的左侧导航栏中，选择配置管理 > 配置项。

在 kube-system 命名空间下，找到 ingress-nginx-controller，并在对应操作列中选择... > 编辑 Yaml。

在配置项中的data代码块中增加如下字段

data:
use-forwarded-headers: "true"
compute-full-forwarded-for: "true"
forwarded-for-header: X-Forwarded-For
...

单击确定，保存配置。

配置完成后，在无状态负载列表中，找到重新部署 ingress-nginx-controller，使配置生效。

VPC-CNI 网络集群

登录容器服务控制台。

在左侧导航栏中选择集群，单击目标集群名称，进入集群管理页面。

配置 ingress-nginx-controller 对应配置项（ConfigMap），增加获取真实客户端 IP 时必要的字段。

在集群管理页面的左侧导航栏中，选择配置管理 > 配置项。

在 kube-system 命名空间下，找到 ingress-nginx-controller，并在对应操作列中选择... > 编辑 Yaml。

在配置项中的data代码块中增加如下字段。

data:
use-forwarded-headers: "true"
compute-full-forwarded-for: "true"
forwarded-for-header: X-Forwarded-For
...

单击确定，保存配置。

配置完成后，在无状态负载列表中，找到并重新部署 ingress-nginx-controller，使配置生效。

结果验证

前提条件

本文通过 Nginx 镜像模拟真实客户端，因此验证操作前，您还需要准备如下工作：

在集群中安装 ingress-nginx 组件。详情请参见安装组件。

在镜像仓库中上传开源 nginx 镜像，用于验证操作结果时模拟后端服务。详情请参见推送和拉取镜像。

准备一台可以访问公网的主机，模拟外部真实客户端。该客户端必须在 Ingress 所在集群外。

说明

您可以创建一个可以访问公网的云服务器（ECS）实例，作为执行机器。详细操作，请参见通过向导购买实例。

步骤一：部署应用和服务

说明

Flannel 容器网络模型的集群，将 LoadBalancer Service 的externalTrafficPolicy设置为Local后，若节点上没有 Nginx Ingress Pod，则该 LoadBalancer 地址无法被访问且会被会被当作 Service 的扩展 IP 地址，被 IPVS 拦截并转发，发生网络不通的问题。相关问题的更多信息，请参见社区文档。

因此下文使用无状态负载模拟后端服务的 Nginx Ingress Pod。