36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
Description
|
|
===========
|
|
|
|
**ngx_http_geoip2_module** - creates variables with values from the maxmind geoip2 databases based on the client IP (supports both IPv4 and IPv6)
|
|
|
|
## Installing
|
|
First install [libmaxminddb](https://github.com/maxmind/libmaxminddb) as described in its [README.md
|
|
file](https://github.com/maxmind/libmaxminddb/blob/master/README.md#installing-from-a-tarball).
|
|
|
|
Compile nginx:
|
|
```
|
|
./configure --add-module=/path/to/ngx_http_geoip2_module
|
|
make
|
|
make install
|
|
```
|
|
|
|
## Download Maxmind GeoLite2 Database (optional)
|
|
The free GeoLite2 databases are available from [Maxminds website](http://dev.maxmind.com/geoip/geoip2/geolite2/)
|
|
|
|
[GeoLite2 City](http://geolite.maxmind.com/download/geoip/database/GeoLite2-City.mmdb.gz)
|
|
[GeoLite2 Country](http://geolite.maxmind.com/download/geoip/database/GeoLite2-Country.mmdb.gz)
|
|
|
|
## Example Usage:
|
|
```
|
|
http {
|
|
...
|
|
geoip2_mmdb /etc/maxmind-city.mmdb;
|
|
geoip2_data $geoip2_data_country_code country iso_code;
|
|
geoip2_data $geoip2_data_country_name country names en;
|
|
geoip2_data $geoip2_data_city_name city names en;
|
|
geoip2_data $geoip2_data_geoname_id country geoname_id;
|
|
geoip2_data $geoip2_data_latitude location latitude;
|
|
geoip2_data $geoip2_data_country_code default=US country iso_code;
|
|
....
|
|
}
|
|
```
|