nginx proxy_pass和rewrite

╰半橙微兮° 2022-05-24 07:10 253阅读 0赞

文章作者：luxianghao

文章来源：[http://www.cnblogs.com/luxianghao/p/6807081.html][http_www.cnblogs.com_luxianghao_p_6807081.html] 转载请注明，谢谢合作。

免责声明：文章内容仅代表个人观点，如有不当，欢迎指正。

\---

**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 “;”字符，需要用单引号或者双引号把正则表达式引起来

可选的 *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:  
    
    
    ![复制代码][copycode.gif]
    
        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;
            }
        }
    
    ![复制代码][copycode.gif]
 *  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;
            }

[http_www.cnblogs.com_luxianghao_p_6807081.html]: http://www.cnblogs.com/luxianghao/p/6807081.html
[copycode.gif]: /images/20220524/5d74ee8700a04ab283a21e87a335ad72.png