Skip to content

support exposing proxy protocol enabled listeners#975

Open
krisek wants to merge 1 commit into
apache:masterfrom
krisek:proxy-protocol-expose
Open

support exposing proxy protocol enabled listeners#975
krisek wants to merge 1 commit into
apache:masterfrom
krisek:proxy-protocol-expose

Conversation

@krisek

@krisek krisek commented Jun 9, 2026

Copy link
Copy Markdown

Co-authored-by: GPT-5.4

These changes add configurable nginx realip settings and proxy protocol listener support for APISIX. This enables deployments behind L4/L7 proxies to preserve the original client IP end to end, including cases where the proxy sends PROXY protocol metadata.

The change introduces:

  • apisix.nginx.real_ip_header and apisix.nginx.real_ip_from
  • apisix.proxyProtocol.listenHttpPort and listenHttpsPort-
  • apisix.proxyProtocol.enableTcpPP and enableTcpPPToUpstream
  • apisix.proxyProtocol.exposed to route the main gateway service to the proxy-protocol listeners

Backwards compatibility is preserved: all new settings are optional, and existing rendered templates are unchanged unless these values are set.

Operational note: when using proxy protocol, operators should set real_ip_header to proxy_protocol, configure trusted proxy CIDRs in real_ip_from, and ensure the external load balancer actually sends PROXY protocol to the exposed listener ports.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant