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
- 结束当前的请求处理，用替换后的URI重新匹配location；
- 可理解为重写（rewrite）后，发起了一个新请求，进入server模块，匹配location；
- 如果重新匹配循环的次数超过10次，nginx会返回500错误；
- 返回302 http状态码 ；
- 浏览器地址栏显示重地向后的url
- break
- 结束当前的请求处理，使用当前资源，不在执行location里余下的语句；
- 返回302 http状态码 ；
- 浏览器地址栏显示重地向后的url
- redirect
- 临时跳转，返回302 http状态码；
- 浏览器地址栏显示重地向后的url
- permanent
- 永久跳转，返回301 http状态码；
- 浏览器地址栏显示重定向后的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
- 如果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 - 如果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 - 一些情况下，不能确定替换的URI
- location里是正则表达式，这种情况下，proxy_pass里最好不要有URI
- 在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\n";
}
(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\n"; #如果是return HTTP 直接返回403 302 等状态码
}
}
本文参考
https://blog.csdn.net/caoshuming_500/article/details/37700357
https://www.cnblogs.com/luxianghao/p/6807081.html
原文地址：http://blog.51cto.com/853056088/2126498
时间： 2024-10-07 05:52:10