nginx常用配置

nginx ngx_http_core_module模块变量

示例 http://127.0.0.1/test/abc?name=zhangsan&age=18

常用

• $arg_name zhangsan
• $args name=zhangsan&age=18
• $query_string 请求 URI中的参数，与 $args相同，然而 $query_string是只读的不会改变
• $uri /test/abc
• $host 127.0.0.1
• $request_method 表示 HTTP请求的方法名，大写，如 GET、PUT、POST等
• $scheme 表示 HTTP scheme，如在请求 https://nginx.com/中表示 https
• $request_uri /test/abc?name=zhangsan&age=18
• $http_HEADER 表示当前 HTTP请求中相应头部的值。HEADER名称全小写。例如，示请求中 Host头部对应的值 用 $http_host表
• $sent_http_HEADER 表示返回客户端的 HTTP响应中相应头部的值。HEADER名称全小写。例如，用 $sent_ http_content_type表示响应中 Content-Type头部对应的值
• \(is_args 表示请求中的 URI是否带参数，如果带参数，\)is_args值为?，如果不带参数，则是空字符串
• $request_body 表示 HTTP请求中的包体，该参数只在 proxy_pass或 fastcgi_pass中有意义
• $request GET /test/abc?name=zhangsan&age=18 HTTP/1.1
• $HTTP_X_REAL_IP 表示客户端的地址
• $remote_addr 表示客户端的地址,如果有代理的话，表示代理机器的
• $remote_port 表示客户端连接使用的端口,如果有代理的话，表示代理机器的
• $remote_user 表示使用 Auth Basic Module时定义的用户名

不常用

• $limit_rate 表示当前连接的限速是多少，0表示无限速
• $nginx_version 表示当前 Nginx的版本号
• $request_filename 表示用户请求中的 URI经过 root或 alias转换后的文件路径 /usr/share/nginx/html/test/abc
• $request_body_file 表示 HTTP请求中的包体存储的临时文件名
• $request_completion 当请求已经全部完成时，其值为 “ok”。若没有完成，就要返回客户端，则其值为空字符串；或者在断点续传等情况下使用 HTTP range访问的并不是文件的最后一块，那么其值也是空字符串。
• $hostname vm_51_8_centos # nginx所在机器的名称
• $server_addr 表示服务器地址 127.0.0.1
• $server_name 表示服务器名称 127.0.0.1
• $server_port 表示服务器端口 80
• $server_protocol 表示服务器向客户端发送响应的协议，如 HTTP/1.1或 HTTP/1.0

nginx常用配置

• location的配置优先级 静态 > 正则 > 默认

注意：优先级逐级降低
= 精确匹配 1
^~ 以某个字符串开头 2
~ 区分大小写的正则匹配 3
~* 不区分大小写的正则匹配 4
!~ 区分大小写的不匹配正则 5
!~* 不区分大小写的不匹配正则 6
/ 通用匹配，任何请求都会匹配到 7

• location配置举例

 location /a {
	 default_type application/json;
	 return 200 '{"status":"success","result":"hello world"}';
 }
 location /b {
	 default_type text/html;
	 charset utf-8;
	#  add_header Content_Type 'text/html; charset=utf-8';
	 return 200 '你好，世界！';
 }
 location /c {
	 proxy_pass http://127.0.0.1:3001;
 }
location ~ ^/d/(.*)$ {
	proxy_pass http://127.0.0.1:3002/$1?$query_string;
}

/* 组判断begin */
set $is_matched 0;
// 请求头x-env: 3003
if ($http_x_env = 3003) {
	proxy_pass http://127.0.0.1:3003;
	set $is_matched 1;
}
if ($is_matched = 0) {
	// 其它操作
}
/* 组判断end */

• location下使用if的情况
  • if匹配时，if里面的语句都会执行，执行多个proxy_pass时以最后一个if的为准，其他if语句的add_header仅在当前if语句中生效。

rewrite模块指令

• break

  语法：break
  默认值：none
  使用字段：server, location, if
  完成当前设置的重写规则，停止执行其他的重写规则。
  

• if

  语法：if (condition) { … }
  默认值：none
  使用字段：server, location
  注意：尽量考虑使用trp_files代替。
  判断的条件可以有以下值：
  1. 一个变量的名称：空字符传”“或者一些“0”开始的字符串为false。
  2. 字符串比较：使用=或!=运算符
  3. 正则表达式匹配：使用~(区分大小写)和~*(不区分大小写)，取反运算!~和!~*。
  4. 文件是否存在：使用-f和!-f操作符
  5. 目录是否存在：使用-d和!-d操作符
  7. 文件、目录、符号链接是否存在：使用-e和!-e操作符
  8. 文件是否可执行：使用-x和!-x操作符  
  

• return

  语法：return code
  默认值：none
  使用字段：server, location, if
  停止处理并为客户端返回状态码。非标准的444状态码将关闭连接，不发送任何响应头。可以使用的状态码有：204，400，402-406，408，410, 411, 413, 416与500-504。如果状态码附带文字段落，该文本将被放置在响应主体。相反，如果状态码后面是一个URL，该URL将成为location头补值。没有状态码的URL将被视为一个302状态码。
  

• rewrite

  语法：rewrite regex replacement flag
  注意：rewrite外部时post body会丢失，推荐只有get方法时才考虑使用该指令，其他的用proxy_pass替代
  默认值：none
  使用字段：server, location, if
  按照相关的正则表达式与字符串修改URI，指令按照在配置文件中出现的顺序执行。可以在重写指令后面添加标记。
  注意：如果替换的字符串以http://开头，请求将被重定向，并且不再执行多余的rewrite指令。
  尾部的标记(flag)可以是以下的值：
  last - 停止处理重写模块指令，之后搜索location与更改后的URI匹配。
  break - 完成重写指令。
  redirect - 返回302临时重定向，如果替换字段用http://开头则被使用。
  permanent - 返回301永久重定向。
  

• set

  语法：set variable value
  默认值：none
  使用字段：server, location, if
  为给定的变量设置一个特定值。
  

• rewrite_log

  语法：rewrite_log on | off
  默认值：rewrite_log off
  使用字段：server, location, if
  变量：无
  启用时将在error log中记录notice级别的重写日志。
  

• uninitialized_variable_warn

  语法：uninitialized_variable_warn on|off
  默认值：uninitialized_variable_warn on
  使用字段：http, server, location, if
  控制是否记录未初始化变量的警告信息。
  

rewite规则

• 重写规则的第一部分都是一个正则表达式
  • 示例：^/images/([a-z]{2})/([a-z0-9]{5})/(.*)\.(png|jpg|gif)$
  • $1是两个小写字母组成的字符串，$2是由小写字母和0到9的数字组成的5个字符的字符串，$3将是个文件名，$4是png、jpg、gif中的其中一个。
• 重写规则的第二部分是URI
  • 示例：/data?file=$3.$4
  • 如果这个URI不匹配nginx配置的任何location，那么将给客户端返回301(永久重定向)或302(临时重定向)的状态码来表示重定向类型。该状态码可以通过第三个参数来明确指定。
• 重写规则的第三部分
  • last标记将导致重写后的URI搜索匹配nginx的其他location，最多可循环10次。如：rewrite '^/images/([a-z]{2})/([a-z0-9]{5})/(.*)\.(png|jpg|gif)$' /data?file=$3.$4 last;