一、location用法总结

location可以把不同方式的请求,定位到不同的处理方式上.

1、location的用法

  1. location ~* /js/.*/\.js
  2. = 开头,表示精确匹配;如只匹配根目录结尾的请求,后面不能带任何字符串。
  3. 以^~ 开头,表示uri以某个常规字符串开头,不是正则匹配
  4. 以~ 开头,表示区分大小写的正则匹配;
  5. 以~* 开头,表示不区分大小写的正则匹配
  6. 以/ 开头,通用匹配, 如果没有其它匹配,任何请求都会匹配到

location 的匹配顺序是“先匹配正则,再匹配普通”。
原因是:正则匹配会覆盖普通匹配。

2、location用法举例

  • 精确匹配 /

主机名后面不能带任何字符串

  1. location = / {
  2. [ configuration A ]
  3. }

nginx location rewrite 用法区别 - 图1


所有的地址都以 / 开头

所以这条规则将最后匹配到默认请求
但是正则和最长字符串会优先匹配

  1. location / {
  2. [ configuration B ]
  3. }
  4. 例:
  5. location / {
  6. proxy_pass http://server_pools;
  7. }
  8. #这条规则只有其他不符合要求才能匹配到;将是最后匹配到的,匹配度最低,上面实现的功能是:比如网站是www.blog.com;后面什么都不输入的时候,
  9. 其他的规则也不匹配的时候,最后交给负载均衡池的服务器

匹配任何以 /documents/ 开头的地址

匹配符合以后,还要继续往下搜索# 只有后面的正则表达式没有匹配到时,这一条才会采用这一条

location /documents/ {
[ configuration C ]
}

  1. 例:
  2. location /static/
  3. {
  4. rewrite ^ http://www.abc.com ;
  5. }
  6. #上面实现的功能:假设网站域名为www.blog.com;那么配置上面的功能是输入www.blog.com/static/时,不管static后面是什么页面(页面也可以不存在),
  7. 那么最终会同样跳转到www.abc.com这个网站。

匹配任何以 /documents/ 开头的地址

匹配符合以后,还要继续往下搜索# 只有后面的正则表达式没有匹配到时,这一条才会采用这一条

location ~ /documents/Abc {
[ configuration CC ]
}


匹配任何以 /images/ 开头的地址

匹配符合以后,停止往下搜索正则,采用这一条。

location ^~ /images/ {
[ configuration D ]
}


匹配所有以 gif,jpg或jpeg 结尾的请求

# 然而,所有请求 /images/ 下的图片会被 config D 处理,因为 ^~ 到达不了这一条正则

location ~* .(gif|jpg|jpeg)$ {
[ configuration E ]
}
例:
nginx location rewrite 用法区别 - 图2


字符匹配到 /images/

继续往下,会发现 ^~ 存在

location /images/ {
[ configuration F ]
}


最长字符匹配到 /images/abc

继续往下,会发现 ^~ 存在# F与G的放置顺序是没有关系的
location /images/abc {
[ configuration G ]
}


只有去掉 config D 才有效:先最长匹配 config G 开头的地址,

继续往下搜索,匹配到这一条正则,采用

location ~ /images/abc/ {
[ configuration H ]
}


匹配顺序优先级
(location =) > (location 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (/)

  1. 上面的匹配结果:
  2. 按照上面的location写法,以下的匹配示例成立:
  3. / -> config A
  4. 精确完全匹配,即使/index.html也匹配不了
  5. /downloads/download.html -> config B
  6. 匹配B以后,往下没有任何匹配,采用B
  7. /images/1.gif -> configuration D
  8. 匹配到F,往下匹配到D,停止往下
  9. /images/abc/def -> config D
  10. 最长匹配到G,往下匹配D,停止往下
  11. 你可以看到 任何以/images/开头的都会匹配到D并停止,FG写在这里是没有任何意义的,H是永远轮不到的,这里只是为了说明匹配顺序
  12. /documents/document.html -> config C
  13. 匹配到C,往下没有任何匹配,采用C
  14. /documents/1.jpg -> configuration E
  15. 匹配到C,往下正则匹配到E
  16. /documents/Abc.jpg -> config CC
  17. 最长匹配到C,往下正则顺序匹配到CC,不会往下到E

3、实际使用建议

所以实际使用中,个人觉得至少有三个匹配规则定义,如下:

  1. #直接匹配网站根,通过域名访问网站首页比较频繁,使用这个会加速处理,官网如是说。
  2. #这里是直接转发给后端应用服务器了,也可以是一个静态首页
  3. # 第一个必选规则location = / {
  4. proxy_pass http://tomcat:8080/index
  5. }
  6. # 第二个必选规则是处理静态文件请求,这是nginx作为http服务器的强项
  7. # 有两种配置模式,目录匹配或后缀匹配,任选其一或搭配使用
  8. location ^~ /static/ {
  9. root /webroot/static/;
  10. }
  11. location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
  12. root /webroot/res/;
  13. }
  14. #第三个规则就是通用规则,用来转发动态请求到后端应用服务器
  15. #非静态文件请求就默认是动态请求,自己根据实际把握#毕竟目前的一些框架的流行,带.php,.jsp后缀的情况很少了
  16. location / {
  17. proxy_pass http://tomcat:8080/
  18. }

二、Rewrite用法总结

1、rewrite的定义

rewrite功能就是使用nginx提供的全局变量或自己设置的变量,结合正则表达式和标志位实现url重写以及重定向。
rewrite只能放在 server{}, location{}, if{}中,并且只能对域名后边的除去传递的参数外的字符串起作用。
例如 http://seanlook.com/a/we/index.php?id=1&u=str 只对/a/we/index.php重写。

2、rewirte的 语法

rewrite regex replacement [flag];

如果相对域名或参数字符串起作用,可以使用全局变量匹配,也可以使用proxy_pass反向代理。
很多情况下rewrite也会写在location里,它们的执行顺序是:

  • 1 、执行server块的rewrite指令
  • 2 、执行location匹配
  • 3 、执行选定的location中的rewrite指令


如果其中某步URI被重写,则重新循环执行1-3,直到找到真实存在的文件;循环超过10次,则返回500 Internal Server Error错误。

  1. flag标志位
  2. last : 相当于Apache的[L]标记,表示完成rewrite
  3. break : 停止执行当前虚拟主机的后续rewrite指令集
  4. redirect : 返回302临时重定向,地址栏会显示跳转后的地址
  5. permanent : 返回301永久重定向,地址栏会显示跳转后的地址
  6. 因为301302不能简单的只返回状态码,还必须有重定向的URL,这就是return指令无法返回301,302的原因了。
  7. 这里 last break 区别有点难以理解:
  8. last一般写在serverif中,而break一般使用在location
  9. last不终止重写后的url匹配,即新的url会再从server走一遍匹配流程,而break终止重写后的匹配
  10. breaklast都能组织继续执行后面的rewrite指令

3、rewrite常用正则

  • . : 匹配除换行符以外的任意字符
  • ? : 重复0次或1次
    • : 重复1次或更多次
    • : 重复0次或更多次
  • \d :匹配数字
  • ^ : 匹配字符串的开始
  • $ : 匹配字符串的结束
  • {n} : 重复n次
  • {n,} : 重复n次或更多次
  • [c] : 匹配单个字符c
  • [a-z] : 匹配a-z小写字母的任意一个
  • 小括号()之间匹配的内容,可以在后面通过$1来引用,$2表示的是前面第二个()里的内容。正则里面容易让人困惑的是\转义特殊字符。

rewrite实例

  1. 1
  2. http {
  3. # 定义image日志格式
  4. log_format imagelog '[$time_local] ' $image_file ' ' $image_type ' ' $body_bytes_sent ' ' $status;
  5. # 开启重写日志
  6. rewrite_log on;
  7. server {
  8. root /home/www;
  9. location / {
  10. # 重写规则信息
  11. error_log logs/rewrite.log notice;
  12. # 注意这里要用‘’单引号引起来,避免{}
  13. rewrite '^/images/([a-z]{2})/([a-z0-9]{5})/(.*)\.(png|jpg|gif)$' /data?file=$3.$4;
  14. # 注意不能在上面这条规则后面加上“last”参数,否则下面的set指令不会执行
  15. set $image_file $3;
  16. set $image_type $4;
  17. }
  18. location /data {
  19. # 指定针对图片的日志格式,来分析图片类型和大小
  20. access_log logs/images.log mian;
  21. root /data/images;
  22. # 应用前面定义的变量。判断首先文件在不在,不在再判断目录在不在,如果还不在就跳转到最后一个url里
  23. try_files /$arg_file /image404.html;
  24. }
  25. location = /image404.html {
  26. # 图片不存在返回特定的信息
  27. return 404 "image not found\n";
  28. }
  29. }
  30. 对形如/images/ef/uh7b3/test.png的请求,重写到/data?file=test.png,于是匹配到location /data,先看/data/images/test.png文件存不存在,如果存在则正常响应,如果不存在则重写tryfiles到新的image404 location,直接返回404状态码。
  31. 2
  32. rewrite ^/images/(.*)_(\d+)x(\d+)\.(png|jpg|gif)$ /resizer/$1.$4?width=$2&height=$3? last;
  33. 对形如/images/bla_500x400.jpg的文件请求,重写到/resizer/bla.jpg?width=500&height=400地址,并会继续尝试匹配location

三、location与rewrite的异同

1、区别

  • rewrite是在同一域名内更改获取资源的路径
  • location是对一类路径做控制访问或反向代理,可以proxy_pass到其他机器

    2、相同

从上表明看rewrite和location功能有点像,都能实现跳转。