Nginx中透?jìng)骺蛻舳苏鎸?shí)IP的技巧
概述
1. 為什么需要獲取客戶端的真實(shí) IP 地址？
在使用 Nginx 作為反向代理服務(wù)器時(shí)，默認(rèn)情況下，后端服務(wù)器只能看到 Nginx 的IP地址。為了記錄日志、限制訪問(wèn)或進(jìn)行其他基于 IP 地址的操作，獲取客戶端的真實(shí) IP 地址非常重要。
2. Nginx 中用于獲取真實(shí) IP 地址的模塊
Nginx 提供了兩個(gè)主要模塊來(lái)處理這一需求：
- HttpRealipModule: 用于從請(qǐng)求頭中提取客戶端的真實(shí) IP 地址。
- HttpGeoipModule: 用于根據(jù) IP 地址定位地理位置（較少用于獲取真實(shí) IP）。
這里主要介紹 HttpRealipModule。
3. 配置示例和步驟
3.1 安裝和啟用模塊
大多數(shù)情況下，Nginx 已經(jīng)包含了 HttpRealipModule?？梢酝ㄟ^(guò)以下命令檢查：
nginx -V 2>&1 | grep -o with-http_realip_module
如果沒(méi)有啟用該模塊，則需要重新編譯 Nginx 或安裝包含該模塊的 Nginx 版本。
3.2 配置 Nginx
編輯你的 Nginx 配置文件（通常位于 /etc/nginx/nginx.conf 或 /etc/nginx/conf.d/ 中的某個(gè)文件），添加以下配置：
http {
...
set_real_ip_from 0.0.0.0/0; # 允許所有 IP 地址的代理
real_ip_header X-Forwarded-For;
real_ip_recursive on;
...
server {
...
location / {
...
# 如果需要日志中記錄真實(shí) IP
log_format custom '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"';
access_log /var/log/nginx/access.log custom;
...
}
}
}
3.3 配置說(shuō)明
set_real_ip_from: 允許哪些 IP 地址可以作為可信代理。如果你的代理服務(wù)器在特定的 IP 范圍內(nèi)，只允許那些 IP。real_ip_header: 指定哪個(gè)頭部字段包含了真實(shí) IP 地址。常用的是X-Forwarded-For。real_ip_recursive: 遞歸地檢查X-Forwarded-For頭部中的所有 IP 地址，直到找到第一個(gè)非可信代理的 IP。
4. 潛在的陷阱和調(diào)試方法
4.1 潛在的陷阱
- 代理鏈中的 IP 地址順序：
X-Forwarded-For頭部可能包含多個(gè) IP 地址，代表了一系列代理服務(wù)器。確保配置的real_ip_recursive on正確地獲取到第一個(gè)客戶端的 IP 地址。 - 安全問(wèn)題：配置
set_real_ip_from時(shí)，要小心不要信任不受控制的 IP 地址，否則可能會(huì)導(dǎo)致 IP 欺騙。
4.2 調(diào)試方法
- 檢查日志：通過(guò)查看 Nginx 日志，確認(rèn)是否成功獲取到真實(shí) IP 地址。
- 測(cè)試請(qǐng)求：使用工具如
curl模擬請(qǐng)求，帶上X-Forwarded-For頭部，觀察服務(wù)器的響應(yīng)和日志記錄。
curl -H "X-Forwarded-For: 203.0.113.195" http://your-nginx-server
實(shí)操
http 節(jié)點(diǎn) 添加$http_x_forwarded_for日志格式
配置文件中需要添加$http_x_forwarded_for日志格式， 核心內(nèi)容如下
http {
include mime.types;
default_type application/octet-stream;
log_format main ' $remote_addr | $http_x_forwarded_for | $remote_user | $time_local | $request | $http_host |'
' $status | $upstream_status | $body_bytes_sent | $http_referer '
' $http_user_agent | $upstream_addr | $request_time | $upstream_response_time';
http節(jié)點(diǎn) 日志格式中需要添加$http_x_forwarded_for
log_format 指令用于定義 Nginx 的日志格式。它指定了在日志文件中記錄哪些信息以及如何格式化這些信息。每個(gè)字段使用一個(gè)變量表示，變量之間可以用分隔符分開(kāi)，如空格、豎線（|）等。定義的日志格式可以應(yīng)用于 access_log 指令，以便記錄客戶端請(qǐng)求的詳細(xì)信息。
以下是 log_format 指令中各個(gè)變量的含義：
log_format main ' $remote_addr | $http_x_forwarded_for | $remote_user | $time_local | $request | $http_host |'
' $status | $upstream_status | $body_bytes_sent | $http_referer '
' $http_user_agent | $upstream_addr | $request_time | $upstream_response_time';
$remote_addr: 客戶端的 IP 地址。這是直接連接到 Nginx 的客戶端的 IP 地址。$http_x_forwarded_for: 客戶端的真實(shí) IP 地址。通常用于記錄經(jīng)過(guò)代理服務(wù)器或負(fù)載均衡器的客戶端 IP 地址，X-Forwarded-For頭部中包含了這些 IP。$remote_user: 客戶端的用戶名，如果請(qǐng)求需要 HTTP 基本認(rèn)證時(shí)會(huì)記錄用戶名。如果沒(méi)有認(rèn)證信息則為-。$time_local: 本地時(shí)間和日期，格式為day/month/year:hour:minute:second。$request: 請(qǐng)求的完整 URI，包括參數(shù)。格式為METHOD URI PROTOCOL，例如GET /index.html HTTP/1.1。$http_host: 請(qǐng)求中的Host頭部?jī)?nèi)容，即訪問(wèn)的主機(jī)名。$status: 響應(yīng)的 HTTP 狀態(tài)碼，例如200表示成功，404表示未找到，500表示服務(wù)器內(nèi)部錯(cuò)誤等。$upstream_status: 上游服務(wù)器返回的狀態(tài)碼。當(dāng) Nginx 作為反向代理時(shí)，此變量記錄上游服務(wù)器的響應(yīng)狀態(tài)碼。$body_bytes_sent: 傳送給客戶端的響應(yīng)主體內(nèi)容的字節(jié)數(shù)，不包括響應(yīng)頭的大小。$http_referer: 請(qǐng)求的引用頁(yè)面，即從哪個(gè)頁(yè)面鏈接過(guò)來(lái)的（Referer頭部?jī)?nèi)容）。如果沒(méi)有引用頁(yè)面則為-。$http_user_agent: 客戶端使用的瀏覽器或其他客戶端的信息（User-Agent頭部?jī)?nèi)容）。$upstream_addr: 上游服務(wù)器的地址。當(dāng) Nginx 作為反向代理時(shí)，此變量記錄上游服務(wù)器的 IP 地址和端口。$request_time: 處理請(qǐng)求的總時(shí)間，從接收到客戶端請(qǐng)求到完整發(fā)送響應(yīng)的時(shí)間，單位為秒。$upstream_response_time: 從上游服務(wù)器讀取響應(yīng)的時(shí)間，單位為秒。
server節(jié)點(diǎn) 配置
server {
listen 80;
server_name localhost;
access_log logs/access.log main; #需要添加日志引用
proxy_set_header X-Real-IP $remote_addr; #添加透?jìng)髋渲?
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for
location / {
root html;
}
}
http://m.fzitv.net/server/3262802e1.htm
使用 proxy_set_header 指令設(shè)置透?jìng)黝^部。確保代理服務(wù)器（如 Nginx）在轉(zhuǎn)發(fā)請(qǐng)求時(shí)保留原始客戶端的 IP 地址
驗(yàn)證
方式一
訪問(wèn)Nginx頁(yè)面
訪問(wèn)日志
192.168.0.6 | 168.138.171.206 | - | 19/May/2024:10:57:24 +0800 | GET / HTTP/1.1 | nginx.frps.fun | 200 | - | 615 | - 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 | - | 0.000 | -
192.168.0.6:
含義：直接連接到 Nginx 服務(wù)器的客戶端的 IP 地址。在這個(gè)例子中，這可能是一個(gè)內(nèi)網(wǎng)的 IP 地址。
168.138.171.206:
含義：通過(guò) X-Forwarded-For 頭部獲取的客戶端的真實(shí) IP 地址。在經(jīng)過(guò)代理或負(fù)載均衡器時(shí)，這個(gè)頭部會(huì)記錄原始客戶端的 IP 地址。
-:
含義：客戶端的用戶名。在請(qǐng)求需要 HTTP 基本認(rèn)證時(shí)記錄用戶名。這里沒(méi)有進(jìn)行認(rèn)證，所以顯示為 -。
19/May/2024:10:57:24 +0800:
含義：請(qǐng)求到達(dá)服務(wù)器的本地時(shí)間，格式為 day/month/year:hour:minute:second timezone。這個(gè)例子中表示 2024 年 5 月 19 日上午 10:57:24，時(shí)區(qū)為 +0800。
GET / HTTP/1.1:
含義：客戶端的請(qǐng)求行，包含請(qǐng)求的方法（GET）、請(qǐng)求的資源路徑（/），以及使用的 HTTP 協(xié)議版本（HTTP/1.1）。
nginx.frps.fun:
含義：請(qǐng)求中的 Host 頭部，表示客戶端請(qǐng)求訪問(wèn)的主機(jī)名。
200:
含義：HTTP 響應(yīng)狀態(tài)碼，表示請(qǐng)求成功。200 代表成功。
-:
含義：上游服務(wù)器的響應(yīng)狀態(tài)碼。在沒(méi)有上游服務(wù)器時(shí)，這里顯示為 -。
615:
含義：傳送給客戶端的響應(yīng)主體內(nèi)容的字節(jié)數(shù)，不包括響應(yīng)頭的大小。
-:
含義：請(qǐng)求的引用頁(yè)面（Referer）。如果沒(méi)有引用頁(yè)面則顯示為 -。
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:
含義：客戶端使用的瀏覽器或其他客戶端的信息（User-Agent）。在這個(gè)例子中，表示客戶端使用的是 Chrome 瀏覽器，運(yùn)行在 macOS 上。
-:
含義：上游服務(wù)器的地址。在沒(méi)有上游服務(wù)器時(shí)，這里顯示為 -。
0.000:
含義：處理請(qǐng)求的總時(shí)間，從接收到客戶端請(qǐng)求到完整發(fā)送響應(yīng)的時(shí)間，單位為秒。
-:
含義：從上游服務(wù)器讀取響應(yīng)的時(shí)間。在沒(méi)有上游服務(wù)器時(shí)，這里顯示為 -。
方式二
如果我們前面沒(méi)有apisix或者其它lb，也可以使用curl命令來(lái)模擬X-Forwarded-For日志
curl http://127.0.0.1/ -H 'X-Forwarded-For: 1.1.1.1' -v * About to connect() to 127.0.0.1 port 80 (#0) * Trying 127.0.0.1... * Connected to 127.0.0.1 (127.0.0.1) port 80 (#0) > GET / HTTP/1.1 > User-Agent: curl/7.29.0 > Host: 127.0.0.1 > Accept: */* > X-Forwarded-For: 1.1.1.1 #-v參數(shù)可以看到這里參數(shù)已經(jīng)傳入 > < HTTP/1.1 200 OK < Server: nginx < Date: Sun, 19 May 2024 03:09:05 GMT < Content-Type: text/html; charset=utf-8 < Content-Length: 615 < Last-Modified: Mon, 09 Oct 2023 06:03:57 GMT < Connection: keep-alive < ETag: "652397cd-267" < Accept-Ranges: bytes < <!DOCTYPE html> #http:127.0.0.1 就是Nginx服務(wù)器
- http://127.0.0.1/: 請(qǐng)求的 URL，127.0.0.1 表示本地服務(wù)器。
- -H ‘X-Forwarded-For: 1.1.1.1’: 添加 HTTP 請(qǐng)求頭 X-Forwarded-For，其值為 1.1.1.1。這個(gè)頭部通常用于表示客戶端的真實(shí) IP 地址。
- -v: 顯示詳細(xì)的請(qǐng)求和響應(yīng)過(guò)程，包括頭部信息
日志
127.0.0.1 | 1.1.1.1 | - | 19/May/2024:10:57:24 +0800 | GET / HTTP/1.1 | 127.0.0.1 | 200 | - | 615 | - | curl/7.29.0 | - | 0.000 | -
從日志文件 logs/access.log 中，可以驗(yàn)證 X-Forwarded-For 頭部信息是否正確記錄， 此日志記錄顯示，X-Forwarded-For 頭部中傳遞的 1.1.1.1 已正確記錄。
到此這篇關(guān)于Nginx中透?jìng)骺蛻舳苏鎸?shí)IP的技巧的文章就介紹到這了,更多相關(guān)Nginx 透?jìng)鱅P內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
在有一次配置時(shí)發(fā)現(xiàn)，請(qǐng)求?uri?明明是符合了前綴匹配?^~?規(guī)則，但?nginx?卻沒(méi)有使用，這讓我對(duì)上述結(jié)論產(chǎn)生了疑惑。后續(xù)通過(guò)調(diào)研、實(shí)踐后發(fā)現(xiàn)，上述結(jié)論可以說(shuō)對(duì)，但也不對(duì)，是不是更疑惑了？沒(méi)關(guān)系，看完這篇文章你就知道我為什么會(huì)這樣說(shuō)了2022-05-05
這篇文章主要介紹了前端必備Nginx配置詳解，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-09-09
本文詳解的介紹了 Nginx 的 ngx_http_limit_conn_module 和 ngx_http_limit_req_module 模塊，對(duì)請(qǐng)求訪問(wèn)量進(jìn)行控制。非常具有實(shí)用價(jià)值，需要的朋友可以參考下2018-12-12
本文為大家介紹一下nginx配置的相關(guān)介紹，供大家參考2013-02-02
這里簡(jiǎn)單整理了一份Nginx服務(wù)器中的重定向配置參考指,包括rewrite模塊的配置以及301重定向的設(shè)置等,需要的朋友可以參考下2016-05-05
Nginx如何配置根據(jù)路徑轉(zhuǎn)發(fā)詳解
Nginx是作為一個(gè)反向代理,轉(zhuǎn)發(fā),和負(fù)載均衡的服務(wù)器,也可以用于分布式,下面這篇文章主要給大家介紹了關(guān)于Nginx如何配置根據(jù)路徑轉(zhuǎn)發(fā)的相關(guān)資料,文中通過(guò)實(shí)例代碼介紹的非常詳細(xì),需要的朋友可以參考下2022-07-07
這篇文章主要介紹了使用Nginx限制百度蜘蛛頻繁抓取的問(wèn)題,百度蜘蛛對(duì)網(wǎng)站的抓取頻率高和抓取量驟增導(dǎo)致服務(wù)器負(fù)載高，經(jīng)常收到警告信息，每分鐘允許百度蜘蛛抓取200次，超過(guò)頻率限制的返回503，對(duì)Nginx限制蜘蛛頻繁抓取相關(guān)知識(shí)感興趣的朋友一起看看吧2022-01-01
在nginx中,經(jīng)常需要因?yàn)楦鞣N原因,修改header,本文就來(lái)介紹一下header配置及修改,具有一定的參考價(jià)值,感興趣的可以了解一下2023-10-10
這篇文章主要介紹了nginx中用JSON格式記錄日志的配置示例,其實(shí)就是定義一個(gè)JSON的日志格式,然后在需要的地方調(diào)用即可,需要的朋友可以參考下2014-07-07
nginx?添加http_stub_status_module模塊
本文主要介紹了nginx?添加http_stub_status_module模塊，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2022-05-05