The mod_geoip2 module for Nginx
The mod_geoip2 module for Nginx
一，关于GEOIP
官网：http://www.maxmind.com/zh/home
通过MaxMind的GeoIP产品，您可以对网络访问者的地点、机构、连网速度 及用户类型加以识别。
GeoIP数据库是现有的最常见、 最准确的IP地理定位数据库。
本文主要介绍的是Geoip2结合Nginx的安装和应用，Geoip(1代)使用更为简单，请参考官方网站。
二，安装ngx_http_geoip2_module的依赖库libmaxminddb
github地址：https://github.com/maxmind/libmaxminddb
注意：按照README.md上的方法，用git clone下来的源码，在编译的时候会报错，原因不明，下载tar包就没有问题。
下载并安装libmaxminddb
三，编译Nginx geoip2模块
github地址：https://github.com/leev/ngx_http_geoip2_module
wget https://github.com/leev/ngx_http_geoip2_module/archive/master.zip
unzip master
mv ngx_http_geoip2_module /user/local/src/
重新编译Nginx
./configure --prefix=/user/local/nginx --add-module=/usr/local/src/ngx_http_geoip2_module
四，应用
免费版Geoip数据库下载地址
http://dev.maxmind.com/geoip/geoip2/geolite2/
以下是Geoip官网根据ip输出maxmind-city.mmdb结构及内容的一个示例：
更多介绍请参考：http://dev.maxmind.com/geoip/geoip2/web-services/
以下是ngx_http_geoip2_modul官方给的应用例子：
## Example Usage:
```
其中geoip2_data方法的第一个参数为自定义的变量名称，变量值可以在Nginx直接写入日志文件或是传递给php变量。
第二个及后面的参数为geoip2 mmdb数据库中的各级字段名称。
注意：在获取省份信息的时候，注意subdivisions字段下面是个数组，获取方法如下：
结合以上例子和数据结构，可根据自己的需要来获得国家、省份、城市等信息。
一，关于GEOIP
官网：http://www.maxmind.com/zh/home
通过MaxMind的GeoIP产品，您可以对网络访问者的地点、机构、连网速度 及用户类型加以识别。
GeoIP数据库是现有的最常见、 最准确的IP地理定位数据库。
本文主要介绍的是Geoip2结合Nginx的安装和应用，Geoip(1代)使用更为简单，请参考官方网站。
二，安装ngx_http_geoip2_module的依赖库libmaxminddb
github地址：https://github.com/maxmind/libmaxminddb
注意：按照README.md上的方法，用git clone下来的源码，在编译的时候会报错，原因不明，下载tar包就没有问题。
下载并安装libmaxminddb
yum -y install autoconf automake libtool wget https://github.com/maxmind/libmaxminddb/releases/download/0.5.5/libmaxminddb-0.5.5.tar.gz tar -zxvf libmaxminddb-0.5.5.tar.gz cd libmaxminddb-0.5.5 ./configure make check make install ldconfig
三，编译Nginx geoip2模块
github地址：https://github.com/leev/ngx_http_geoip2_module
wget https://github.com/leev/ngx_http_geoip2_module/archive/master.zip
unzip master
mv ngx_http_geoip2_module /user/local/src/
重新编译Nginx
./configure --prefix=/user/local/nginx --add-module=/usr/local/src/ngx_http_geoip2_module
四，应用
免费版Geoip数据库下载地址
http://dev.maxmind.com/geoip/geoip2/geolite2/
以下是Geoip官网根据ip输出maxmind-city.mmdb结构及内容的一个示例：
更多介绍请参考：http://dev.maxmind.com/geoip/geoip2/web-services/
{
"city": {
"confidence": 25,
"geoname_id": 54321,
"names": {
"de": "Los Angeles",
"en": "Los Angeles",
"es": "Los Ángeles",
"fr": "Los Angeles",
"ja": "ロサンゼルス市",
"pt-BR": "Los Angeles",
"ru": "Лос-Анджелес",
"zh-CN": "洛杉矶"
}
},
"continent": {
"code": "NA",
"geoname_id": 123456,
"names": {
"de": "Nordamerika",
"en": "North America",
"es": "América del Norte",
"fr": "Amérique du Nord",
"ja": "北アメリカ",
"pt-BR": "América do Norte",
"ru": "Северная Америка",
"zh-CN": "北美洲"
}
},
"country": {
"confidence": 75,
"geoname_id": "6252001",
"iso_code": "US",
"names": {
"de": "USA",
"en": "United States",
"es": "Estados Unidos",
"fr": "États-Unis",
"ja": "アメリカ合衆国",
"pt-BR": "Estados Unidos",
"ru": "США",
"zh-CN": "美国"
}
},
"location": {
"accuracy_radius": 20,
"latitude": 37.6293,
"longitude": -122.1163,
"metro_code": 807,
"time_zone": "America/Los_Angeles"
},
"postal": {
"code": "90001",
"confidence": 10
},
"registered_country": {
"geoname_id": "6252001",
"iso_code": "US",
"names": {
"de": "USA",
"en": "United States",
"es": "Estados Unidos",
"fr": "États-Unis",
"ja": "アメリカ合衆国",
"pt-BR": "Estados Unidos",
"ru": "США",
"zh-CN": "美国"
}
},
"represented_country": {
"geoname_id": "6252001",
"iso_code": "US",
"names": {
"de": "USA",
"en": "United States",
"es": "Estados Unidos",
"fr": "États-Unis",
"ja": "アメリカ合衆国",
"pt-BR": "Estados Unidos",
"ru": "США",
"zh-CN": "美国"
},
"type": "military"
},
"subdivisions": [
{
"confidence": 50,
"geoname_id": 5332921,
"iso_code": "CA",
"names": {
"de": "Kalifornien",
"en": "California",
"es": "California",
"fr": "Californie",
"ja": "カリフォルニア",
"ru": "Калифорния",
"zh-CN": "加州"
}
}
],
"traits": {
"autonomous_system_number": "1239",
"autonomous_system_organization": "Linkem IR WiMax Network",
"domain": "example.com",
"is_anonymous_proxy": true,
"is_satellite_provider": true,
"isp": "Linkem spa",
"ip_address": "1.2.3.4",
"organization": "Linkem IR WiMax Network",
"user_type": "traveler",
},
"maxmind": {
"queries_remaining": "54321"
}
}
以下是ngx_http_geoip2_modul官方给的应用例子：
## 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;
....
}
其中geoip2_data方法的第一个参数为自定义的变量名称，变量值可以在Nginx直接写入日志文件或是传递给php变量。
第二个及后面的参数为geoip2 mmdb数据库中的各级字段名称。
注意：在获取省份信息的时候，注意subdivisions字段下面是个数组，获取方法如下：
geoip2_data $privince subdivisions 0 names en
结合以上例子和数据结构，可根据自己的需要来获得国家、省份、城市等信息。