2018-03-12 09:49:42
comments

nginx location rewrite 等配置

命令

sudo nginx #打开 nginx
nginx -s reload|reopen|stop|quit  #重新加载配置|重启|停止|退出 nginx
nginx -t   #测试配置是否有语法错误
nginx [-?hvVtq] [-s signal] [-c filename] [-p prefix] [-g directives]

-?,-h           : 打开帮助信息
-v              : 显示版本信息并退出
-V              : 显示版本和配置选项信息，然后退出
-t              : 检测配置文件是否有语法错误，然后退出
-q              : 在检测配置文件期间屏蔽非错误信息
-s signal       : 给一个 nginx 主进程发送信号：stop（停止）, quit（退出）, reopen（重启）, reload（重新加载配置文件）
-p prefix       : 设置前缀路径
-c filename     : 设置配置文件
-g directives   : 设置配置文件外的全局指令

location

location [=|~|~*|^~] /uri/ { … }
=开头表示精确匹配 如 A 中只匹配根目录结尾的请求，后面不能带任何字符串
~ 开头表示区分大小写的正则匹配
~* 开头表示不区分大小写的正则匹配
^~ 开头表示uri以某个常规字符串开头，不是正则匹配
/通用匹配, 如果没有其它匹配,任何请求都会匹配到

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

location例子

#直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理。
#这里是直接转发给后端应用服务器了，也可以是一个静态首页
# 第一个必选规则
location = / {
    proxy_pass http://tomcat:8080/index
}

# 第二个必选规则是处理静态文件请求，这是nginx作为http服务器的强项
# 有两种配置模式，目录匹配或后缀匹配,任选其一或搭配使用
location ^~ /static/ {
    root /webroot/static/;
}
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
    root /webroot/res/;
}

#第三个规则就是通用规则，用来转发动态请求到后端应用服务器
#非静态文件请求就默认是动态请求
location / {
    proxy_pass http://tomcat:8080/
}

location = / {
    # 只匹配 / 查询。
}

location / {
    # 匹配任何查询，因为所有请求都已 / 开头。但是正则表达式规则和长的块规则将被优先和查询匹配。
}

location ^~ /images/ {
     # 匹配任何已 /images/ 开头的任何查询并且停止搜索。任何正则表达式将不会被测试。
}

location ~*.(gif|jpg|jpeg)$ {
     # 匹配任何已 gif、jpg 或 jpeg 结尾的请求。
}

location ~*.(gif|jpg|swf)$ {
     # 允许域名
      valid_referers none blocked imgs.xxx.cn imgx.yyy.cn;
      if ($invalid_referer) {
              #防盗链
              rewrite ^/ http://$host/logo.png;
      }
}

valid_referers 语法：valid_referers [none|blocked|server_names]
默认值：no
使用字段：server, location
这个指令在referer头的基础上为 $invalid_referer 变量赋值，其值为0或1。
可以使用这个指令来实现防盗链功能，如果valid_referers列表中没有Referer头的值， $invalid_referer将被设置为1。
参数可以使如下形式：

  • none意为不存在的Referer头
  • blocked意为根据防火墙伪装Referer头，如：“Referer: XXXXXXX”。
  • server_names为一个或多个服务器的列表，0.5.33版本以后可以在名称中使用“*”通配符。 
add_header Access-Control-Allow-Origin *;  
add_header Access-Control-Allow-Headers Content-Type;   
add_header Access-Control-Allow-Methods GET,POST,OPTIONS;  
add_header Access-Control-Allow-Credentials true;

允许跨域

rewrite

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

rewrite和location功能有点像，都能实现跳转，主要区别在于rewrite是在同一域名内更改获取资源的路径，而location是对一类路径做控制访问或反向代理，可以proxy_pass到其他机器。

很多情况下rewrite也会写在location里，它们的执行顺序是：

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

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

flag标志位

  • last: 表示完成rewrite
  • break : 停止执行当前虚拟主机的后续rewrite指令集
  • redirect : 返回302临时重定向，地址栏会显示跳转后的地址
  • permanent : 返回301永久重定向，地址栏会显示跳转后的地址

因为301和302不能简单的只返回状态码，还必须有重定向的URL，这就是return指令无法返回301,302的原因了。

last 和 break 区别有点难以理解：

  • last一般写在server和if中，而break一般使用在location中
  • last不终止重写后的url匹配，即新的url会再从server走一遍匹配流程，而break终止重写后的匹配
  • break和last都能组织继续执行后面的rewrite指令

    if指令与全局变量

    if判断指令

    语法为if(condition){...}，对给定的条件condition进行判断。
    如果为真，大括号内的rewrite指令将被执行。
    condition可以是如下任何内容：
  • 当表达式只是一个变量时，如果值为空或任何以0开头的字符串都会当做false
  • 直接比较变量和内容时，使用=或!=
  • ~正则表达式匹配，~*不区分大小写的匹配，!~区分大小写的不匹配
    -f和!-f用来判断是否存在文件
    -d和!-d用来判断是否存在目录
    -e和!-e用来判断是否存在文件或目录
    -x和!-x用来判断文件是否可执行
    例如：
    if ($http_user_agent ~ MSIE) {
  rewrite ^(.*)$ /msie/$1 break;
} //如果UA包含"MSIE"，rewrite请求到/msid/目录下

    if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
  set $id $1;
} //如果cookie匹配正则，设置变量$id等于正则引用部分

    if ($request_method = POST) {
  return 405;
} //如果提交方法为POST，则返回状态405（Method not allowed）。return不能返回301,302

    if ($slow) {
  limit_rate 10k;
} //限速，$slow可以通过 set 指令设置

    if (!-f $request_filename){
  break;
  proxy_pass  http://127.0.0.1; 
} //如果请求的文件名存在，则反向代理到localhost 。这里的break也是停止rewrite检查

    if ($args ~ post=140){
  rewrite ^ http://example.com/ permanent;
} //如果query string中包含"post=140"，永久重定向到example.com

    全局变量

  • $args ： #这个变量等于请求行中的参数，同$query_string
  • $content_length ： 请求头中的Content-length字段。
  • $content_type ： 请求头中的Content-Type字段。
  • $document_root ： 当前请求在root指令中指定的值。
  • $host ： 请求主机头字段，否则为服务器名称。
  • $http_user_agent ： 客户端agent信息
  • $http_cookie ： 客户端cookie信息
  • $limit_rate ： 这个变量可以限制连接速率。
  • $request_method ： 客户端请求的动作，通常为GET或POST。
  • $remote_addr ： 客户端的IP地址。
  • $remote_port ： 客户端的端口。
  • $remote_user ： 已经经过Auth Basic Module验证的用户名。
  • $request_filename ： 当前请求的文件路径，由root或alias指令与URI请求生成。
  • $scheme ： HTTP方法（如http，https）。
  • $server_protocol ： 请求使用的协议，通常是HTTP/1.0或HTTP/1.1。
  • $server_addr ： 服务器地址，在完成一次系统调用后可以确定这个值。
  • $server_name ： 服务器名称。
  • $server_port ： 请求到达服务器的端口号。
  • $request_uri ： 包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。
  • $uri ： 不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”。
  • $document_uri ： 与$uri相同。

如http://localhost:81/test1/test2/test.php

  • $host：localhost
  • $server_port：81
  • $request_uri：http://localhost:88/test1/test2/test.php
  • $document_uri：/test1/test2/test.php
  • $document_root：/var/www/html
  • $request_filename：/var/www/html/test1/test2/test.php

    常用正则

  • . ： 匹配除换行符以外的任意字符
  • ? ： 重复0次或1次 - + ： 重复1次或更多次
  • * ： 重复0次或更多次
  • \d ：匹配数字
  • ^ ： 匹配字符串的开始
  • $ ： 匹配字符串的介绍
  • {n} ： 重复n次
  • {n,} ： 重复n次或更多次
  • [c] ： 匹配单个字符c
  • [a-z]： 匹配a-z小写字母的任意一个

    小括号()之间匹配的内容，可以在后面通过$1来引用，$2表示的是前面第二个()里的内容。

负载均衡

  • 轮询（默认）
    每个请求按时间顺序逐一分配到不同的后端服务器，如果后端服务器down掉，能自动剔除。
    upstream backend  {
  server 192.168.1.2;
  server 127.0.0.1:82;
}
  • weight
    指定轮询几率，weight和访问比率成正比，用于后端服务器性能不均的 情况。
    upstream backend  {
  server 127.0.0.1:81 weight=3;
  server 127.0.0.1:82 weight=7;
}
    权重越高，在被访问的概率越大，如上例，分别是30%，70%。
  • ip_hash
    每个请求按访问ip的hash结果分配，这样每个访客固定访问一个后端服务器，可以解决session的问题。
    upstream backend  {
  ip_hash;
  server 127.0.0.1:81;
  server 127.0.0.1:82;
}
  • 代理demo
    upstream  backend  { 
            #ip_hash; 
            server   127.0.0.1:81 max_fails=2 fail_timeout=30s ;  
            server   127.0.0.1:82 max_fails=5 fail_timeout=10s ;  
  }
# 虚拟主机配置
  server {
      listen       80;
      server_name  www.example.com;
      root   /root/www;
      charset utf-8;
      access_log  logs/host.access.log  main;
      #对 / 所有做负载均衡+反向代理
      location / {
          root   /root/www;;
          index  index.html index.htm;
          proxy_pass        http://backend;  
          proxy_redirect off;
          # 其他配置
          # 后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
          proxy_set_header  Host  $host;
          proxy_set_header  X-Real-IP  $remote_addr;  
          proxy_set_header  X-Forwarded-For  $proxy_add_x_forwarded_for;
          proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
      }

rewrite例子

location ^~ /api/ {  
            default_type application/json;  
            if (!-f $request_filename){  
                rewrite "^/api/(.*)$" /api/$1.json;  
                break;
            }   
        }

去掉后缀名访问文件

http {
    # 定义image日志格式
    log_format imagelog '[$time_local] ' $image_file ' ' $image_type ' ' $body_bytes_sent ' ' $status;
    # 开启重写日志
    rewrite_log on;
    server {
        root /home/www;
        location / {
                # 重写规则信息
                error_log logs/rewrite.log notice; 
                # 注意这里要用‘’单引号引起来，避免{}
                rewrite '^/images/([a-z]{2})/([a-z0-9]{5})/(.*)\.(png|jpg|gif)$' /data?file=$3.$4;
                # 注意不能在上面这条规则后面加上“last”参数，否则下面的set指令不会执行
                set $image_file $3;
                set $image_type $4;
        }

        location /data {
                # 指定针对图片的日志格式，来分析图片类型和大小
                access_log logs/images.log mian;
                root /data/images;
                # 应用前面定义的变量。判断首先文件在不在，不在再判断目录在不在，如果还不在就跳转到最后一个url里
                try_files /$arg_file /image404.html;
        }
        location = /image404.html {
                # 图片不存在返回特定的信息
                return 404 "image not found\n";
        }
}

对形如/images/ef/uh7b3/test.png的请求， 重写到/data?file=test.png，于是匹配到location /data，先看/data/images/test.png文件存不存在，如果存在则正常响应，如果不存在则重写tryfiles到新的image404 location，直接返回404状态码。

rewrite ^/images/(.*)_(\d+)x(\d+)\.(png|jpg|gif)$ /resizer/$1.$4?width=$2&height=$3? last;
对形如/images/bla_500x400.jpg的文件请求，重写到/resizer/bla.jpg?width=500&height=400地址，并会继续尝试匹配location。

本文链接：https://www.wuxiaowei.com/post/nginx-rule.html

-- EOF --

snake发表于 2018-03-12 09:49:42，添加在分类学习笔记下，并被添加「nginx」标签，最后修改于 2018-11-14 08:20:21

Comments