• location 匹配规则
    • 语法规则
    • rewrite 语法
    • redirect 语法
    • 防盗链
    • 根据文件类型设置过期时间
    • 禁止访问某个目录

    location 匹配规则

    语法规则

    location [=|~|~*|^~] /uri/ { … }

    模式 含义
    location = /uri = 表示精确匹配，只有完全匹配上才能生效
    location ^~ /uri ^~ 开头对URL路径进行前缀匹配，并且在正则之前。
    location ~ pattern 开头表示区分大小写的正则匹配
    location ~* pattern 开头表示不区分大小写的正则匹配
    location /uri 不带任何修饰符，也表示前缀匹配，但是在正则匹配之后
    location / 通用匹配，任何未匹配到其它location的请求都会匹配到，相当于switch中的default

    前缀匹配时，Nginx 不对 url 做编码，因此请求为 /static/20%/aa，可以被规则 ^~ /static/ /aa 匹配到（注意是空格）

    多个 location 配置的情况下匹配顺序为（参考资料而来，还未实际验证，试试就知道了，不必拘泥，仅供参考）:

    • 首先精确匹配 =
    • 其次前缀匹配 ^~
    • 其次是按文件中顺序的正则匹配
    • 然后匹配不带任何修饰的前缀匹配。
    • 最后是交给 / 通用匹配
    • 当有匹配成功时候，停止匹配，按当前匹配规则处理请求

    注意：前缀匹配，如果有包含关系时，按最大匹配原则进行匹配。比如在前缀匹配：location /dir01 与 location /dir01/dir02，如有请求 http://localhost/dir01/dir02/file 将最终匹配到 location /dir01/dir02

    例子，有如下匹配规则：

    1. location = / {
    2.    echo "规则A";
    3. }
    4. location = /login {
    5.    echo "规则B";
    6. }
    7. location ^~ /static/ {
    8.    echo "规则C";
    9. }
    10. location ^~ /static/files {
    11.     echo "规则X";
    12. }
    13. location ~ \.(gif|jpg|png|js|css)$ {
    14.    echo "规则D";
    15. }
    16. location ~* \.png$ {
    17.    echo "规则E";
    18. }
    19. location /img {
    20.     echo "规则Y";
    21. }
    22. location / {
    23.    echo "规则F";
    24. }

    那么产生的效果如下：

    • 访问根目录 /，比如 http://localhost/ 将匹配 规则A
    • 访问 http://localhost/login 将匹配 规则B，http://localhost/register 则匹配 规则F
    • 访问 http://localhost/static/a.html 将匹配 规则C
    • 访问 http://localhost/static/files/a.exe 将匹配 规则X，虽然 规则C 也能匹配到，但因为最大匹配原则，最终选中了 规则X。你可以测试下，去掉规则 X ，则当前 URL 会匹配上 规则C。
    • 访问 http://localhost/a.gif, http://localhost/b.jpg 将匹配 规则D 和 规则 E ，但是 规则 D 顺序优先，规则 E 不起作用，而 http://localhost/static/c.png 则优先匹配到 规则 C
    • 访问 http://localhost/a.PNG 则匹配 规则 E ，而不会匹配 规则 D ，因为 规则 E 不区分大小写。
    • 访问 http://localhost/img/a.gif 会匹配上 规则D,虽然 规则Y 也可以匹配上，但是因为正则匹配优先，而忽略了 规则Y。
    • 访问 http://localhost/img/a.tiff 会匹配上 规则Y。

    访问 http://localhost/category/id/1111 则最终匹配到规则 F ，因为以上规则都不匹配，这个时候应该是 Nginx 转发请求给后端应用服务器，比如 FastCGI（php），tomcat（jsp），Nginx 作为反向代理服务器存在。

    所以实际使用中，笔者觉得至少有三个匹配规则定义，如下：

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

    rewrite 语法

    • last – 基本上都用这个 flag
    • break – 中止 rewrite，不再继续匹配
    • redirect – 返回临时重定向的 HTTP 状态 302
    • permanent – 返回永久重定向的 HTTP 状态 301

    1、下面是可以用来判断的表达式：

    1. -f 和 !-f 用来判断是否存在文件
    2. -d 和 !-d 用来判断是否存在目录
    3. -e 和 !-e 用来判断是否存在文件或目录
    4. -x 和 !-x 用来判断文件是否可执行

    2、下面是可以用作判断的全局变量

    1. 例：http://localhost:88/test1/test2/test.php?k=v
    2. $host：localhost
    3. $server_port：88
    4. $request_uri：/test1/test2/test.php?k=v
    5. $document_uri：/test1/test2/test.php
    6. $document_root：D:\nginx/html
    7. $request_filename：D:\nginx/html/test1/test2/test.php

    redirect 语法

    1. server {
    2.     listen 80;
    3.     server_name start.igrow.cn;
    4.     index index.html index.php;
    5.     root html;
    6.     if ($http_host !~ "^star\.igrow\.cn$") {
    7.         rewrite ^(.*) http://star.igrow.cn$1 redirect;
    8.     }
    9. }

    防盗链

    1. location ~* \.(gif|jpg|swf)$ {
    2.     valid_referers none blocked start.igrow.cn sta.igrow.cn;
    3.     if ($invalid_referer) {
    4.        rewrite ^/ http://$host/logo.png;
    5.     }
    6. }

    根据文件类型设置过期时间

    1. location ~* \.(js|css|jpg|jpeg|gif|png|swf)$ {
    2.     if (-f $request_filename) {
    3.         expires 1h;
    4.         break;
    5.     }
    6. }

    禁止访问某个目录

    1. location ~* \.(txt|doc)${
    2.     root /data/www/wwwroot/linuxtone/test;
    3.     deny all;
    4. }

    一些可用的全局变量，可以参考获取 Nginx 内置绑定变量章节。