
1. nginx中的常见变量
1.1 获取请求(Request)内容
- 获取请求主机
$host
- 获取请求路径
$request_uri
:path+queryString$uri
:path`
- 获取请求header
$http_X_Role
:request header中的X-Role$http_clientType
:request header中的clientType
- 获取请求参数
$args
:queryString$arg_dateFrom
:queryString中的dateFrom参数$arg_count
:queryString中的count参数
1.2 获取响应(Response)内容
- upstream:真正提供服务的主机
$upstream_addr
:upstream的地址,即真正提供服务的主机地址$upstream_response_time
:请求过程中,upstream的响应时间$uptream_status
:upstream状态,比如成功是200
- 获取请求header
$upstream_http_x_cache
:response header中的X-Cache$sent_http_content_type
:response header中的content-type
1.3 注意事项
- 如果获取不到自定义的header参数,可以尝试添加:
underscores_in_headers on;
作用:nginx是支持读取非nginx标准的用户自定义header的,但是需要在http或者server下开启header的下划线支持 - 获取response header中的内容时,如果
$sent_
前缀取不到内容,可以尝试:$upstream_
前缀
常见参数附录:
本节内容转载自:Nginx 常用全局变量 及Rewrite规则详解
另外,可以参考:在Nginx中记录自定义Header
$remote_addr //获取客户端ip
$binary_remote_addr //客户端ip(二进制)
$remote_port //客户端port,如:50472
$remote_user //已经经过Auth Basic Module验证的用户名
$host //请求主机头字段,否则为服务器名称,如:blog.sakmon.com
$request //用户请求信息,如:GET ?a=1&b=2 HTTP/1.1
$request_filename //当前请求的文件的路径名,由root或alias和URI request组合而成,如:/2013/81.html
$status //请求的响应状态码,如:200
$body_bytes_sent // 响应时送出的body字节数数量。即使连接中断,这个数据也是精确的,如:40
$content_length // 等于请求行的“Content_Length”的值
$content_type // 等于请求行的“Content_Type”的值
$http_referer // 引用地址
$http_user_agent // 客户端agent信息,如:Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.76 Safari/537.36
$args //与$query_string相同 等于当中URL的参数(GET),如a=1&b=2
$document_uri //与$uri相同 这个变量指当前的请求URI,不包括任何参数(见$args) 如:/2013/81.html
$document_root //针对当前请求的根路径设置值
$hostname //如:centos53.localdomain
$http_cookie //客户端cookie信息
$cookie_COOKIE //cookie COOKIE变量的值
$is_args //如果有$args参数,这个变量等于”?”,否则等于”",空值,如?
$limit_rate //这个变量可以限制连接速率,0表示不限速
$query_string // 与$args相同 等于当中URL的参数(GET),如a=1&b=2
$request_body // 记录POST过来的数据信息
$request_body_file //客户端请求主体信息的临时文件名
$request_method //客户端请求的动作,通常为GET或POST,如:GET
$request_uri //包含请求参数的原始URI,不包含主机名,如:/2013/81.html?a=1&b=2
$scheme //HTTP方法(如http,https),如:http
$uri //这个变量指当前的请求URI,不包括任何参数(见$args) 如:/2013/81.html
$request_completion //如果请求结束,设置为OK. 当请求未结束或如果该请求不是请求链串的最后一个时,为空(Empty),如:OK
$server_protocol //请求使用的协议,通常是HTTP/1.0或HTTP/1.1,如:HTTP/1.1
$server_addr //服务器IP地址,在完成一次系统调用后可以确定这个值
$server_name //服务器名称,如:blog.sakmon.com
$server_port //请求到达服务器的端口号,如:80
2. 在nginx中为Request或Response添加header
2.1 为Request添加header
- 如果是在nginx中自定义的header,则采用
proxy_set_header X_CUSTOM_HEADER $http_host
- 如果是在用户请求时自定义的header,则需要通过
proxy_pass_header X_CUSTOM_HEADER
来传递
2.2 为Response添加header
- 使用
add_header key value
- 如:
add_header Cache-Control no-store
- 如:
add_header X-Cache '$upstream_cache_status from $host'
参考:
- Nginx获取自定义头部header的值
- nginx add header 指令
人吐槽 | 人点赞 |
发表评论