Nginx官方文档(十八)【ngx_http_geoip_module|ngx_http_grpc_module】

最新推荐文章于 2025-11-14 05:05:07 发布
转载 最新推荐文章于 2025-11-14 05:05:07 发布 · 1.4k 阅读 · 0 ·
CC 4.0 BY-SA版权
原文链接：https://blog.youkuaiyun.com/WuLex

本文介绍了Nginx中的ngx_http_geoip_module模块和ngx_http_grpc_module模块的配置方法及指令使用。ngx_http_geoip_module模块支持地理定位功能，通过预编译的MaxMind数据库获取客户端IP地址对应的位置信息；ngx_http_grpc_module模块则允许Nginx作为代理服务器，将HTTP请求转换为gRPC请求并传递给后端gRPC服务器。

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

- grpc_bind

ngx_http_grpc_module

ngx_http_grpc_module 模块允许将请求传递给 gRPC 服务器（1.13.10）。该模块需要 ngx_http_v2_module 模块的支持。

示例配置

server {
    listen 9000 http2;

    location / {
        grpc_pass 127.0.0.1:9000;
    }
}

指令

grpc_bind

-说明
语法map address [transparent ] | off;
默认——
上下文http、server、location

连接到一个指定了本地 IP 地址和可选端口的 gRPC 服务器。参数值可以包含变量。特殊值 off 取消从上层配置级别继承的 grpc_bind 指令的作用，其允许系统自动分配本地 IP 地址和端口。

transparent 参数允许出站从非本地 IP 地址到 gRPC 服务器的连接（例如，来自客户端的真实 IP 地址）：

grpc_bind $remote_addr transparent;

为了使这个参数起作用，通常需要以超级用户权限运行 nginx worker 进程。在 Linux 上，不需要指定 transparent 参数，工作进程会继承 master 进程的 CAP_NET_RAW 功能。此外，还要配置内核路由表来拦截来自 gRPC 服务器的网络流量。

grpc_buffer_size

-说明
语法grpc_buffer_size size;
默认grpc_buffer_size 4k|8k;
上下文http、server、location

设置用于读取从 gRPC 服务器收到的响应的缓冲区的大小（size）。一旦收到响应，响应便会同步传送给客户端。

grpc_connect_timeout

-说明
语法grpc_connect_timeout time;
默认grpc_connect_timeout 60s;
上下文http、server、location

定义与 gRPC 服务器建立连接的超时时间。需要说明的是，超时通常不能超过 75 秒。

grpc_hide_header

-说明
语法grpc_hide_header field;
默认——
上下文http、server、location

默认情况下，nginx 不会将 gRPC 服务器响应中的头字段 Date、Server 和 X-Accel-... 传送给客户端。grpc_hide_header 指令设置了不会被传送的附加字段。相反，如果需要允许传送字段，则可以使用 grpc_pass_header 指令设置。

grpc_ignore_headers

-说明
语法grpc_ignore_headers field ...;
默认——
上下文http、server、location

禁用处理来自 gRPC 服务器的某些响应头字段。以下字段可以忽略：X-Accel-Redirect 和 X-Accel-Charset。

如果未禁用，处理这些头字段将产生以下作用：

grpc_intercept_errors

-说明
语法grpc_intercept_errors on | off;
默认grpc_intercept_errors off;
上下文http、server、location

确定状态码大于或等于 300 的 gRPC 服务器响应是应该传送给客户端还是拦截并重定向到 nginx 使用 error_page 指令进行处理。

grpc_next_upstream

-说明
语法grpc_next_upstream error | timeout | invalid_header | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | http_429 | non_idempotent | off ...;
默认grpc_next_upstream error timeout;
上下文http、server、location

指定在哪些情况下请求应传递给下一个服务器：

  • error

    在与服务器建立连接、传递请求或读取响应头时发生错误

  • timeout

    在与服务器建立连接、传递请求或读取响应头时发生超时

  • invalid_header

    服务器返回了空的或无效的响应

  • http_500

    服务器返回状态码为 500 的响应

  • http_502

    服务器返回状态码为 502 的响应

  • http_503

    服务器返回状态码为 503 的响应

  • http_504

    服务器返回状态码为 504 的响应

  • http_403

    服务器返回状态码为 403 的响应

  • http_404

    服务器返回状态码为 404 的响应

  • http_429

    服务器返回状态码为 429 的响应

  • non_idempotent

    通常，如果请求已发送到上游服务器，请求方法为非幂等（POST、LOCK、PATCH）的请求是不会传送到下一个服务器，使这个选项将明确允许重试这样的请求

  • off

    禁止将请求传递给下一个服务器

我们应该记住，只有在没有任何内容发送给客户端的情况下，才能将请求传递给下一个服务器。也就是说，如果在响应传输过程中发生错误或超时，修复这样的错误是不可能的。

该指令还定义了与服务器进行通信的失败尝试。error、timeout 和 invalid_header 的情况总是被认为是失败尝试，即使它们没有在指令中指定。只有在指令中指定了 http_500、http_502、http_503、http_504 和 http_429 的情况下，才会将其视为失败尝试。http_403 和 http_404 的情况永远不会被视为失败尝试。

将请求传递给下一个服务器可能受到尝试次数和时间的限制。

grpc_next_upstream_timeout

-说明
语法grpc_next_upstream_timeout time;
默认grpc_next_upstream_timeout 0;
上下文http、server、location

限制请求可以传递到下一个服务器的时间。0 值表示关闭此限制。

grpc_next_upstream_tries

-说明
语法grpc_next_upstream_tries number;
默认grpc_next_upstream_tries 0;
上下文http、server、location

限制尝试将请求传递到下一个服务器的次数。0 值表示关闭此限制。

grpc_pass

-说明
语法grpc_pass address;
默认——
上下文location、location 中的 if

设置 gRPC 服务器地址。该地址可以指定为域名或 IP 地址以及端口：

grpc_pass localhost:9000;

或使用 UNIX 域套接字路径：

grpc_pass unix:/tmp/grpc.socket;

或使用 grpc:// scheme：

grpc_pass grpc://127.0.0.1:9000;

要 gRPC 配合 SSL，应该使用 grpcs:// scheme：

grpc_pass grpcs://127.0.0.1:443;

如果域名解析为多个地址，则这些地址将以循环方式使用。另外，地址可以被指定为服务器组。

grpc_pass_header

-说明
语法grpc_pass_header field;
默认——
上下文http、server、location

允许从 gRPC 服务器向客户端传递忽略的头字段。

grpc_read_timeout

-说明
语法grpc_read_timeout time;
默认grpc_read_timeout 60s;
上下文http、server、location

定义从 gRPC 服务器读取响应的超时时间。超时间隔只在两次连续的读操作之间，而不是整个响应的传输过程。如果 gRPC 服务器在此时间内没有发送任何内容，则连接关闭。

grpc_send_timeout

-说明
语法grpc_send_timeout time;
默认grpc_send_timeout 60s;
上下文http、server、location

设置向 gRPC 服务器发送请求的超时时间。超时间隔只在两次连续写入操作之间，而不是整个请求的传输过程。如果 gRPC 服务器在此时间内没有收到任何内容，则连接将关闭。

grpc_set_header

-说明
语法grpc_set_header field value;
默认grpc_set_header Content-Length $content_length;
上下文http、server、location

允许重新定义或附加字段到传递给 gRPC 服务器的请求头。该值可以包含文本、变量及其组合。当且仅当在当前级别上没有定义 grpc_set_header 指令时，这些指令才从上一级继承。

如果头字段的值是一个空字符串，那么这个字段将不会被传递给 gRPC 服务器：

grpc_set_header Accept-Encoding "";

grpc_ssl_certificate

-说明
语法grpc_ssl_certificate file;
默认——
上下文http、server、location

指定一个带有 PEM 格式证书的文件（file），用于向 gRPC SSL 服务器进行身份验证。

grpc_ssl_certificate_key

-说明
语法grpc_ssl_certificate_key file;
默认——
上下文http、server、location

指定一个文件（file），其包含 PEM 格式的密钥，用于对 gRPC SSL 服务器进行身份验证。

可以指定值 engine:name:id 来代替 file，其从 OpenSSL 引擎 name 加载具有指定 id 的密钥。

grpc_ssl_ciphers

-说明
语法grpc_ssl_ciphers ciphers;
默认grpc_ssl_ciphers DEFAULT;
上下文http、server、location

指定对 gRPC SSL 服务器的请求启用的密码。密码格式能被 OpenSSL 库所支持。

完整的列表详情可以使用 openssl ciphers 命令查看。

grpc_ssl_crl

-说明
语法grpc_ssl_crl file;
默认——
上下文http、server、location

指定一个带有 PEM 格式的撤销证书（CRL）的文件（file），用于验证 gRPC SSL 服务器的证书。

grpc_ssl_name

-说明
语法grpc_ssl_name name;
默认grpc_ssl_name host from grpc_pass;
上下文http、server、location

允许重写用于验证 gRPC SSL 服务器的证书并在与 gRPC SSL 服务器建立连接时通过 SNI 传递的服务器名称。

默认情况下，使用 grpc_pass 的主机部分。

grpc_ssl_password_file

-说明
语法grpc_ssl_password_file file;
默认——
上下文http、server、location

指定一个密码为密钥的文件，每个密码在单独的行上指定。加载密钥时会依次尝试每个密码。

grpc_ssl_server_name

-说明
语法grpc_ssl_server_name on | off;
默认grpc_ssl_server_name off;
上下文http、server、location

在建立与 gRPC SSL 服务器的连接时，启用或禁用通过 TLS 服务器名称指示扩展（SNI，RFC 6066）传送服务器名称。

grpc_ssl_session_reuse

-说明
语法grpc_ssl_session_reuse on | off;
默认grpc_ssl_session_reuse on;
上下文http、server、location

确定在使用 gRPC 服务器时是否可以重用 SSL 会话。如果错误 SSL3_GET_FINISHED:digest check fialed 出现在日志中，尝试禁用会话重用。

grpc_ssl_protocols

-说明
语法grpc_ssl_protocols [SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2] [TLSv1.3];
默认grpc_ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
上下文http、server、location

对 gRPC SSL 服务器的请求启用指定的协议。

grpc_ssl_trusted_certificate

-说明
语法grpc_ssl_trusted_certificate file;
默认——
上下文http、server、location

指定一个带有 PEM 格式的可信 CA 证书的文件，用于验证 gRPC SSL 服务器的证书。

grpc_ssl_verify

-说明
语法grpc_ssl_verify on | off;
默认grpc_ssl_verify off;
上下文http、server、location

启用或禁用验证 gRPC SSL 服务器证书。

grpc_ssl_verify_depth

-说明
语法grpc_ssl_verify_depth number;
默认grpc_ssl_verify_depth 1;
上下文http、server、location

设置 gRPC SSL 服务器证书链中的验证深度。

原文档

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

13、Nginx高级之高级模块(geoip_module)
无痕的博客
06-25 2698
Nginx的geoip_module区别国内外的IP、区别城市间的ip
nginx高性能web服务器详解(二)
weixin_42559561的博客
11-26 1288
Nginx（发音为"engine x"）是一个高性能的开源Web服务器，也可用作反向代理服务器、负载均衡器和HTTP缓存。以下是Nginx高性能Web服务器的一些详解，下半部分。
Nginx服务器中配置GeoIP模块来拦截指定国家IP
01-10
最近有一个网站项目需求：需要屏蔽国内的方问请求。花时间研究了一下这方面的资料。目前找到的最佳方法就是使用 Nginx 的 GeoIP 模块来实现地区的识别。然后配置相关国家的 ISO 名称，禁止访问即可。记录一下相关过程。 编译 GeoIP 组件 maxmind 提供的免费版数据库已经可以满足需求，在使用数据库前，需要先编译 GeoIP 组件： wget http://geolite.maxmind.com/download/geoip/api/c/GeoIP-1.4.8.tar.gz ./configure make make install 下载 IP 库 从 maxmind 下载 I
ngx_http_geoip2_module 开源项目教程
最新发布
gitblog_00580的博客
11-14 810
`ngx_http_geoip2_module` 是一个用于 Nginx 的开源模块，它允许通过 MaxMind GeoIP2 数据库来解析客户端 IP 地址的地理位置信息。这个模块可以帮助开发者根据用户的地理位置提供定制化的内容或服务，例如定向广告、内容分发和访问控制等。 ## 项目快速启动 ### 安装依赖 首先，确保系统上安装了 `libmaxminddb` 库和 Nginx 开发包。
NGINX `ngx_http_geoip_module` 基于 IP 的地理位置智能路由与统计
hello.reader
05-08 1227
利用 MaxMind 提供的 GeoIP 二进制数据库（国家库、城市库、组织库），在 NGINX 层面将客户端 IP 映射为地理或组织信息。其核心能力有：在高并发场景下，不必额外调用外部 API，即可在 NGINX 配置中直接引用多达几十个内置变量，灵活做路由、限流、统计与日志标记。安装 GeoIP C 库（以 Ubuntu 为例）： 下载或更新 MaxMind 数据库（可选 GeoIP2/GeoLite2，但需转换格式或用第三方模块）： 编译 NGINX（确保 ）： 验证： 三、核心指令与
Nginx 主线版 1.13.10 新增 ngx_http_grpc_module
热门推荐
lsxf_xin的专栏
03-23 1万+
Nginx 主线版 1.13.10 已发布，该版本新增了不少新的特性，也修复了两个 bug，具体如下：Feature: the "set" parameter of the "include" SSI directive now allows writing arbitrary responses to a variable; the"subrequest_output_buffer_size" ...
精选资源
nginx官方文档中文版
06-13
* 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_...
基于 OpenSSL 源码为 nginx 配置并安装 http_ssl_module
tobrainto
09-23 1756
基于 openssl 源码为 nginx 配置并安装 http_ssl_module
nginx模块解析
m0_55877125的博客
04-03 1209
nginx模块
nginx 模块说明
hallyz的博客
05-23 659
nginx 模块说明 模块 描述 ngx_http_core_module nginx核心基础模块 ngx_http_access_module 该模块提供了一个简单的基于主机的访问控制。允许/拒绝基于ip地址 ngx_http_addition_module 作为一个输出过滤器，支持不完全缓冲，分部分响应请求 ngx_http_api_module ngx_http_auth_basic_module 该模块提供了一个简单的基于主机的访问控制。允许/拒绝基于ip地址
Nginx(二) 重新编译并添加模块
ShenDaiSun的博客
11-05 2553
作用：一是检查所需模块是否已安装，二是将configure arguments: 后面的参数复制出来并保存，因为等会重新编译时还需将这些模块一同添加进去。
Nginx 和 GeoIP 模块的使用
东境物语
11-17 4383
使用Nginx 和 GeoIP 模块的可以来处理不同地区的访问或是灰度版本的控制
Nginx-geoip_module模块
SZStudy的博客
11-23 1332
#geoip_module模块 #基于IP地址匹配MaxMind GeoIP二进制文件，读取IP地址 #先安装 #yum install nginx-module-geoip #在nginx.conf添加： #load_module "module/ngx_stream_geoip_module.so"; #load_module "module/ngx_http_geoip_module.so...
NGINX `ngx_http_grpc_module` 用 HTTP/2 反向代理你的 gRPC 微服务
hello.reader
05-08 1308
让 NGINX 能以 HTTP/2 协议直接与 gRPC 服务通信。TLS 终端：在 NGINX 层做 TLS 解密/加密超时控制：连接、读写、整体调用超时故障切换：按需重试或切换到下游流量控制：Buffer、限速、KeepaliveHeader 管理：自定义、隐藏、透传 gRPC/HTTP2 元数据为 NGINX 注入了原生 gRPC 支持，使得传统 L7 反向代理不仅仅局限于 HTTP/1.x，同时掌握 HTTP/2 流量调度之道。安全可靠的 TLS 终端无缝故障切换与负载均衡。
基于 NGINX 的 ngx_http_geoip2 模块 来禁止国外 IP 访问网站
dumuzhouguohe的博客
04-02 1435
基于 NGINX 的 ngx_http_geoip2 模块 来禁止国外 IP 访问网站。
Nginx安装ngx_http_geoip2_module模块，限制地区访问
八星瓢虫
06-03 1401
这里的CN代表只允许中国地区访问。#这里的HE代表只允许河北地区访问。Nginx的某站点server段添加下面配置。三、修改nginx站点server段配置。二、添加nginx全局http段配置。Nginx的http段添加下面配置。
nginx利用ngx_http_geoip2_module模块对国外ip限制
m0_55116875的博客
11-19 1300
nginx利用ngx_http_geoip2_module模块对国外ip进行限制访问
Nginx之IP国家代码ngx_http_geoip2_module模块简介和使用
月生的静心苑
11-26 4901
ngx_http_geoip2_module模块使用预编译的MaxMind数据库创建变量，其值取决于客户端 IP 地址 ，通过此模块我们可以精准的限制或者允许某个国家的IP地址访问WEB站点。MaxMind的GeoIP2和GeoLite2 IP智能产品和服务用于发现有关特定IP地址的信息。我们提供免费和付费网络服务、基于订阅的可下载数据库和免费可下载数据库。我们学习使用免费版本的就可以，当然付费版本的更新更及时，内容更详细（包括国家、城市、经纬度、运营商、甚至企业信息）。
nginx之Geoip读取地域信息模块
元贞
06-23 356
1 geoip_module模块基于IP地址匹配MaxMind GeolP二进制文件，读取IP所在地域信息。yum install nginx-module-geoipgeoip2已经有了，安装另寻2、http_geoip_module使用一、区别国内外作HTTP访问规则二、区别国内城市地域作HTTP访问规则用到的ip数据库链接：https://pan.baidu.com/s/1KcFhouFh...
探索Nginx的http_push_module模块
标题和描述都提到了"nginx_http_push_module"，这是一个与Nginx相关的模块，名为Nginx HTTP Push模块。首先，我们需要了解Nginx是一个高性能的HTTP和反向代理服务器，也是IMAP/POP3/SMTP服务器。它以其低内存消耗、...
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值