Ningx 常用变量详解


共计 3087 个字符,预计需要花费 8 分钟才能阅读完成。

一、常用变量

nginx 有很多内置的变量,这些变量可以在配置文件中使用。下面是一些常见的 nginx 变量:

变量名                     定义
$arg_PARAMETER GET请求中变量名PARAMETER参数的值
$args 这个变量等于GET请求中的参数。例如,foo=123&bar=blahblah;这个变量只可以被修改
$binary_remote_addr 二进制码形式的客户端地址。
$body_bytes_sent 传送页面的字节数
$content_length 请求头中的Content-length字段。
$content_type 请求头中的Content-Type字段。
$cookie_COOKIE cookie COOKIE的值。
$document_root 当前请求在root指令中指定的值。
$document_uri 与$uri相同。
$host 请求中的主机头(Host)字段,如果请求中的主机头不可用或者空,则为处理请求的server名称(处理请求的server的server_name指令的值)。值为小写,不包含端口。
$hostname 机器名使用 gethostname系统调用的值
$http_HEADER HTTP请求头中的内容,HEADER为HTTP请求中的内容转为小写,-变为_(破折号变为下划线),例如:$http_user_agent(Uaer-Agent的值);
$sent_http_HEADER HTTP响应头中的内容,HEADER为HTTP响应中的内容转为小写,-变为_(破折号变为下划线),例如: $sent_http_cache_control, $sent_http_content_type…;
$is_args 如果$args设置,值为"?",否则为""。
$limit_rate 这个变量可以限制连接速率。
$nginx_version 当前运行的nginx版本号。
$query_string 与$args相同。
$remote_addr 客户端的IP地址。
$remote_port 客户端的端口。
$remote_user 已经经过Auth Basic Module验证的用户名。
$request_filename 当前连接请求的文件路径,由root或alias指令与URI请求生成。
$request_body 这个变量(0.7.58+)包含请求的主要信息。在使用proxy_pass或fastcgi_pass指令的location中比较有意义。
$request_body_file 客户端请求主体信息的临时文件名。
$request_completion 如果请求成功,设为"OK";如果请求未完成或者不是一系列请求中最后一部分则设为空。
$request_method 这个变量是客户端请求的动作,通常为GET或POST。包括0.8.20及之前的版本中,这个变量总为main request中的动作,如果当前请求是一个子请求,并不使用这个当前请求的动作。
$request_uri 这个变量等于包含一些客户端请求参数的原始URI,它无法修改,请查看$uri更改或重写URI。
$scheme 所用的协议,比如http或者是https,比如rewrite ^(.+)$ $scheme://example.com$1 redirect;
$server_addr 服务器地址,在完成一次系统调用后可以确定这个值,如果要绕开系统调用,则必须在listen中指定地址并且使用bind参数。
$server_name 服务器名称。
$server_port 请求到达服务器的端口号。
$server_protocol 请求使用的协议,通常是HTTP/1.0或HTTP/1.1。
$uri 请求中的当前URI(不带请求参数,参数位于args,不同于浏览器传递的args),不同于浏览器传递的request_uri的值,它可以通过内部重定向,或者使用index指令进行修改。不包括协议和主机名,例如/foo/bar.html

如果有需要,可以修改 nginx 的配置文件测试上面的变量所对应的内容。

location / {
    default_type text/plain;
    root   /usr/share/nginx/html;
    index  index.html index.htm;
    return 200 "--remote_addr:$remote_addr/n--remote_port:$remote_port/n--remote_user:$remote_user/n--host:$host/n--hostname:$hostname/n--scheme:$scheme/n--server_protocol:$server_protocol/n--request_method:$request_method/n--server_addr:$server_addr/n--server_name:$server_name/n--server_port:$server_port/n--document_root:$document_root/n--uri:$uri/n--document_uri:$document_uri/n--request_filename:$request_filename/n--request_uri:$request_uri/n--args:$args/n--query_string:$query_string/n--X-Forwarded-For:$proxy_add_x_forwarded_for/n--cookie:$cookie_COOKIE/n";
}

二、反向代理常用变量

(1)$http_host:代理服务器本身IP。

(2)$remote_addr:前一节点的IP,并不一定是用户的真实IP。

(3)$proxy_host:代理服务器请求的host,即后端服务器/源站的IP,后端服务器有可能还是代理服务器。

(4)$proxy_port:代理服务器请求的后端服务器的端口。

(5)$http_x_real_ip:获取的是前一节点的 X-Real-IP 的值。

(6)$proxy_add_x_forwarded_for:获取的是前一节点的X-Forwarded-For的值

header 设置:

 proxy_set_header Host $http_host;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 proxy_set_header X-Forwarded-Proto  $scheme;
 proxy_set_header X-Forwarded-Uri  $request_uri;

X-Forwarded-For 对应不同值:

proxy_set_header X-Forwarded-For $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

相同:当只有一层代理服务器的情况下,两者的X-Forwarded-For值一致,都是用户的真实IP。

区别:

(1)$remote_addr是前一节点的IP,并不一定是用户的真实IP。

(2)$proxy_add_x_forwarded_for 变量包含$http_x_forwarded_for$remote_addr两部分,他们之间用逗号分开。

提醒:本文发布于174天前,文中所关联的信息可能已发生改变,请知悉!

【腾讯云服务器大降价】2核4G 222元/3年 1核2G 38元/年

给TA打赏
共{{data.count}}人
人已打赏
云原生

服务器减少 Mysql 内存占用

2023-9-16 0:01:24

云原生

Mysql 忘记密码以及开启远程登录

2023-9-16 1:56:14

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索