nginx模块geo and geoip

一、nginx编译：

为了方便测试，编译时加入了nginx的第三方模块echo输出：

nginx编译参数：
--prefix=/apps/svr/nginx-geo-geoip --with-http_ssl_module --with-http_flv_module --with-http_gzip_static_module --with-http_addition_module --with-http_auth_request_module --with-http_geoip_module --add-module=../ngx_cache_purge-2.3 --add-module=/home/apps/echo-nginx-module-0.60

二、nginx ngx_http_geo_module 模块

1、默认情况下，nginx是有加该模块的，如不需要该模块，编译的时候加上 --without-http_geo_module参数

2、geo指令：

Syntax:	geo [$address] $variable { ... }
Default:	—
Context:	http

定义从指定的变量获取客户端的IP地址，nginx通过CIDR或者地址段来描述地址，支持下面几个参数：

delete：删除指定的网络
default：如果客户端地址不能匹配任意一个定义的地址，nginx将使用此值。 如果使用CIDR，可以用“0.0.0.0/0”代替default。
include： 包含一个定义地址和值的文件，可以包含多个。
proxy：定义可信地址。 如果请求来自可信地址，nginx将使用其“X-Forwarded-For”头来获得地址。 相对于普通地址，可信地址是顺序检测的。
proxy_recursive：开启递归查找地址。 如果关闭递归查找，在客户端地址与某个可信地址匹配时，nginx将使用“X-Forwarded-For”中的最后一个地址来代替原始客户端地址。如果开启递归查找，在客户端地址与某个可信地址匹配时，nginx将使用“X-Forwarded-For”中最后一个与所有可信地址都不匹配的地址来代替原始客户端地址。
ranges：使用以地址段的形式定义地址，这个参数必须放在首位。为了加速装载地址库，地址应按升序定义。

3、nginx测试：

a、default、include测试

nginx.conf：
geo $arg_ip $address {
        default    fromdefault;
        127.0.0.1/24  from127-24;
        127.0.0.1/32  from127-32;
        10.10.10.10 from10;

        include /apps/conf/nginx/geo.conf;
        delete 127.0.0.0/16;
        proxy  11.11.11.11;
    }

    server{
      listen 80;
      server_name address.com;
      location /ip138 {
         default_type text/plain;
         echo $address;
      }

    }

 cat /apps/conf/nginx/geo.conf
1.1.1.1 CN;
2.2.2.2 US;
3.3.3.3 JA;

测试结果：

 curl http://address.com/ip138 -x 127.0.0.1:80
fromdefault

 curl http://address.com/ip138?ip=127.0.0.1 -x 127.0.0.1:80
from127-32

curl http://address.com/ip138?ip=127.0.0.12 -x 127.0.0.1:80
from127-24

 curl http://address.com/ip138?ip=10.10.10.10 -x 127.0.0.1:80
from10

 curl http://address.com/ip138?ip=1.1.1.1 -x 127.0.0.1:80
CN

 curl http://address.com/ip138?ip=2.2.2.2 -x 127.0.0.1:80
US

$ curl http://address.com/ip138?ip=3.3.3.3 -x 127.0.0.1:80
JA

b、delete参数测试：

   geo $arg_ip $address {
        default    fromdefault;
        127.0.0.1/24  from127-24;
        127.0.0.1/32  from127-32;
        10.10.10.10 from10;
        10.190.200.15 fromreal;
        include /apps/conf/nginx/geo.conf;
        delete 10.10.10.10;
        proxy  11.11.11.11;
    }

测试结果：删除指定网络后

 curl http://address.com/ip138?ip=10.10.10.10 -x 127.0.0.1:80
fromdefault

ngx_http_geo_module模块可以当做IP调度使用，将上述的geo.conf文件完善，也可实现一个简单的ip138，但需要完整的ip地址库

二、nginx ngx_http_geo_module 模块

1、网站需要根据不同的源地址转发到不同的二级站点，可以通过ngx_http_geoip_module模块实现。nginx默认不编译这个模块，需要编译时开启 --with-http_geoip_module 编译选项。 ngx_http_geoip_module 模块创建变量，使用预编译的 MaxMind 数据库解析客户端IP地址，得到变量值，然后根据变量的值去匹配判断，所以要模块依赖 MaxMind GeoIP 库，GeoIP数据库支持两种格式CSV格式和二进制格式。

2、geoip指令：

Syntax:	geoip_country file;
Default:	—
Context:	http

$geoip_country_code
双字符国家代码，比如“RU”，“US”。

$geoip_country_code3
三字符国家代码，比如“RUS”，“USA”。

$geoip_country_name
国家名称，比如“Russian Federation”，“United States”。

语法：geoip_city file
默认：—
上下文：http

$geoip_area_code
电话区号（仅美国）
该变量由于相应的数据库会过时，所以信息可能过时。

$geoip_city_continent_code
两字母的大陆代码，如“EU”，“NA”

$geoip_city_country_code
两字母的国家代码，如“RU”，“US”

$geoip_city_country_code3
三字母的国家代码，如“RUS”，“USA”

$geoip_city_country_name
国家名，例如“Russian Federation”，“United States”

$geoip_dma_code
美国DMA地区代码（亦称“地铁代码”），依据Google AdWords API geotargeting

$geoip_latitude
纬度

$geoip_longitude
经度

$geoip_region
两标识符的国家区域代码（区域、范围、州、省、联邦），例如“48”、“DC”

$geoip_region_name
国家区域名（区域、范围、州、省、联邦），例如“Moscow City”，“District of Columbia”

$geoip_city
城市名，例如“Moscow”，“Washington”

$geoip_postal_code邮政编码

语法：geoip_org file
默认：—
上下文：http

指定数据库用于决定依赖于客户端IP地址的机构。下面的变量在使用数据库时可用：

$geoip_org
组织名，例如“The University of Melbourne”

语法：geoip_proxy address | CIDR
默认：—
上下文：http

定义可信地址。当请求来自于可信地址，将会使用请求头中的“X-Forwarded-For”。

语法：geoip_proxy_recursive on | off
默认：geoip_proxy_recursive off
上下文：http

如果递归查询禁用，“X-Forwarded-For”中最后一个地址将被使用。
如果递归查询启用，会用“X-Forwarded-For”中最后一个不可信地址。

3、安装GeoIP:

wget http://geolite.maxmind.com/download/geoip/api/c/GeoIP.tar.gz
tar zxvf GeoIP.tar.gz
cd GeoIP-1.4.8/
./configure 
make && make install
echo '/usr/local/lib' > /etc/ld.so.conf.d/geoip.conf
ldconfig

4、编译nginx：

nginx编译参数：
--prefix=/apps/svr/nginx-geo-geoip --with-http_ssl_module --with-http_flv_module --with-http_gzip_static_module --with-http_addition_module --with-http_auth_request_module --with-http_geoip_module --add-module=../ngx_cache_purge-2.3 --add-module=/home/apps/echo-nginx-module-0.60

4、测试：（由于在局域网内测试，GeoIP识别不了局域网的IP，采用的测试include自定义文件的方式测试）

geo $geoip_country{
    include /apps/conf/nginx/nginx_geoip.txt;
  }

if ( $geoip_country ~ ^(?:CN)$ ){
          rewrite ^(.*) http://www.baidu.com  break;
      }
if ( $geoip_country ~ ^(?:US)$ ){
          rewrite ^(.*) http://www.sina.com  break;
      }
       
cat /apps/conf/nginx/nginx_geoip.txt 
1.0.0.0/24 AU;
xx.xx.xx.xx CN;
**.**.**.** US;

结果：

IP为：xx.xx.xx.xx访问时：跳转到www.baidu.com

IP为：**.**.**.**访问时：跳转到www.sina.com