Nginx $remote_addr 和 $proxy_add_x_forwarded_for 变量详解

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [mp.weixin.qq.com](https://mp.weixin.qq.com/s/AbImqt6ExjTqP2AKhdCgKg)

### $remote_addr

代表客户端 IP。注意，这里的客户端指的是直接请求 Nginx 的客户端，非间接请求的客户端。假设用户请求过程如下：

```
用户客户端--发送请求->Nginx1 --转发请求-->Nginx2->后端服务器

```

那么，默认情况下，针对 Nginx1 而言，`$remote_addr`为用户客户端 IP，对 Nginx2 而言，`$remote_addr`则为 Nginx1 的 IP。此时如果希望 Nginx2 也可以获取用户客户端 IP，那要怎么处理呢？答案如下：

在 Nginx1 配置文件中使用`proxy_set_header`为转发请求设置请求头

```
proxy_set_header X-Real-IP $remote_addr; // X-Real-IP 为请求头名称，可自定义

```

然后，在 Nginx2 配置文件中通过`$http_x_real_ip`来获取`X-Real-IP`请求头的值来获取真实客户端 IP.

此时，如果要求 “后端服务器” 也要获取用户客户端 IP，咋处理呢？做法和上述类似，在 Nginx2 配置文件中，使用`proxy_set_header`做同样的配置，即：

```
proxy_set_header X-Real-IP $remote_addr;

```

然后，“后端服务器”获取请求头 “X-Real-IP” 的值即为用户客户端 IP。

很多 HTTP 代理会在 HTTP 协议头中添加`X-Forwarded-For`头，用来追踪请求的来源。`X-Forwarded-For`的格式如下：

`X-Forwarded-For`包含多个 IP 地址，每个值通过逗号 + 空格分开，最左边（client1）是最原始客户端的 IP 地址，中间如果有多层代理，每一层代理会将连接它的客户端 IP 追加在`X-Forwarded-For`右边。

### $proxy_add_x_forwarded_for

代表附加`$remote_addr`变量的客户端请求头`X-Forwarded-For` ，其值如果包含多个地址，用逗号 + 空格分隔，标准格式如下：

```
X-Forwarded-For: clientIP, proxyIP1, proxyIP2 # 最左边的clientIp即为客户端真实IP

```

如果`X-Forwarded-For`字段没出现在客户端请求头，`$proxy_add_x_forwarded_for` 等同于`$remote_addr` 变量。

这里，假设用户请求过程和上文所述一样，如下：

```
用户客户端--发送请求->Nginx1 --转发请求-->Nginx2->后端服务器

```

假设，仅在 Nginx1 配置文件中进行了以下配置

```
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

```

那么，Nginx2 配置的`X-Forwarded-For`请求头的值即为`clientIP`，**当然，这个结论的前提是，客户端 IP 没有配置`X-Forwarded-For`请求头，因为如上所述，客户端没有出现这个请求头时，`$proxy_add_x_forwarded_for` 的值即为`$remote_addr` 变量的值，否则，则是客户端为`X-forwarded-for`请求头的实际值**。

接着，假设 Nginx2 配置文件也进行以下配置

```
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

```

那么，“后端服务器” 获取的`X-Forwarded-For`请求头的值将为`clientIP, Nginx1IP`。也就是说以上命令的执行是个叠加的过程（类似 Python 的列表的`append`方法的处理过程），可以简单理解为**如果存在上级代理，执行以上命令时，会把上级代理 IP 追加到 X-Forwarded-For 请求头总，否则把客户端 IP `$remote_addr`、或者客户端`X-Forwarded-For`请求头的值 (如果有的话) 追加到 X-Forwarded-For 请求头中。**

参考连接：

https://nginx.org/en/docs/http/ngx_http_core_module.html#var_remote_addr

https://nginx.org/en/docs/http/ngx_http_proxy_module.html#var_proxy_add_x_forwarded_for