leev/ngx_http_geoip2_module

Health v2 · maintenance only

Adoption not part of the score

1140 stars · 214 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

An Nginx module that creates variables from MaxMind GeoIP2 databases based on client IP addresses, supporting both IPv4 and IPv6. It works with both the HTTP and stream subsystems and can be built as a static or dynamic module.

Use cases

• serve different content based on visitor country
• block or redirect traffic from specific countries
• log client city and country in nginx access logs
• pass geolocation data to backend apps via fastcgi params
• geolocate clients in nginx stream (TCP/UDP) proxies
• auto-reload MaxMind database files without restarting nginx

When to choose

• you run nginx and need geolocation lookups at the web server layer
• you want to use MaxMind GeoIP2/GeoLite2 mmdb databases
• you need geolocation for both HTTP and stream traffic
• you prefer a lightweight C module over application-level geo lookups

When to avoid

• you don't control nginx compilation or can't load dynamic modules
• you need geolocation in an application server rather than nginx
• you use legacy GeoIP (dat) databases instead of GeoIP2
• you need a pure-Lua or dynamically scripted solution like OpenResty

Facets

plugin · maturity stable

middleware networking developer-tools web-development backend networking apis nginx-module geoip maxmind geoip2 geolocation c stream-module linux web-server nginx

Member repositories

For agents

markdown · JSON · MCP: product_card(name="leev/ngx_http_geoip2_module")