如何在Kubernetes集群的istio服务网格中透传Cloudflare的cf-ray请求头
很多人配Istio透传自定义头的时候,都会卡在一个默认规则上:Istio底层基于Envoy构建,默认会按照RFC规范移除一部分私有跨域请求头,而Cloudflare生成的cf-ray系列头,刚好就在Envoy默认的移除列表里——这就是为什么你明明没配移除规则,头却传不进集群的根本原因。
- Istio本身没有做"拦截cf-ray"的专属逻辑,只是跟随Envoy的默认配置执行头部清理,正常情况下只要你显式告知代理"保留这个头",就能实现全链路透传。
- 你之前留意到的VirtualService头部操作的set/add/remove三个选项,不是只有修改头部的作用:set操作完全可以不写死固定值,配合Envoy内置的请求头占位符,就能实现"把请求自带的头原样保留,不做修改、不被过滤规则移除"的效果,这就是你要的透传逻辑。
- 全链路透传需要覆盖两个代理节点:边缘的istio-ingressgateway、每个业务Pod里的sidecar,只要任意一个节点的过滤规则把cf-ray头删了,后面的链路就接不到这个头。
场景a:ingressgateway 到集群内部的透传保障
如果出现Cloudflare传过来的cf-ray头在ingressgateway层就被删掉的情况,直接在对应绑定ingressgateway的VirtualService上补显式保留规则即可,不需要全局改mesh配置:
apiVersion: networking.istio.io/v1alpha3 kind: VirtualService metadata: name: 对应域名的路由规则 namespace: 你的业务命名空间 spec: hosts: - 你的业务域名 gateways: - istio-system/ingressgateway http: - match: - uri: prefix: / route: - destination: host: 你的集群内服务名 port: number: 服务对应的端口 # 显式保留cf-ray头,抵消默认的私有头过滤规则 headers: request: set: cf-ray: "%REQ(cf-ray)%"
这里的%REQ(cf-ray)%是Envoy内置的请求头取值占位符,含义是把请求原本携带的cf-ray原值原封不动设置回请求链路,完全不需要提前写死具体的cf-ray值,也不会改变头的实际内容。
场景b:sidecar 到业务主容器的透传保障
和ingressgateway的逻辑一致,Pod里的sidecar同样会执行默认的私有头过滤规则,哪怕头已经从ingressgateway进到了集群内部,经过下一个服务的sidecar时依然可能被删掉,传不到业务容器。
如果不想逐个业务服务写VirtualService配置,可以直接用全局EnvoyFilter给所有代理(包括ingressgateway和所有sidecar)统一加保留规则,一次配置全网格生效:
apiVersion: networking.istio.io/v1alpha3 kind: EnvoyFilter metadata: name: preserve-cf-ray-global namespace: istio-system spec: configPatches: - applyTo: HTTP_FILTER match: # 匹配所有请求上下文:边缘网关、sidecar入站、sidecar出站 context: ANY proxy: proxyVersion: '^1\.(1[1-9]|[2-9][0-9])\.*' listener: filterChain: filter: name: "envoy.filters.network.http_connection_manager" subFilter: name: "envoy.filters.http.router" patch: operation: INSERT_BEFORE value: name: envoy.filters.http.header_to_metadata typed_config: "@type": "type.googleapis.com/envoy.extensions.filters.http.header_to_metadata.v3.Config" request_rules: - header: cf-ray on_header_present: metadata_namespace: istio_custom key: cf-ray-value # 核心配置:检测到cf-ray头时不主动移除 remove: false
如果不想用全局配置,针对单个业务服务,只要在对应服务的VirtualService路由规则里,加上和ingressgateway一样的headers.request.set配置,就能保证请求经过该服务的sidecar时,cf-ray头不会被过滤,原封不动传给业务主容器。
- 首先排查Cloudflare侧的规则:确认Cloudflare没有在页面规则里开启"移除自定义请求头"的配置——只要Cloudflare处于默认代理模式,本身是会把cf-ray头传递到源站的,如果Cloudflare侧配了头移除,就算Istio配置再完善,头也到不了ingressgateway。
- 不要错误使用add操作:如果写了类似
cf-ray: "测试值"的固定配置,会直接把Cloudflare传来的真实cf-ray值覆盖掉,失去排查意义,所有透传配置都必须配合%REQ(头名)%的占位符使用。 - 配完之后逐层验证:可以先搭一个简单的httpbin服务指到对应路由上,从Cloudflare侧发请求,检查httpbin返回的请求头里有没有cf-ray字段,逐层定位哪一层把头删掉了,不要全网格配完才发现某一层配置不对。
内容的提问来源于stack exchange,提问作者pkaramol

