geoip_proxy

The geoip_proxy directive establishes a way for NGINX to utilize the proxy protocol to obtain the original IP address of clients, allowing for improved accuracy in geographical identification via GeoIP databases. This is particularly useful in environments where requests are forwarded from one proxy server to another, as the addressing in the request may not accurately reflect the client's actual geographic location. When configured, NGINX will read the client’s original IP address from the specified header instead of directly from the client connection.

This directive accepts a single argument that specifies the name of the header to look for, which typically contains the client's original address (e.g., X-Real-IP). When using this directive, it is crucial to ensure that the upstream proxies properly populate the identified header with valid IPs for accurate GeoIP lookups. Failure to configure this correctly can lead to incorrect geographical data being recorded during logging or access control.

The execution of the directive occurs within the HTTP context, which allows it to be globally applicable across server blocks or within specific location blocks. Proper evaluation of headers is performed on incoming requests, making it essential to maintain consistent configurations across any intermediate proxies in deployment.