nginx中文文档-ngx_stream_geo_module

示例配置：

geo $geo {
    default        0;

    127.0.0.1      2;
    192.168.1.0/24 1;
    10.1.0.0/16    1;

    ::1            2;
    2001:0db8::/32 1;
}

geo

语法：geo [$address] $variable { … }
默认：—
上下文：stream

描述指定变量的值与客户端IP地址之间的依赖关系。默认情况下，地址从$remote_addr变量中获取，但是它可以从另外的变量中获取，例如：

geo $arg_remote_addr $geo {
    ...;
}

由于变量在使用时才会解析，可以在geo中声明一个很大的变量映射表，不会引起任何额外的开销。
如果变量的值不是一个合法的IP地址，则使用“255.255.255.255”。
地址可以指定为CIDR地址块格式，也可以为范围。
下面特殊的参数同样受支持：
delete
删除指定的网络。

default
为那些没有匹配任何指定IP地址的客户端地址设置一个默认值。当地址是以CIDR方式指定，“0.0.0.0/0”和“::/0”用于替换默认值。当默认值没有指定，则默认值为空字符串。

include
包含一个含有地址和值的文件。可以有多个包含。

ranges
声明地址定义为一个范围。这个参数应该在最先出现。为了加快载入的速度，地址应该以升序排列。

例子：

geo $country {
    default        ZZ;
    include        conf/geo.conf;
    delete         127.0.0.0/16;

    127.0.0.0/24   US;
    127.0.0.1/32   RU;
    10.1.0.0/16    RU;
    192.168.1.0/24 UK;
}

conf/geo.conf文件包含以下内容：

10.2.0.0/16    RU;
192.168.2.0/24 RU;

最匹配的值将被使用。例如，地址127.0.0.1会使用“RU”，而不是“US”。

带范围的例子：

geo $country {
    ranges;
    default                   ZZ;
    127.0.0.0-127.0.0.0       US;
    127.0.0.1-127.0.0.1       RU;
    127.0.0.1-127.0.0.255     US;
    10.1.0.0-10.1.255.255     RU;
    192.168.1.0-192.168.1.255 UK;
}