Nginx rewrite正则匹配重写的方法示例

更新时间：2019年10月12日 09:35:43 作者：Leshami

这篇文章主要介绍了Nginx rewrite正则匹配重写的方法示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

Nginx的rewrite功能支持正则匹配重写，即将URL地址临时或永久重新指向某个新的位置，类似于重定向。这个特性有利用当网站结构做出重大调整，如之前的网站mp3资源使用URL为www.site1.org/mp3进行访问，而现在服务器上mp3目录已经被使用music目录替换，那rewrite这个功能则能够轻松实现。其次如可以将site1.org强制调整到www.site1.org，反之亦可。这个指令位于ngx_http_rewrite_module模块。本文主要描述这个指令的用法并给出演示。

一、rewrite指令语法描述

句法： rewrite regex replacement [flag];
默认： -
语境： server，location，if

如果指定的正则表达式与请求URI匹配，则URI将按照replacement字符串中的指定进行更改。
该rewrite指令在其在配置文件中出现的顺序顺序地执行。可以使用标志终止对伪指令的进一步处理。
如果替换字符串以“ http://”，“ https://”或“ $scheme” 开头，则处理停止，并将重定向返回给客户端。

flag标志的作用是用于控制当匹配到对应的rewrite规则后是否继续检查后续的rewrite规则
可选flag参数可以是以下之一：

last
一旦被当前规则匹配并重写后立即停止检查后续的其它rewrite的规则，而后通过重写后的规则重新发起请求；

break
一旦被当前规则匹配并重写后立即停止后续的其它rewrite的规则，而后继续由nginx进行后续操作；

redirect
如果替换字符串不以“ http://”，“ https://”或“ $scheme” 开头，则使用，返回302临时重定向；

permanent
返回301永久重定向；

注意：一般将rewrite写在location中时都使用break标志，或者将rewrite写在if上下文中；

其他指令

rewrite_log on|off
是否把重写过程记录在错误日志中；默认为notice级别；默认为off；

return code:
用于结束rewrite规则，并且为客户返回状态码；可以使用的状态码有204, 400, 402-406, 500-504等；

二、基于location上下文rewrite功能演示

本机环境
 # more /etc/redhat-release
 CentOS Linux release 7.2.1511 (Core)
 # nginx -v
 nginx version: nginx/1.12.2

配置nginx
 # vim /etc/nginx/conf.d/rewrite.conf
 server {
  listen 80;
  server_name site1.orag www.site1.org;

  location / {
    root /www/site1.org;
    index index.html index.htm;
  }
 }

 # mkdir -pv /www/site1.org/images
 # echo "This is a rewrite test page.">/www/site1.org/index.html
 # cp /usr/share/backgrounds/gnome/*.jpg /www/site1.org/images/

 # vim /etc/hosts
 192.168.1.175 site1.org
 192.168.1.175 www.site1.org

 # curl http://www.site1.org
 This is a rewrite test page.

 # curl -I http://www.site1.org/images/Waves.jpg
 HTTP/1.1 200 OK
 Server: nginx/1.12.2
 Date: Wed, 01 Nov 2017 03:47:58 GMT
 Content-Type: image/jpeg
 Content-Length: 458818
 Last-Modified: Wed, 01 Nov 2017 03:43:48 GMT
 Connection: keep-alive
 ETag: "59f942f4-70042"
 Accept-Ranges: bytes

修改rewrite.conf文件，添加rewrite指令
 location / {
  root /www/site1.org;
  index index.html index.htm;
  rewrite ^/images/(.*)$ /imgs/$1 last;
 }

 # systemctl reload nginx

 # curl -I http://www.site1.org/images/Waves.jpg
 HTTP/1.1 404 Not Found
 Server: nginx/1.12.2
 Date: Wed, 01 Nov 2017 04:02:38 GMT
 Content-Type: text/html
 Content-Length: 169
 Connection: keep-alive

 # mkdir -pv /www/site1.org/imgs

 # mv /www/site1.org/images/Waves.jpg /www/site1.org/imgs/.
 # curl -I http://www.site1.org/images/Waves.jpg
 HTTP/1.1 200 OK
 Server: nginx/1.12.2
 Date: Wed, 01 Nov 2017 04:05:07 GMT
 Content-Type: image/jpeg
 Content-Length: 458818
 Last-Modified: Wed, 01 Nov 2017 03:43:48 GMT
 Connection: keep-alive
 ETag: "59f942f4-70042"
 Accept-Ranges: bytes

 # curl -I http://www.site1.org/imgs/Waves.jpg ##这种方式可以访问
 HTTP/1.1 200 OK
 Server: nginx/1.12.2
 Date: Wed, 01 Nov 2017 04:06:17 GMT
 Content-Type: image/jpeg
 Content-Length: 458818
 Last-Modified: Wed, 01 Nov 2017 03:43:48 GMT
 Connection: keep-alive
 ETag: "59f942f4-70042"
 Accept-Ranges: bytes

模拟rewrite导致的http 500错误
再次对rewrite.conf文件做如下修改，

 location / {
  root /www/site1.org;
  index index.html index.htm;
  rewrite ^/images/(.*)$ /imgs/$1 last;
  rewrite ^/imgs/(.*)$ /images/$1 ;
 }

 # systemctl restart nginx
 # curl -I http://www.site1.org/imgs/Waves.jpg
 HTTP/1.1 500 Internal Server Error
 Server: nginx/1.12.2
 Date: Wed, 01 Nov 2017 05:23:16 GMT
 Content-Type: text/html
 Content-Length: 193
 Connection: close

 # curl -I http://www.site1.org/images/Waves.jpg
 HTTP/1.1 500 Internal Server Error
 Server: nginx/1.12.2
 Date: Wed, 01 Nov 2017 05:23:28 GMT
 Content-Type: text/html
 Content-Length: 193
 Connection: close

通过上述的测试可知，出现了死循环导致的500错误。
Nginx官方给出的参考样例：
 server {
  ... ##rewrite指令位于server上下文
 rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
 ##将/download目录中包含media目录下的任意文件请求重定向为donwload/任意/mp3/任意.mp3

 rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra last;
 ##将/download目录中包含audio目录下的任意文件请求重定向为donwload/任意/mp3/任意.mp3

 return 403;
  ...
 }

 location /download/ { ##rewrite指令位于location上下文
 rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
 ##该last标志应该被替换 break，否则nginx将使10个周期返回500个错误
 rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra break;
 return 403;
 }

三、基于if条件判断rewrite功能演示

 # vi /etc/nginx/conf.d/rewrite.conf
  server {
    listen 80;
    server_name site1.orag www.site1.org;

   if ($host != 'www.site1.org' ) {
     rewrite ^/(.*)$ http://www.site1.org/$1 permanent;
    }

  location / { ##Author : Leshami
    root /www/site1.org; ##Blog : http://blog.csdn.net/leshami
    index index.html index.htm;
    rewrite ^/images/(.*)$ /imgs/$1 last;
    rewrite ^/imgs/(.*)$ /images/$1 ;
  }
 }

 # systemctl reload nginx.service

本地测试(修改本地host文件)
 # curl http://site1.org
 <html> ##返回301状态码
 <head><title>301 Moved Permanently</title></head>
 <body bgcolor="white">
 <center><h1>301 Moved Permanently</h1></center>
 <hr><center>nginx/1.12.2</center>
 </body>
 </html>

Windows环境测试
通过修改Windows机器Host文件后，添加如下条目
 192.168.1.175 centos7-router.com
 192.168.1.175 www.centos7-router.com

打开浏览器，通过域名的方式进行访问http://site1.org会自动跳转到http://www.site1.org(演示略)

四、将http重写至https

在非全站https时，对于有些敏感的数据需有走https，那也可以通过rewrite方式实现

如下示例，假定https://www.site1.org/user目录下包含敏感信息，按可按如下方式rewrite

 location ^~ /user {
 rewrite ^/ https://www.site1.org$request_uri? permanent;
 }

全站https
 server {
  listen 80;
  server_name site1.orag www.site1.org;
  access_log /var/log/nginx/http-access.log;
  error_log /var/log/nginx/http-error.log;

  rewrite ^/ https://www.site1.org$request_uri;
 }

上述演示略

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Nginx中定义404页面并且返回404状态码的正确方法
这篇文章主要介绍了Nginx中定义404页面并且返回404状态码的正确方法,本文在一次AJAX调用时发现了这个问题,服务器返回了一个404页页但没有返回404状态码,需要的朋友可以参考下
2014-08-08
为高负载网络优化Nginx和Node.js的方法
如果不先对Nginx和Node.js的底层传输机制有所了解，并进行针对性优化，可能对两者再细致的调优也会徒劳无功。一般情况下，Nginx通过TCP socket来连接客户端与上游应用
2013-02-02
Nginx配置-日志格式配置方式
这篇文章主要介绍了Nginx配置-日志格式配置方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-03-03
Nginx进程管理和重载原理详解
这篇文章主要给大家介绍了关于Nginx进程管理和重载原理的相关资料,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2021-04-04
Nginx出现The plain HTTP request was sent to HTTPS port问题解决方法
这篇文章主要介绍了Nginx出现The plain HTTP request was sent to HTTPS port问题解决方法,需要的朋友可以参考下
2015-04-04
nginx命令参数用法详细介绍
这篇文章主要介绍了nginx命令参数用法详细介绍的相关资料,希望通过本文可以帮助到大家理解并应用这部分知识，需要的朋友可以参考下
2017-08-08
nginx部署多个前端项目详细步骤
最近一台服务器要配置多个前端项目,当然前后端分离就需要nginx来配置了,下面这篇文章主要给大家介绍了关于nginx部署多个前端项目的详细步骤,需要的朋友可以参考下
2023-10-10
Nginx安装及具体应用小结
Nginx 动静分离简单来说就是把动态请求跟静态请求分开,Nginx 处理静态请求,Tomcat处理动态请求,这篇文章主要介绍了Nginx安装及具体应用小结,需要的朋友可以参考下
2024-02-02
全面了解Nginx中的HTTP协议相关模块配置
HTTP的处理是Nginx服务器的最重要功能,这里我们就带大家来全面了解Nginx中的HTTP协议相关模块配置,需要的朋友可以参考下
2016-07-07
Nginx 中实现请求的排队机制的过程详解
Nginx中的请求排队机制就像是交通警察指挥交通一样,让网络流量有序地流动,保障服务器的稳定运行和用户的良好体验,在深入探讨 Nginx 中的请求排队机制之前,咱们先来弄明白到底什么是请求的排队机制,带着这个问题一起通过本文学习吧
2024-07-07

Nginx rewrite正则匹配重写的方法示例

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具