nginx proxy_pass 与 rewrite 简记

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

 

Nginx配置proxy_pass转发的/路径问题

在nginx中配置proxy_pass时，若是是按照^~匹配路径时,要注意proxy_pass后的url最后的/,当加上了/，至关因而绝对根路径，则nginx不会把location中匹配的路径部分代理走;若是没有/，则会把匹配的路径部分也给代理走。

location ^~ /static_js/ 
{ 
proxy_cache js_cache; 
proxy_set_header Host js.test.com; 
proxy_pass http://js.test.com/; 
}

如上面的配置，若是请求的url是http://servername/static_js/test.html
会被代理成http://js.test.com/test.html

而若是这么配置

location ^~ /static_js/ 
{ 
proxy_cache js_cache; 
proxy_set_header Host js.test.com; 
proxy_pass http://js.test.com; 
}

则会被代理到http://js.test.com/static_js/test.htm

固然，咱们能够用以下的rewrite来实现/的功能

location ^~ /static_js/ 
{ 
proxy_cache js_cache; 
proxy_set_header Host js.test.com; 
rewrite /static_js/(.+)$ /$1 break; 
proxy_pass http://js.test.com; 
} 

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;
      }