Nginx中透传客户端真实IP的本领

目次

• 概述
• 1. 为什么必要获取客户端的真实 IP 地址？
• 2. Nginx 中用于获取真实 IP 地址的模块
• 3. 设置示例和步骤
• 3.1 安装和启用模块
• 3.2 设置 Nginx
• 3.3 设置阐明
• 4. 潜在的陷阱和调试方法
• 4.1 潜在的陷阱
• 4.2 调试方法
• 实操
• http 节点 添加$http_x_forwarded_for日记格式
• server节点 设置
• 验证
• 方式一
• 方式二

概述

1. 为什么必要获取客户端的真实 IP 地址？

在利用 Nginx 作为反向代理服务器时，默认环境下，后端服务器只能看到 Nginx 的IP地址。为了记载日记、限制访问或举行其他基于 IP 地址的操作，获取客户端的真实 IP 地址非常紧张。

2. Nginx 中用于获取真实 IP 地址的模块

Nginx 提供了两个紧张模块来处理这一需求：

• HttpRealipModule: 用于从请求头中提取客户端的真实 IP 地址。
• HttpGeoipModule: 用于根据 IP 地址定位地理位置（较少用于获取真实 IP）。

这里紧张先容 [code]HttpRealipModule[/code]。

3. 设置示例和步骤

3.1 安装和启用模块

大多数环境下，Nginx 已经包含了 [code]HttpRealipModule[/code]。可以通过以下命令检查：

如果没有启用该模块，则必要重新编译 Nginx 或安装包含该模块的 Nginx 版本。

3.2 设置 Nginx

编辑你的 Nginx 设置文件（通常位于 [code]/etc/nginx/nginx.conf[/code] 或 [code]/etc/nginx/conf.d/[/code] 中的某个文件），添加以下设置：

3.3 设置阐明

• [code]set_real_ip_from[/code]: 答应哪些 IP 地址可以作为可信代理。如果你的代理服务器在特定的 IP 范围内，只答应那些 IP。
• [code]real_ip_header[/code]: 指定哪个头部字段包含了真实 IP 地址。常用的是 [code]X-Forwarded-For[/code]。
• [code]real_ip_recursive[/code]: 递归地检查 [code]X-Forwarded-For[/code] 头部中的所有 IP 地址，直到找到第一个非可信代理的 IP。

4. 潜在的陷阱和调试方法

4.1 潜在的陷阱

• 代理链中的 IP 地址次序：[code]X-Forwarded-For[/code] 头部可能包含多个 IP 地址，代表了一系列代理服务器。确保设置的 [code]real_ip_recursive on[/code] 正确地获取到第一个客户端的 IP 地址。
• 安全题目：设置 [code]set_real_ip_from[/code] 时，要警惕不要信托不受控制的 IP 地址，否则可能会导致 IP 欺骗。

4.2 调试方法

• 检查日记：通过查看 Nginx 日记，确认是否乐成获取到真实 IP 地址。
• 测试请求：利用工具如 [code]curl[/code] 模仿请求，带上 [code]X-Forwarded-For[/code] 头部，观察服务器的相应和日记记载。

实操

http 节点 添加$http_x_forwarded_for日记格式

设置文件中必要添加$http_x_forwarded_for日记格式， 焦点内容如下

http节点 日记格式中必要添加$http_x_forwarded_for

[code]log_format[/code] 指令用于界说 Nginx 的日记格式。它指定了在日记文件中记载哪些信息以及如何格式化这些信息。每个字段利用一个变量表现，变量之间可以用分隔符分开，如空格、竖线（[code]|[/code]）等。界说的日记格式可以应用于 [code]access_log[/code] 指令，以便记载客户端请求的详细信息。

以下是 [code]log_format[/code] 指令中各个变量的含义：

• [code]$remote_addr[/code]: 客户端的 IP 地址。这是直接连接到 Nginx 的客户端的 IP 地址。
• [code]$http_x_forwarded_for[/code]: 客户端的真实 IP 地址。通常用于记载经过代理服务器或负载均衡器的客户端 IP 地址，[code]X-Forwarded-For[/code] 头部中包含了这些 IP。
• [code]$remote_user[/code]: 客户端的用户名，如果请求必要 HTTP 根本认证时会记载用户名。如果没有认证信息则为 [code]-[/code]。
• [code]$time_local[/code]: 本地时间和日期，格式为 [code]day/month/year:hour:minute:second[/code]。
• [code]$request[/code]: 请求的完整 URI，包罗参数。格式为 [code]METHOD URI PROTOCOL[/code]，例如 [code]GET /index.html HTTP/1.1[/code]。
• [code]$http_host[/code]: 请求中的 [code]Host[/code] 头部内容，即访问的主机名。
• [code]$status[/code]: 相应的 HTTP 状态码，例如 [code]200[/code] 表现乐成，[code]404[/code] 表现未找到，[code]500[/code] 表现服务器内部错误等。
• [code]$upstream_status[/code]: 上游服务器返回的状态码。当 Nginx 作为反向代理时，此变量记载上游服务器的相应状态码。
• [code]$body_bytes_sent[/code]: 传送给客户端的相应主体内容的字节数，不包罗相应头的大小。
• [code]$http_referer[/code]: 请求的引用页面，即从哪个页面链接过来的（[code]Referer[/code] 头部内容）。如果没有引用页面则为 [code]-[/code]。
• [code]$http_user_agent[/code]: 客户端利用的欣赏器或其他客户端的信息（[code]User-Agent[/code] 头部内容）。
• [code]$upstream_addr[/code]: 上游服务器的地址。当 Nginx 作为反向代理时，此变量记载上游服务器的 IP 地址和端口。
• [code]$request_time[/code]: 处理请求的总时间，从接收到客户端请求到完整发送相应的时间，单元为秒。
• [code]$upstream_response_time[/code]: 从上游服务器读取相应的时间，单元为秒。

server节点 设置

https://www.jb51.net/server/3262802e1.htm

利用 proxy_set_header 指令设置透传头部。确保代理服务器（如 Nginx）在转发请求时保存原始客户端的 IP 地址

验证

方式一

访问Nginx页面

访问日记

• [code]192.168.0.6[/code]:

含义：直接连接到 Nginx 服务器的客户端的 IP 地址。在这个例子中，这可能是一个内网的 IP 地址。

• [code]168.138.171.206[/code]:

含义：通过 [code]X-Forwarded-For[/code] 头部获取的客户端的真实 IP 地址。在经过代理或负载均衡器时，这个头部会记载原始客户端的 IP 地址。

• [code]-[/code]:

含义：客户端的用户名。在请求必要 HTTP 根本认证时记载用户名。这里没有举行认证，以是表现为 [code]-[/code]。

• [code]19/May/2024:10:57:24 +0800[/code]:

含义：请求到达服务器的本地时间，格式为 [code]day/month/year:hour:minute:second timezone[/code]。这个例子中表现 2024 年 5 月 19 日上午 10:57:24，时区为 +0800。

• [code]GET / HTTP/1.1[/code]:

含义：客户端的请求行，包含请求的方法（GET）、请求的资源路径（/），以及利用的 HTTP 协议版本（HTTP/1.1）。

• [code]nginx.frps.fun[/code]:

含义：请求中的 [code]Host[/code] 头部，表现客户端请求访问的主机名。

• [code]200[/code]:

含义：HTTP 相应状态码，表现请求乐成。[code]200[/code] 代表乐成。

• [code]-[/code]:

含义：上游服务器的相应状态码。在没有上游服务器时，这里表现为 [code]-[/code]。

• [code]615[/code]:

含义：传送给客户端的相应主体内容的字节数，不包罗相应头的大小。

• [code]-[/code]:

含义：请求的引用页面（Referer）。如果没有引用页面则表现为 [code]-[/code]。

• [code]Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36[/code]:

含义：客户端利用的欣赏器或其他客户端的信息（User-Agent）。在这个例子中，表现客户端利用的是 Chrome 欣赏器，运行在 macOS 上。

• [code]-[/code]:

含义：上游服务器的地址。在没有上游服务器时，这里表现为 [code]-[/code]。

• [code]0.000[/code]:

含义：处理请求的总时间，从接收到客户端请求到完整发送相应的时间，单元为秒。

• [code]-[/code]:

含义：从上游服务器读取相应的时间。在没有上游服务器时，这里表现为 [code]-[/code]。

方式二

• http://127.0.0.1/: 请求的 URL，127.0.0.1 表现本地服务器。
• -H ‘X-Forwarded-For: 1.1.1.1’: 添加 HTTP 请求头 X-Forwarded-For，其值为 1.1.1.1。这个头部通常用于表现客户端的真实 IP 地址。
• -v: 表现详细的请求和相应过程，包罗头部信息

日记

从日记文件 logs/access.log 中，可以验证 X-Forwarded-For 头部信息是否正确记载， 此日记记载表现，X-Forwarded-For 头部中通报的 1.1.1.1 已正确记载。

到此这篇关于Nginx中透传客户端真实IP的本领的文章就先容到这了,更多相关Nginx 透传IP内容请搜索脚本之家以前的文章或继续欣赏下面的相关文章盼望各人以后多多支持脚本之家！