ngx_http_geoip_module

ngx_http_geoip_module 模块（0.8.6+）使用预编译的 MaxMind 数据库，其创建带值的变量依赖客户端 IP 地址。

当使用支持 IPv6 的数据库时（1.3.12、1.2.7），IPv4 地址将被视为 IPv4 映射的 IPv6 地址。

此模块不是默认构建的，可以使用 --with-http_geoip_module 配置参数启用。

该模块需要 MaxMind GeoIP 库。

示例配置

http {
    geoip_country         GeoIP.dat;
    geoip_city            GeoLiteCity.dat;
    geoip_proxy           192.168.100.0/24;
    geoip_proxy           2001:0db8::/32;
    geoip_proxy_recursive on;
    ...

指令

geoip_country

说明

语法

geoip_country file;

默认

——

上下文

http

指定一个用于根据客户端 IP 地址确定国家的数据库。使用此数据库时，以下变量可用：

$geoip_country_code
双字母国家代码，例如 RU、US
$geoip_country_code3
三个字母的国家代码，例如 RUS、USA
$geoip_country_name
国家名称，例如 Russian Federation、United States

geoip_city

说明

语法

geoip_city file;

默认

——

上下文

http

指定一个用于根据客户端 IP 地址确定国家、地区和城市的数据库。使用此数据库时，以下变量可用：

$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 中的地理位置定位
$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

说明

语法

geoip_org file;

默认

——

上下文

http

提示

该指令在 1.0.3 版本中出现

指定用于根据客户端 IP 地址确定组织的数据库。使用此数据库时，以下变量可用：

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

geoip_proxy

说明

语法

geoip_proxy address | CIDR;

默认

——

上下文

http

提示

该指令在 1.3.0 版本和 1.2.1. 版本中出现

定义可信地址。当请求来自可信地址时，将使用来自 X-Forwarded-For 请求头字段的地址。

geoip_proxy_recursive

说明

语法

geoip_proxy_recursive on | off;

默认

geoip_proxy_recursive off;

上下文

http

提示

该指令在 1.3.0 版本和 1.2.1. 版本中出现

如果递归搜索被禁用，那么将使用在 X-Forwarded-For 中发送的最后一个地址，而不是匹配其中一个可信地址的原始客户端地址。如果启用递归搜索，则将使用在 X-Forwarded-For 中发送的最后一个不可信地址，而不是匹配其中一个可信地址的原始客户端地址。

原文档

http://nginx.org/en/docs/http/ngx_http_geoip_module.html

上一页ngx_http_geo_module 下一页ngx_http_grpc_module

最后更新于4年前