nginx proxy_pass和rewrite的区别

Posted 2020-11-14

rewrite

syntax: rewrite regex replacement [flag]
Default: —
Context: server, location, if

• 如果正则表达式（regex）匹配到了请求的URI（request URI），这个URI会被后面的replacement替换

• rewrite的定向会根据他们在配置文件中出现的顺序依次执行

• 通过使用flag可以终止定向后进一步的处理

• 如果replacement以“http://”, “https://”, or “$scheme”开头，处理将会终止，请求结果会以重定向的形式返回给客户端（client）

• 如果replacement字符串里有新的request参数，那么之前的参数会附加到其后面，如果要避免这种情况，那就在replacement字符串后面加上“？”，eg：
  

   rewrite ^/users/(.*)$ /show?user=$1? last;=

• 如果正则表达式（regex）里包含“}” or “;”字符，需要用单引号或者双引号把正则表达式引起来

• 要把 http://www.test.com/a/b?id=123 的一条链接转换成 http://www.test.com/p-123.html

• 在nginx中是有特殊逻辑，它用$query_string来表示问号以后的字符，即"id=123"

• if ($request_uri ~* "^/a/b?id=(d+)$") {
                  set $myarg1 $1;
                  rewrite .* http://www.test.com/p-$myarg1.html? permanent;
          }
  

• 注意，set $myarg1 $1; 这句话不能少，不能直接用$1，会出错的。

可选的flag参数如下：

• last

1. 结束当前的请求处理，用替换后的URI重新匹配location；

2. 可理解为重写（rewrite）后，发起了一个新请求，进入server模块，匹配location；

3. 如果重新匹配循环的次数超过10次，nginx会返回500错误；

4. 返回302 http状态码 ；

5. 浏览器地址栏显示重地向后的url

• break

1. 结束当前的请求处理，使用当前资源，不在执行location里余下的语句；

2. 返回302 http状态码 ；

3. 浏览器地址栏显示重地向后的url

•  redirect

1. 临时跳转，返回302 http状态码；

2. 浏览器地址栏显示重地向后的url

• permanent

1. 永久跳转，返回301 http状态码；

2. 浏览器地址栏显示重定向后的url

 

proxy_pass

Syntax:    proxy_pass URL;
Default:    —
Context:    location, if in location, limit_except

• 不影响浏览器地址栏的url

• 设置被代理server的协议和地址，URI可选（可以有，也可以没有）

• 协议可以为http或https

• 地址可以为域名或者IP，端口可选；eg：
  

   proxy_pass http://localhost:8000/uri/;

•  如果一个域名可以解析到多个地址，那么这些地址会被轮流使用，此外，还可以把一个地址指定为 server group（如：nginx的upstream）, eg:
  

  

  upstream backend {
      server backend1.example.com       weight=5;
      server backend2.example.com:8080;
      server unix:/tmp/backend3;
   
      server backup1.example.com:8080   backup;
      server backup2.example.com:8080   backup;
  }
   
  server {
      location / {
          proxy_pass http://backend;    }
  }

  

• server name， port， URI支持变量的形式，eg：
  

  proxy_pass http://$host$uri;

这种情况下，nginx会在server groups（upstream后端server）里搜索server name，如果没有找到，会用dns解析

请求的URI按照下面的规则传给后端server

1. 如果proxy_pass的URL定向里包括URI，那么请求中匹配到location中URI的部分会被proxy_pass后面URL中的URI替换，eg：
   

   location /name/ {
       proxy_pass http://127.0.0.1/remote/;}
   请求http://127.0.0.1/name/test.html 会被代理到http://example.com/remote/test.html

2. 如果proxy_pass的URL定向里不包括URI，那么请求中的URI会保持原样传送给后端server，eg：

   location /name/ {
       proxy_pass http://127.0.0.1;}
   
   请求http://127.0.0.1/name/test.html 会被代理到http://127.0.0.1/name/test.html

3.  一些情况下，不能确定替换的URI
   
   

1. location里是正则表达式，这种情况下，proxy_pass里最好不要有URI

2. 在proxy_pass前面用了rewrite，如下，这种情况下，proxy_pass是无效的，eg：
   

   location /name/ {
       rewrite    /name/([^/]+) /users?name=$1 break;
       proxy_pass http://127.0.0.1;}

    

重写规则语法： rewrite 正则 替换 标志位

(1). 任何重写规则第一部分肯定是 正则表达式

可以用()来捕获正则表达式，然后在rewrite后面就用 $[d+] 来用这个正则表达式；比如：

^/images/([a-z]{2})/([a-z0-9]{5})/(.*).(png|jpg|gif)$   ---->http://xxxx.com/images/aa/abc01/test.gif   
#其中   
$1=([a-z]{2})      #$1=aa  
$2=([a-z0-9]{5})   #$2=abc01  
$3=(.*)            #$3=test  
$4=(png|jpg|gif)   #$4=gif

上面的4个地段都是query 串中匹配的字符串  

(2). 重写规则的第二部分是URI(rewrite 重写后url)

query 请求串被改写，包括上面正则表达式获取的参数字段和nginx 相关的配置，

/data?file=$3.$4   # rewrite之后的query http://data?file=test.gif

rewrite 之后会返回给客户端301 或者302  [ 会不会返回200]

(3).  重写规则的第三部分是：尾部的标记  flag last return break

laster 标记之后会从新loaction ，继续rewrite 最多10次

rewrite '^/images/([a-z]{2})/([a-z0-9]{5})/(.*).(png|jpg|gif)$' /data?file=$3.$4 last;  
#<pre name="code" class="html">http://xxxx.com/images/aa/abc01/test.gif   -----rewrite---> http://data?file=test.gif

 

break标记是直接跳槽rewrite和localtion 进行query的处理if ($bwhog) {

if ($bwhog) {  
    limit_rate 300k;  
    break;  
}

return标记停止rewrite 处理指令，进而控制主HTTP 模块处理请求，也就是HTTP请求也不处理了，直接给client 返回(结合error0page，)

location = /image404.html {  
    return 404 "image not found
";  
}

(4). 整个过程的实例

http {  
    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 {  
                 
                rewrite /data?(.*) /error/img=$1 break;  #break 就是最后的rewrite 结果，不会再次遍历localtion啦  
        }  
        location = /error/ {  
                # 图片不存在返回特定的信息  
                return 404 "image not found
";  #如果是return HTTP 直接返回403 302 等状态码  
        }  
}

本文参考

https://blog.csdn.net/caoshuming_500/article/details/37700357

https://www.cnblogs.com/luxianghao/p/6807081.html