Skip to content

docs: add ZO_HTTP_REAL_IP_SOURCE environment variable#376

Merged
hengfeiyang merged 1 commit into
mainfrom
add-http-real-ip-source-env
Jun 1, 2026
Merged

docs: add ZO_HTTP_REAL_IP_SOURCE environment variable#376
hengfeiyang merged 1 commit into
mainfrom
add-http-real-ip-source-env

Conversation

@hengfeiyang
Copy link
Copy Markdown
Contributor

Summary

Documents the ZO_HTTP_REAL_IP_SOURCE environment variable in the Network and Communication section of the environment variables reference.

This variable controls how OpenObserve resolves the real client IP when running behind a proxy or load balancer. Details (default value, supported sources, and the spoofing caveat) were taken directly from the OpenObserve source (config.rs env_config and the real_ip.rs resolver).

  • Default: XEnvoyExternalAddress,XRealIp,RightmostXForwardedFor
  • Sources are tried in order, first match wins, with the TCP peer as the final fallback.
  • Lists all supported values (Envoy/Istio, nginx, AWS ALB/CloudFront, Cloudflare, Fly.io, etc.) and the note that only trusted upstream proxies should be listed.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@hengfeiyang hengfeiyang merged commit 93c3ef0 into main Jun 1, 2026
1 check passed
@hengfeiyang hengfeiyang deleted the add-http-real-ip-source-env branch June 1, 2026 14:37
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.

2 participants