Kolbyjack: moved NginxHttp3rdPartyGeoIPModule to Http3rdPartyGeoIPModule: Removing Nginx prefix from page titles

2010-09-22T17:54:24Z

moved NginxHttp3rdPartyGeoIPModule to Http3rdPartyGeoIPModule: Removing Nginx prefix from page titles

New page

= Synopsis =

'''This module has been replaced by the official [[NginxHttpGeoIPModule]] since Nginx 0.7.63/0.8.6.'''

'''Please use this module only for Nginx 0.7.62 or earlier.'''

The Nginx GeoIP module is based on the original [[NginxHttpGeoModule|Geo]] module, the difference being that it is not being controlled by a piece of config, but makes use of the [http://www.maxmind.com/ MaxMind] GeoIP binary API natively. It provides for fast lookups from both the binary [http://www.maxmind.com/app/geolitecountry GeoLite Country] and [http://www.maxmind.com/app/country GeoIP Country] databases.

One of the advantages to use the binary databases and API is getting automated updates from MaxMind through the geoipupdate utility. This is also the reason why [http://www.spilgames.com/ SPIL GAMES] wrote this module.

Example usage:
<pre>
geoip_country_file /absolute/path/to/GeoIP.dat;
location /geoip/ {
rewrite .* /?country=$geoip_country_code;
}
</pre>

= Directives =
== geoip_country_file ==

'''syntax:''' ''geoip_country_file path''

'''default:''' ''n/a''

'''context:''' ''http''

Enables resolving of $geoip_country_* variables documented below.

= Variables =
For now the following variables are supported:

<code>$geoip_country_code</code>, this variable contains the alpha-2 country code as resolved by the GeoIP country API.

<code>$geoip_country_code3</code>, this variable contains the alpha-3 country code as resolved by the GeoIP country API.

<code>$geoip_country_name</code>, this variable contains the country name as resolved by the GeoIP country API.

= Installation =
To install, download the source tarball ( [[File:Nginx-geoip-0.2.tar.gz]] ), expand it, and then compile nginx with the following option:

: . --add-module=/path/to/nginx-geoip-0.2

Please make sure to have the [http://www.maxmind.com/app/c GeoIP C API] installed and in your system library paths.

= TODO =

* Allow control of memory caching options (fixed to GEOIP_MEMORY_CACHE | GEOIP_CHECK_CACHE for now)
* Add support for [http://www.maxmind.com/app/city GeoIP City] databases?

= Bugs =

Please report bugs to matthijs AT SPAMFREE spilgames DOT com.

Http3rdPartyGeoIPModule - Revision history

Kolbyjack: moved NginxHttp3rdPartyGeoIPModule to Http3rdPartyGeoIPModule: Removing Nginx prefix from page titles