nginx中文文档-ngx_http_geo_module

ngx_http_geo_module创建取值依赖于客户端IP的变量。

示例配置

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 { … }
默认:—
上下文:http

描述客户端IP地址变量取值的依赖。默认情况下,地址从$remote_addr变量中获取,但可以指定为其他的变量(0.7.27+),例如:

geo $arg_remote_addr $geo {
    ...;
}

由于只有当变量使用时才会计算,即使geo声明了很多,也不会对请求处理有额外的开销。
如果变量的值非法,则会用“255.255.255.255”这个地址。
地址可以定义为CIDR形式也可以是范围形式(0.7.23+)。
IPv6前缀从1.3.10和1.2.7版本开始支持。
以下特殊的参数也是支持的:
delete

删除指定的网络(0.7.23+)

default

当客户端地址不匹配任何地址时的值。当地址用CIDR形式定义时,“0.0.0.0/0”和“::/0”可以用来代替default。当default没有定义时,默认值为一个空字符串。

include

包含保存地址和值的文件,可以由多个包含。

proxy

定义可信的地址(0.8.7+,0.7.63+)。当请求从可信地址上发来,会从请求头的“X-Forwarded-For”字段中取值。信任的地址按顺序检查。
IPv6的支持从1.3.0和1.2.1版本开始。

proxy_recursive

启动递归地址搜索(1.3.0+,1.2.1+)。如果递归查询禁用,会用“X-Forwarded-For”中的最后一个地址,否则会用“X-Forwarded-For”中最后一个不可信的地址。

ranges

声明地址定义为范围(0.7.23+),该参数应在第一个出现。为提高加载数据的速度,地址应使用升序排列。

例子:

geo $country {
    default        ZZ;
    include        conf/geo.conf;
    delete         127.0.0.0/16;
    proxy          192.168.100.0/24;
    proxy          2001:0db8::/32;

    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;
}

发表评论

电子邮件地址不会被公开。 必填项已用*标注

You must enable javascript to see captcha here!