1. nginx中的常见变量

1.1 获取请求（Request）内容

1. 获取请求主机
   
   • $host
2. 获取请求路径
   
   • $request_uri：path+queryString
   • $uri：path`
3. 获取请求header
   
   • $http_X_Role：request header中的X-Role
   • $http_clientType：request header中的clientType
4. 获取请求参数
   
   • $args：queryString
   • $arg_dateFrom：queryString中的dateFrom参数
   • $arg_count：queryString中的count参数

1.2 获取响应（Response）内容

1. upstream：真正提供服务的主机
   
   • $upstream_addr：upstream的地址，即真正提供服务的主机地址
   • $upstream_response_time：请求过程中，upstream的响应时间
   • $uptream_status：upstream状态，比如成功是200
2. 获取请求header
   
   • $upstream_http_x_cache：response header中的X-Cache
   • $sent_http_content_type：response header中的content-type

1.3 注意事项

1. 如果获取不到自定义的header参数，可以尝试添加：
   underscores_in_headers on;
   作用：nginx是支持读取非nginx标准的用户自定义header的，但是需要在http或者server下开启header的下划线支持
2. 获取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'

参考：

1. Nginx获取自定义头部header的值
2. nginx add header 指令

文章来源: nginx网关配置笔记

人吐槽

人点赞

发表评论