快捷導(dǎo)航

Nginx中IP地址透傳的應(yīng)用實(shí)現(xiàn)

更新時(shí)間：2025年12月05日 09:26:34 作者：siriuuus

Nginx的IP地址透傳功能能夠在反向代理場景下保留和傳遞客戶端真實(shí)IP地址,通過配置proxy_set_header指令,設(shè)置X-Real-IP和X-Forwarded-For等頭部字段,可將客戶端IP信息傳遞給后端服務(wù)器,感興趣的可以了解一下

一、簡介

Nginx的IP地址透傳是一個(gè)在網(wǎng)絡(luò)傳輸中保留和傳遞源IP地址和目標(biāo)IP地址的功能。IP透傳，即IP透明傳輸，是指在網(wǎng)絡(luò)傳輸過程中，源IP地址和目標(biāo)IP地址能夠完整地保留和傳遞，中間的網(wǎng)絡(luò)設(shè)備（如代理服務(wù)器、負(fù)載均衡器等）不會修改這些IP地址。

二、應(yīng)用場景

記錄真實(shí)客戶端IP地址的日志：在Nginx作為反向代理服務(wù)器時(shí)，默認(rèn)情況下，后端服務(wù)器只能看到Nginx的IP地址，而無法看到客戶端的真實(shí)IP地址。通過IP透傳，后端服務(wù)器可以記錄客戶端的真實(shí)IP地址，便于日志分析和問題排查。
訪問控制：在一些應(yīng)用場景中，需要根據(jù)客戶端的IP地址進(jìn)行訪問控制。通過IP透傳，可以確保后端服務(wù)器能夠獲取到客戶端的真實(shí)IP地址，從而進(jìn)行準(zhǔn)確的訪問控制。

三、配置參數(shù)

server {
  listen 80;
  server_name example.com;
  location / {
  # 用于記錄客戶端的真實(shí)IP地址。
  proxy_set_header X-Real-IP $remote_addr;
  # 用于記錄經(jīng)過的代理服務(wù)器的IP地址列表，最左邊的為客戶端IP，右邊為經(jīng)過的代理服務(wù)器IP
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  # 用于記錄原始請求的協(xié)議（http或https）
  proxy_set_header X-Forwarded-Proto $scheme;
  }
}

四、簡單實(shí)踐

1、角色分配

角色	IP	系統(tǒng)
Client	10.0.0.15	Rocky9
Proxy Server	10.0.0.114	Ubuntu24
Real Server	10.0.0.118	openEuler

2、未透傳實(shí)踐

默認(rèn)情況下，后端真實(shí)服務(wù)器無法獲取真實(shí)客戶端IP

查看 Proxy Server 配置 /etc/nginx/conf.d/vhost.conf

修改后端 Real Server 配置 /etc/nginx/default.d/simple.conf

location / {
  return 200 "客戶端：\${remote_addr}---真實(shí)ip: \${http_x_real_ip}----地址列
表:\${http_x_forwarded_for}\n";
}

重啟 nginx 并查看效果，后端服務(wù)器只能獲取代理服務(wù)器IP

3、透傳配置

修改代理服務(wù)器配置 /etc/nginx/conf.d/vhost.conf ，透傳真實(shí)客戶端IP，location塊增加 proxy_set_header X-Real-IP \$remote_addr; 及 proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;

server {
  listen 80 default_server;
  server_name ubuntu.test.com;
  root /data/server/nginx/web1;

  location /static {
  rewrite ^/static(.*)\$ /index.html break; # 重寫url
  proxy_pass http://10.0.0.118;
  proxy_set_header Host "openEuler.test.com";

  # 將客戶端IP追加請求報(bào)文中X-Real-IP,記錄客戶端的真實(shí)IP地址。
  proxy_set_header X-Real-IP \$remote_addr;
  # 將客戶端IP追加請求報(bào)文中X-Forwarded-For首部字段
  proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
  }
}