Nginx Module

This is an IP2Location Nginx Module that enables the user to identify the country code and country name by IP address. In general, it is faster, easier and more accurate than reverse DNS lookups.

Download IP2Location Nginx Module (3.41 kB) Version: 7.0.0

 

Installation
  1. Download IP2location C library from here.
  2. Download and decompress this Nginx module package.
  3. Change the path to IP2Location library in "ngx_http_ip2location_module.c".
  4. Re-compile Nginx from source to include this module. Add the below directive into the compile of Nginx:
    ./configure --add-module=/absolute/path/to/nginx-ip2location-7.0.0
  5. make
  6. make install
  7. Edit your Nginx config file to point the correct path of IP2Location database file:
    ip2location_database /absolute/path/to/IP2LOCATION-DB1.BIN;

 

Sample Codes

Block visitors from China:

if ( $ip2location_country_code = "CN" ) {
	return 403;
}

 

Redirect visitors from Canada, United States, and Mexico to new page:

if ( $ip2location_country_code ~* "CA|US|MX" ) {
	rewrite ^ http://example.com/newpage.html permanent;
}

 

Sample IP2Location Databases (BIN)

The following evaluation copy of the database file has limited range of IP address information compare to commercial. For evaluation purpose, you can query IP addresses from 0.0.0.0-99.255.255.255 (IPv4) or 2A04:0:0:0:0:0:0:0-2A04:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF (IPv6).

Sample Packages IPv4 IPv6
IP2Location DB1 Sample Bin File338.81 kB88.24 kB
IP2Location DB2 Sample Bin File35.95 MB104.78 kB
IP2Location DB3 Sample Bin File12.25 MB95.11 kB
IP2Location DB4 Sample Bin File46.07 MB110.79 kB
IP2Location DB5 Sample Bin File18.71 MB99.57 kB
IP2Location DB6 Sample Bin File52.91 MB115.11 kB
IP2Location DB7 Sample Bin File51.30 MB118.70 kB
IP2Location DB8 Sample Bin File58.51 MB122.75 kB
IP2Location DB9 Sample Bin File21.80 MB102.04 kB
IP2Location DB10 Sample Bin File62.58 MB126.01 kB
IP2Location DB11 Sample Bin File22.22 MB102.56 kB
IP2Location DB12 Sample Bin File62.92 MB126.58 kB
IP2Location DB13 Sample Bin File19.80 MB100.28 kB
IP2Location DB14 Sample Bin File63.95 MB126.84 kB
IP2Location DB15 Sample Bin File24.20 MB105.33 kB
IP2Location DB16 Sample Bin File67.81 MB130.89 kB
IP2Location DB17 Sample Bin File24.52 MB105.64 kB
IP2Location DB18 Sample Bin File73.28 MB137.52 kB
IP2Location DB19 Sample Bin File60.49 MB123.39 kB
IP2Location DB20 Sample Bin File75.16 MB138.44 kB
IP2Location DB21 Sample Bin File26.42 MB107.07 kB
IP2Location DB22 Sample Bin File77.92 MB140.49 kB
IP2Location DB23 Sample Bin File60.92 MB123.78 kB
IP2Location DB24 Sample Bin File78.68 MB140.90 kB