模块 ngx_stream_geo_module
示例配置 Directives geo |
模块 (1.11.3) 创建变量
的值取决于客户端 IP 地址。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; }
Directives
语法: |
geo [ |
---|---|
默认值: | — |
上下文: |
stream |
描述指定变量的值的依赖关系
在客户端 IP 地址上。
默认情况下,地址取自变量
但它也可以从另一个变量中获取,例如:$remote_addr
geo $arg_remote_addr $geo { ...; }
由于变量仅在使用时被计算,因此仅存在
甚至大量声明的 “” 变量
不会给连接处理带来任何额外的成本。geo
如果变量的值不表示有效的 IP 地址
则使用 “” 地址。255.255.255.255
地址指定为 CIDR 表示法中的前缀 (包括单个地址)或 as 范围。
还支持以下特殊参数:
delete
- 删除指定的网络。
default
- 如果客户端地址没有,则设置为变量的值
匹配任何指定的地址。
当以 CIDR 表示法指定地址时,
“” 和 “”
可以代替 .
如果未指定,则默认为
value 将为空字符串。
0.0.0.0/0
::/0
default
default
include
- 包括一个包含地址和值的文件。 可以包含多个内容。
ranges
- 表示地址被指定为范围。 此参数应为第一个参数。 为了加快 geo base 的加载速度,地址应按升序排列。
例:
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;
使用最具体的 match 的值。
例如,对于 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; }