Nginx核心模块内置变量

2023-05-16

本文根据Nginx官网整理了Nginx的ngx_http_core_module模块的内置变量,可与Apache做对比参考。随后做了一次测试观察各变量的值,并附上测试结果。

1.变量列表

$arg_name    请求行中参数name的值。

$args    请求行中的所有参数。

$binary_remote_addr    客户端地址的二进制形式。

$body_bytes_sent    发送给客户端的字节数,不包含响应头的内容,与Apache的mod_log_config模块中的%B兼容。

$bytes_sent    发送给客户端的字节数(1.3.8, 1.2.5)。

$connection    连接序列号(1.3.8,1.2.5)(有人说是TCP连接的序列号,但在1.6.2上抓包观察却不是)

$connection_requests    当前连接的请求数(1.3.8,1.2.5)。

$content_length    请求头中的Content-Length值。

$content_type    请求头中的Content-Type值。

$cookie_name    名为name的cookie值。

$document_root    当前请求的根目录或别名。

$document_uri    同$uri

$host    按如下顺序取值:请求的主机名,请求头的Host值,匹配的服务器名。

$hostname    服务器主机名。

$http_name    该变量的最后一部分是请求头中的字段名称转换为小写,破折号由下划线替换而来。比如使用$http_content_encoding获取Content-Encoding的值。

$https    如果使用SSL模式连接,则值为on,否则为空字符串。

$is_args    如果请求行中带有参数,则值为?,否则为空字符串。

$limit_rate    设置的响应速度。

$msec    精确到毫秒的当前时间(1.3.9, 1.2.6)。

$nginx_version    nginx版本。

$pid    进程PID。

$pipe    如果请求来自管道,则值为p,否则为.。

$proxy_protocol_addr    来自代理协议头的客户端地址,否则为空字符串(1.5.12)。必须先通过在listen指令中设置proxy_protocol参数来启用代理协议。

$proxy_protocol_port    代理服务器端口(1.11.0)。同样需要使用proxy_protocol启用代理。

$query_string    同$args

$realpath_root    当前请求的根目录或别名的绝对路径,所有符号链接将解析为实际路径。

$remote_addr    客户端地址。

$remote_port    客户端端口。

$remote_user    基本身份认证使用的用户名。

$request    完整的请求行。

$request_body    请求体。当请求体被读取到内存缓冲区时,变量的值在proxy_pass,fastcgi_pass,uwsgi_pass和scgi_pass指令处理的位置可用。

$request_body_file    请求体的临时文件的名称。在处理结束时,需要删除该文件。若要始终将请求主体写入文件,需要启用client_body_in_file_only。当在代理请求或对FastCGI / uwsgi / SCGI服务器的请求中传递临时文件的名称时,应分别通过proxy_pass_request_body off,fastcgi_pass_request_body off,uwsgi_pass_request_body off或scgi_pass_request_body off指令禁用传递请求体。

$request_completion    一次请求结束时值为OK,否则为空字符串。

$request_filename    当前请求的文件路径,由根路径或别名和请求URI组成。

$request_id    16个随机字节生成的唯一请求标识符,用十六进制表示(1.11.0)。

$request_length    请求长度(包括请求行,请求头和请求体)(1.3.12,1.2.7)。

$request_method    请求方法,通常是GET或POST。

$request_time    发出请求时的时间戳。官方说是处理请求所花费的时间(1.3.9,1.2.6)。

$request_uri    完整的原始请求URI(包含参数)。

$scheme    请求协议,http或https。

$sent_http_name    显示自定义的响应头字段,变量名称的最后一部分是字段名称转换为小写,短划线由下划线替换。用法与$http_name类似。

$sent_trailer_name    在响应结束时发送的任意字段(1.13.2),变量名称的最后一部分是字段名称转换为小写,破折号由下划线替换。

$server_addr    接受请求的服务器的地址。计算此变量的值通常需要一次系统调用。为避免系统调用,listen指令必须指定地址并使用bind参数。

$server_name    服务器名。

$server_port    服务器端口。

$server_protocol    请求协议,通常是HTTP/1.0、HTTP/1.1或HTTP/2.0。

$status    响应状态(1.3.2,1.2.2)。

$tcpinfo_rtt$tcpinfo_rttvar$tcpinfo_snd_cwnd$tcpinfo_rcv_space    有关客户端TCP连接的信息,在支持TCP_INFO套接字选项的系统上可用。

$time_iso8601    ISO 8601标准格式的本地时间(1.3.12,1.2.7)。

$time_local    通用日志格式的本地时间(1.3.12,1.2.7)。

$uri    当前请求的URI。$uri的值可能在请求处理期间发生变化,例如在进行内部重定向或使用索引文件时。

 

2.测试

大致过程如下:

准备好nginx和php环境,使用fastcgi_param将nginx变量传递给php,在php中设置好cookie,最后通过前端页面将结果输出。

本次测试将test.com域名与服务器IP绑定,使用Postman发送GET请求,访问地址是http://test.com:89/var.php?name=Tom&age=20,并添加一个Header字段Name:Bob。

测试结果如下: 

VariableValue
$arg_nameTom
$argsname=Tom&age=20
$binary_remote_addr\xC0\xA8e8
$body_bytes_sent0
$bytes_sent0
$connection527
$connection_requests1
$content_length 
$content_type 
$cookie_nameTommy
$document_root/var/www
$document_uri/var.php
$hosttest.com
$hostnamedebian8
$http_nameBob
$https 
$is_args?
$limit_rate0
$msec1532076179.430
$nginx_version1.6.2
$pid32229
$pipe.
$proxy_protocol_addr 
$proxy_protocol_port 
$query_stringname=Tom&age=20
$realpath_root/var/www
$remote_addr192.168.101.56
$remote_port11164
$remote_user 
$requestGET /var.php?name=Tom&age=20 HTTP/1.1
$request_body 
$request_body_file 
$request_completion 
$request_filename/var/www/var.php
$request_id 
$request_length281
$request_methodGET
$request_time1532076179
$request_uri/var.php?name=Tom&age=20
$schemehttp
$sent_http_name 
$sent_trailer_name 
$server_addr192.168.100.64
$server_nametest.com
$server_port89
$server_protocolHTTP/1.1
$status000
$tcpinfo_rtt4000
$tcpinfo_rttvar2000
$tcpinfo_snd_cwnd10
$tcpinfo_rcv_space29200
$time_iso86012018-07-20T16:42:59+08:00
$time_local20/Jul/2018:16:42:59 +0800
$uri/var.php


 上述测试只是直接访问Web服务器的结果,没有使用代理,nginx也没有做额外的设置,仅供参考。

注:

1. 前端$status的值是000,后端输出的是200;

2. 1.6.2版本中的$proxy_protocol_port、$request_id和$sent_trailer_name三个变量不能使用。

--------------------------------------------------

参考资料:

1. nginx官网;

2. 《nginx内置变量》。

转载于:https://www.cnblogs.com/liuguanglin/p/9341400.html

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

Nginx核心模块内置变量 的相关文章

  • X-FRAME-OPTIONS: DENY 通过 nginx 来自 Django 站点在哪里?

    我的 Django 网站使用django summernote https github com summernote django summernote在 iframe 中 并抛出此错误 多个具有冲突值的 X Frame Options
  • 使用 nginx 代理时在 RStudio 中运行闪亮的应用程序

    我正在尝试使用通过 nginx 代理的 RStudio 服务器来开发一个闪亮的应用程序 当我使用 RStudio 而不是服务器 来运行闪亮的应用程序时 一切正常 但是 当我通过代理 RStudio 运行时 该应用程序出现在 查看器 窗格中
  • 为什么要使用 Node.js 安装服务器(Nginx、Apache...)? [复制]

    这个问题在这里已经有答案了 可能的重复 为什么 Node js Express Web 框架下需要 apache https stackoverflow com questions 9287747 why do we need apache
  • 验证来自两个不同 URL 的 Keycloak 令牌

    我有一个Docker compose具有后端和前端组件的基于系统 后端写的是Python Flask并在多个 docker 容器中运行 前端编写为TypeScript with Angular 前端通过Restful API与后端进行通信
  • ./manage.py 使用 https 运行服务器

    manage py 运行服务器 0 0 0 0 8000 我使用上面的行作为我从 github 借用的代码的一部分 https github com ribeiroit boh puppet https github com ribeiro
  • NGINX 与 Tomcat 配置

    我是 Nginx 新手 我需要你的帮助 根据很多论坛我了解到我们所有的静态页面都存储在Nginx中 当有请求到来时 我必须将该请求传递给 tomcat 获取数据 并在 tomcat 生成响应后生成响应 目前 我刚刚做到了 我将请求直接传递给
  • 上传大文件(几 GB)时,nginx 返回内部服务器错误

    我在 nginx 后面有一个 Artifactory 上传大于 4 GB 的文件失败 我相当确定这是 nginx 的错误 因为如果文件从本地主机上传 上传到本地主机 则不会出现问题 nginx 设置为client max body size
  • Nginx 正在向 uWSGI 发出非常旧的请求?

    我看到一种奇怪的情况 Nginx 或 uwsgi 似乎正在建立一个很长的传入请求队列 并在客户端连接超时后很长时间内尝试处理它们 我想理解并停止这种行为 以下是更多信息 My Setup 我的服务器使用 Nginx 通过 Unix 文件套接
  • Node + Express + Nginx 未设置 Cookie

    我有一个使用 Express 的 Node 应用程序 我尝试为我的客户端设置 cookie 它在本地环境 http 上运行良好 但是一旦我投入生产 https 我就很好地收到了cookie 我可以在响应中看到它 但它没有设置 任何想法 Ng
  • 当请求太大时,Nginx(我认为)会以错误的权限保存文件

    所以 我对托管和 Linux 等都是完全陌生的 所以如果我说错了 请原谅我 我还在学习 我正在使用 Django 创建一个小型个人网站 我想把它放到网上看看是否一切正常 我从 linode 买了一台便宜的服务器 并使用 Digital Oc
  • nginx - 记录 SSL 握手失败

    我正在运行启用了 SSL 的 nginx 服务器 我的协议 密码设置相当安全 我已经在 ssllabs com 上检查过它们 但是 因为这是一个由我无法控制的 http 客户端调用的 Web 服务 所以我担心兼容性 重点是 有没有办法在我的
  • NGinx 域名重定向

    假设我有一个名为 xyz co 的网站 我还有其他具有相同前缀的域名 例如 xyz com xyz it xyz co it 现在 nginx 与端口 80 的 nginx conf 中的 server name xyz co 配合得很好
  • Nginx 中 uwsgi_pass 和 proxy_pass 的区别?

    我在 Nginx 后面运行 uWSGI 并一直在使用proxy pass让 Nginx 访问 uWSGI 切换到有什么好处吗uwsgi pass 如果是这样 那是什么 uwsgi pass使用一个uwsgi协议 proxy pass使用普通
  • 如何在位置中使用 Nginx Regexp

    Web 项目将静态内容放入 some content img 文件夹中 url规则为 img some md5 但文件夹中的位置 content img 前两位数字 Example url example com img fe5afe048
  • 如何在运行 NGINX Docker 容器的 AWS EC2 上启用 HTTPS?

    我在 AWS 上有一个运行 Amazon Linux 2 的 EC2 实例 在上面 我安装了 Git docker 和 docker compose 完成后 我克隆了我的存储库并运行docker compose up让我的生产环境启动 我访
  • 我可以在 Nginx Conf 中添加多少个服务器块

    知道我可以在 Nginx 配置中添加多少个服务器块吗 我需要将它用于具有多个子域的反向代理 每个客户端一个子域 它能成功支持 10 000 个服务器块吗 有没有相关的基准研究 这实际上并不是一个你有多少人的问题can但你有多少 能够妥善处理
  • nginx server_name 在流块内可能吗?

    目前设置如下 stream server listen 9987 udp server name subdomain EXAMPLE com this line is resulting in an error proxy pass loc
  • 将代码从 htaccess 重写为 nginx 配置?

    我在将 htaccess 文件中的重写代码实现到 nginx 配置中时遇到问题 我已经尝试过生成器 http winnginx com htaccess http winginx com htaccess用于生成我的重写 代码 我的ngin
  • nginx代理认证拦截

    我有几个服务 它们支持 nginx 实例 为了处理身份验证 在 nginx 中 我拦截每个请求并将其发送到身份验证服务 在那里 如果凭据正确 我将设置一个包含用户相关信息的 cookie 现在 请求应该被路由到适当的服务 并设置 cooki
  • Rails/Nginx 中的超时——最佳实践

    我正在开发一个应该在 Nginx 服务器上运行的 Rails 应用程序 根据输入 应用程序可能需要很长时间来处理请求 或者在出现错误时挂起 因此我想防止进程永远运行 除了确保客户端收到超时信号的 Nginx 配置之外 我想我可能仍然需要确保

随机推荐