当前位置：首页 > news >正文

使用 Nginx 配置真实 IP 地址转发

news 2025/6/19 1:27:49

使用 Nginx 配置真实 IP 地址转发

在许多 web 应用程序中，获取客户端的真实 IP 地址非常重要，尤其是在使用反向代理服务器（如 Nginx）时。本文将指导你如何在 Nginx 中配置 X-Real-IP 和 X-Forwarded-For 头部，以确保你的后端应用能够获取到真实的客户端 IP 地址。

1. 安装 Nginx

如果尚未安装 Nginx，可以使用以下命令进行安装：

# 对于 Ubuntu/Debian 系统
sudo apt update
sudo apt install nginx# 对于 CentOS/RHEL 系统
sudo yum install epel-release
sudo yum install nginx

2. 配置 Nginx

打开 Nginx 的配置文件，通常路径为 /etc/nginx/nginx.conf 或 /etc/nginx/sites-available/default。使用以下命令打开文件：

sudo nano /etc/nginx/nginx.conf

在 server 块中添加或修改以下内容：

server {listen 80;  # 或者 443，取决于你的需求server_name your_domain.com;  # 替换为你的域名或 IP 地址location / {proxy_pass http://your_backend;  # 替换为你的后端服务地址proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;  # 设置 X-Real-IPproxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  # 设置 X-Forwarded-Forproxy_set_header X-Forwarded-Proto $scheme;}
}

3. 测试配置

在保存配置文件后，确保配置没有错误。使用以下命令进行测试：

sudo nginx -t

如果输出显示没有错误，可以继续进行下一步。

4. 重新加载 Nginx

测试无误后，重新加载 Nginx 配置以使更改生效：

sudo systemctl reload nginx

5. 验证配置

在你的后端应用中，使用以下代码来获取客户端的真实 IP 地址（假设你使用 Go 语言）：

func GetIP(r *http.Request) (string, error) {ip := r.Header.Get("X-Real-IP")if net.ParseIP(ip) != nil {return ip, nil}ip = r.Header.Get("X-Forwarded-For")for _, i := range strings.Split(ip, ",") {if net.ParseIP(i) != nil {return i, nil}}ip, _, err := net.SplitHostPort(r.RemoteAddr)if err != nil {return "", err}if net.ParseIP(ip) != nil {return ip, nil}return "", errors.New("no valid ip found")
}