Nginx 内置变量

nginx为了实现反向代理的需求而增加了一个ngx_http_proxy_module模块。其中proxy_set_header指令就是该模块需要读取的配置文件。在这里，所有设置的值的含义和http请求同中的含义完全相同，除了Host外还有X-Forward-For。
Host的含义是表明请求的主机名，因为nginx作为反向代理使用，而如果后端真是的服务器设置有类似防盗链或者根据http请求头中的host字段来进行路由或判断功能的话，如果反向代理层的nginx不重写请求头中的host字段，将会导致请求失败【默认反向代理服务器会向后端真实服务器发送请求，并且请求头中的host字段应为proxy_pass指令设置的服务器】。
  同理，X_Forward_For字段表示该条http请求是有谁发起的？如果反向代理服务器不重写该请求头的话，那么后端真实服务器在处理时会认为所有的请求都来在反向代理服务器，如果后端有防攻击策略的话，那么机器就被封掉了。因此，在配置用作反向代理的nginx中一般会增加两条配置，修改http的请求头：
proxy_set_header Host $http_host;
proxy_set_header X-Forward-For $remote_addr;
这里的$http_host和$remote_addr都是nginx的导出变量，可以再配置文件中直接使用。如果Host请求头部没有出现在请求头中，则$http_host值为空，但是$host值为主域名。因此，一般而言，会用$host代替$http_host变量，从而避免http请求中丢失Host头部的情况下Host不被重写的失误。

 

 

X-Forwarded-For:简称XFF头，它代表客户端，也就是HTTP的请求端真实的IP，只有在通过了HTTP 代理或者负载均衡服务器时才会添加该项。 它不是RFC中定义的标准请求头信息，在squid缓存代理服务器开发文档中可以找到该项的详细介绍。标准格式如下：X-Forwarded-For: client1, proxy1, proxy2。

 

这一HTTP头一般格式如下:

X-Forwarded-For: client1, proxy1, proxy2

其中的值通过一个 逗号+空格 把多个IP地址区分开, 最左边(client1)是最原始客户端的IP地址, 代理服务器每成功收到一个请求，就把请求来源IP地址添加到右边。 在上面这个例子中，这个请求成功通过了三台代理服务器：proxy1, proxy2 及 proxy3。请求由client1发出，到达了proxy3(proxy3可能是请求的终点)。请求刚从client1中发出时，XFF是空的，请求被发往proxy1；通过proxy1的时候，client1被添加到XFF中，之后请求被发往proxy2;通过proxy2的时候，proxy1被添加到XFF中，之后请求被发往proxy3；通过proxy3时，proxy2被添加到XFF中，之后请求的的去向不明，如果proxy3不是请求终点，请求会被继续转发。

鉴于伪造这一字段非常容易，应该谨慎使用X-Forwarded-For字段。正常情况下XFF中最后一个IP地址是最后一个代理服务器的IP地址, 这通常是一个比较可靠的信息来源。

变量名	描述
$args	请求行中的参数，同$query_string
$content_length	请求头中的Content-length字段
$content_type	请求头中的Content-Type字段
$document_root	当前请求在root指令中指定的值
$host	请求行的主机名，或请求头字段 Host 中的主机名
$proxy_host	代理的目的主机的ip
$http_referer	从哪些链接过来的请求
$http_user_agent	客户端agent信息
$http_cookie	客户端cookie信息
https	是否开启了 https ，是则返回 on ，否则返回空
$is_args	URL 中是否有参数，有的话返回 ? ，否则返回空
$limit_rate	可以限制连接速率的变量
$request_method	客户端请求的动作，如GET或POST
$remote_addr	客户端的IP地址
$remote_port	客户端的端口
$remote_user	已经经过Auth Basic Module验证的用户名
$request_filename	磁盘文件系统待访问文件的完整路径
$scheme	HTTP方法（如http，https）
$server_protocol	请求使用的协议，如HTTP/1.0或HTTP/1.1
$server_addr	服务器地址
$server_name	服务器名称
$server_port	请求到达服务器的端口号
$request_uri	包含请求参数的原始URI
$uri	不带请求参数的当前URI
$document_uri	与$uri相同