Nginx中文文档
DocsHome
  • 贡献导引
  • 介绍
    • 安装 nginx
    • 从源码构建 nginx
    • 初学者指南
    • 管理指南
    • 控制 nginx
    • 连接处理方式
    • 设置哈希
    • 调试日志
    • 记录日志到 syslog
    • 配置文件度量单位
    • 命令行参数
    • Windows 下的 nginx
    • QUIC 和 HTTP/3 支持
    • nginx 如何处理请求
    • 服务器名称
    • 使用 nginx 作为 HTTP 负载均衡器
    • 配置 HTTPS 服务器
    • nginx 如何处理 TCP/UDP 会话
    • 关于 nginScript
  • 其他
    • Linux 软件包
  • How-To
    • 在 Win32 平台上使用 Visual C 构建 nginx
    • 设置 Amazon EC2 的 Nginx Plus 环境
    • 使用 DTrace pid 提供程序调试 nginx
    • 转换重写规则
    • WebSocket 代理
  • 开发
    • 贡献指南
    • 开发指南
  • 模块参考
  • 核心功能
    • HTTP
      • ngx_http_core_module
      • ngx_http_access_module
      • ngx_http_addition_module
      • ngx_http_api_module
      • ngx_http_auth_basic_module
      • ngx_http_auth_jwt_module
      • ngx_http_auth_request_module
      • ngx_http_autoindex_module
      • ngx_http_browser_module
      • ngx_http_charset_module
      • ngx_http_dav_module
      • ngx_http_empty_gif_module
      • ngx_http_f4f_module
      • ngx_http_fastcgi_module
      • ngx_http_flv_module
      • ngx_http_geo_module
      • ngx_http_geoip_module
      • ngx_http_grpc_module
      • ngx_http_gunzip_module
      • ngx_http_gzip_module
      • ngx_http_gzip_static_module
      • ngx_http_headers_module
      • ngx_http_hls_module
      • ngx_http_image_filter_module
      • ngx_http_index_module
      • ngx_http_js_module
      • ngx_http_keyval_module
      • ngx_http_limit_conn_module
      • ngx_http_limit_req_module
      • ngx_http_log_module
      • ngx_http_map_module
      • ngx_http_memcached_module
      • ngx_http_mirror_module
      • ngx_http_mp4_module
      • ngx_http_perl_module
      • ngx_http_proxy_module
      • ngx_http_random_index_module
      • ngx_http_realip_module
      • ngx_http_referer_module
      • ngx_http_rewrite_module
      • ngx_http_scgi_module
      • ngx_http_secure_link_module
      • ngx_http_session_log_module
      • ngx_http_slice_module
      • ngx_http_spdy_module(过时)
      • ngx_http_split_clients_module
      • ngx_http_ssi_module
      • ngx_http_ssl_module
      • ngx_http_status_module(过时)
      • ngx_http_stub_status_module
      • ngx_http_sub_module
      • ngx_http_upstream_module
      • ngx_http_upstream_conf_module
      • ngx_http_upstream_hc_module
      • ngx_http_userid_module
      • ngx_http_uwsgi_module
      • ngx_http_v2_module
      • ngx_http_xslt_module
    • Mail
      • ngx_mail_core_module
      • ngx_mail_auth_http_module
      • ngx_mail_proxy_module
      • ngx_mail_ssl_module
      • ngx_mail_imap_module
      • ngx_mail_pop3_module
      • ngx_mail_smtp_module
    • Stream
      • ngx_stream_core_module
      • ngx_stream_access_module
      • ngx_stream_geo_module
      • ngx_stream_geoip_module
      • ngx_stream_js_module
      • ngx_stream_keyval_module
      • ngx_stream_limit_conn_module
      • ngx_stream_log_module
      • ngx_stream_map_module
      • ngx_stream_proxy_module
      • ngx_stream_realip_module
      • ngx_stream_return_module
      • ngx_stream_split_clients_module
      • ngx_stream_ssl_module
      • ngx_stream_ssl_preread_module
      • ngx_stream_upstream_module
      • ngx_stream_upstream_hc_module
      • ngx_stream_zone_sync_module
    • 其他
      • ngx_google_perftools_module
由 GitBook 提供支持
在本页
  • 示例配置
  • 指令
  • geoip_country
  • geoip_city
  • geoip_org
  • geoip_proxy
  • geoip_proxy_recursive
  • 原文档
  1. 核心功能
  2. HTTP

ngx_http_geoip_module

上一页ngx_http_geo_module下一页ngx_http_grpc_module

最后更新于5年前

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

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

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

该模块需要 库。

示例配置

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

  • $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 中发送的最后一个不可信地址,而不是匹配其中一个可信地址的原始客户端地址。

原文档

美国的 DMA 地区代码(也称为城市代码),根据 Google AdWords API 中的

示例配置
指令
geoip_country
geoip_city
geoip_org
geoip_proxy
geoip_proxy_recursive
MaxMind
MaxMind GeoIP
地理位置定位
http://nginx.org/en/docs/http/ngx_http_geoip_module.html