Nginx Rewrite

最新推荐文章于 2024-06-21 00:13:30 发布

moluxiangfenglo

最新推荐文章于 2024-06-21 00:13:30 发布

阅读量1k

点赞数 30

文章标签： nginx 运维

本文链接：https://blog.csdn.net/moluxiangfenglo/article/details/139816277

版权

Nginx Rewrite概述

Nginx是一款轻量级的Web服务器/反向代理服务器和电子邮件(IMAP/POP3)代理服务器，在高并发连接下表现优异。它的配置文件非常灵活，其中重写（Rewrite）规则就是其强大功能之一。Nginx的重写规则可以根据请求的URL进行重定向或者改变请求的URI，但不改变请求的内容，这对于网站的SEO（搜索引擎优化）、URL规范化、遗留系统迁移等方面非常有用。

Nginx Rewrite基本语法

nginx

Copy
rewrite regex replacement [flag];
regex: 正则表达式，用来匹配需要被重写的URI。
replacement: 替换字符串，即实际要重定向或重新定义的URI。
flag: 可选标志，指示rewrite如何工作。常见的flag包括：
last - 停止处理当前的rewrite指令集，并使用新的URI重新搜索location匹配。
break - 停止处理当前的rewrite指令集，并不再重新搜索location匹配。
redirect - 返回302临时重定向，浏览器URL地址会发生改变。
permanent - 返回301永久重定向，浏览器URL地址会发生改变。

应用实例

假设我们需要将所有HTTP请求重定向到HTTPS，并将www.example.com的访问重定向到example.com：

nginx

Copy
server {
    listen 80;
    server_name www.example.com example.com;
    return 301 https://example.com$request_uri;
}
另外一个例子，如果我们希望将所有对/old-directory/的访问重写到/new-directory/：

nginx

Copy
server {
    location /old-directory/ {
        rewrite ^/old-directory/(.*)$ /new-directory/$1 last;
    }
}
在这个例子中，使用正则表达式匹配任何以/old-directory/开头的请求，并将它重写为以/new-directory/开头的请求。使用的标志last表示重写后将停止处理之后的rewrite指令，并根据新的URI重新查找适合的location。

注意事项

性能考虑：对于复杂的重写规则，应当注意其对服务器性能的影响。在可能的情况下，使用try_files指令通常比重写规则更高效。
正则表达式：正则表达式的写法需要小心，确保正确匹配预期的URI，避免意外的重写行为。
调试：调试重写规则时，可将nginx的日志级别设置为info或更高，以便观察重写规则的实际行为及其结果。

Rewrite 跳转场景

Nginx的Rewrite跳转功能可以用于多种场景，帮助实现URL的重定向和重写，以满足不同的业务需求。以下是一些常见的跳转场景：

1. 非www跳转到www

对于SEO优化经常需要将非www的访问跳转到带www的形式，确保网站的访问统一，避免内容重复。

nginx

Copy
server {
    listen 80;
    server_name example.com;
    return 301 http://www.example.com$request_uri;
}
2. HTTP跳转到HTTPS

出于安全考虑，网站经常需要从HTTP跳转到HTTPS，保证数据传输的安全性。

nginx

Copy
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://example.com$request_uri;
}
3. 老页面跳转到新页面

当网站结构发生变化，或者进行重新设计时，可将老页面的访问跳转到新页面，保持用户体验的连贯性。

nginx

Copy
server {
    rewrite ^/old-page$ /new-page permanent;
}
4. 基于条件的跳转

有时候，我们希望根据特定条件进行跳转，比如根据用户的设备（移动端或桌面端）、地理位置或其他HTTP请求头信息。

nginx

Copy
server {
    if ($http_user_agent ~* "(mobile|webos)") {
        rewrite ^/(.*)$ /mobile/$1 redirect;
    }
}
5. 目录更名跳转

当网站上的一个目录被重命名时，需要将所有老目录的请求跳转到新目录上。

nginx

Copy
server {
    rewrite ^/old-directory/(.*)$ /new-directory/$1 permanent;
}
注意事项

使用if: Nginx的if指令有其特定的使用场景，但官方文档中提到尽量避免使用if进行重写跳转，因为它可能会引起意外的行为。在可能的情况下，考虑使用return或其他方法实现需求。
重定向循环: 设计重写规则时，要注意避免重定向循环，这可能会导致浏览器显示“过多的重定向”错误。
测试: 在应用任何重写规则之前，建议在测试环境进行充分的测试，确保它们按预期工作，并不会对网站的其他功能产生负面影响。

Nginx的Rewrite功能非常强大，通过合理利用，可以优化网站结构，提高用户体验和网站安全性。

Rewrite 跳转实现

在Nginx中实现跳转主要依赖于rewrite指令，这个指令可以根据特定的条件对URL进行重写或重定向。下面是一些实现Rewrite跳转的示例和说明，帮助你理解和应用在实际场景中。

示例1: 非www到www的重定向

nginx

Copy
server {
    listen 80;
    server_name example.com;
    return 301 http://www.example.com$request_uri;
}
这个配置监听来自example.com的请求，然后使用301状态码，将这些请求重定向到www.example.com。这样做有效地确保用户访问的是www版本的网站。

示例2: HTTP到HTTPS的重定向

nginx

Copy
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://example.com$request_uri;
}
这段代码监听HTTP（端口80）上的请求，并将所有请求（无论是www还是非www）重定向到HTTPS的版本。这对于提高网站安全性和满足现代网站的HTTPS要求非常重要。

示例3: 旧页面到新页面的重写

nginx

Copy
server {
    location /oldpage {
        rewrite ^/oldpage$ /newpage permanent;
    }
}
这里，任何对/oldpage的请求都会被永久性地重定向到/newpage。这可以在网站重组或更新页面内容时保持URL的一致性，有助于维护SEO排名。

示例4: 移动设备重定向

移动设备重定向比较复杂，需要检测用户代理字符串。这里是一个简单的实现：

nginx

Copy
server {
    if ($http_user_agent ~* "(android|iphone|ipad)") {
        rewrite ^/ $ /mobile/index.html redirect;
    }
}
当检测到用户代理字符串符合移动设备时，用户会被重定向到移动版首页。注意，过度使用if指令可能导致不可预见的行为，因为if在Nginx中有些特殊。

注意事项

避免重定向循环：确保重写的规则不会导致请求在几个地址之间无限循环。
测试配置：在应用新的重定向规则前，要确保测试配置的正确性，防止网站访问中断。
**谨慎使用if**：Nginx文档建议尽量避免在location块中使用if指令，因为它可能会带来不可预测的结果。

通过灵活使用rewrite指令，可以在nginx中实现各种重定向和URL重写的需求，无论是为了SEO，还是为了提供更好的用户体验。

Nginx Rewrite基本操作

在Nginx中，利用rewrite指令进行URL的重写和重定向是一种强大而灵活的方式。掌握其基本操作对于网站的维护和优化非常重要。下面是一些Nginx rewrite指令的基本操作，这将帮助你开始利用这一功能。

1. 重写规则的语法

nginx

Copy
rewrite ^/oldpath$ /newpath last;
^/oldpath$ 是一个正则表达式，用于匹配请求的URI。在这个例子中，它匹配的是精确的 /oldpath 路径。
/newpath 是匹配时替换或重定向的新路径。
last 是一个标志（Flag），它告诉Nginx在应用了这条规则之后不再处理其他的rewrite指令。其他常用的标志还包括：
break - 在当前server或location块中停止处理后续的rewrite指令。
redirect - 返回302临时重定向。
permanent - 返回301永久重定向。

2. 重定向到HTTPS

nginx

Copy
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://example.com$request_uri;
}
这个配置将所有HTTP的请求转到相同的HTTPS地址，使用301重定向表示这是一个永久的更改。

3. 改写并保持URI查询参数

nginx

Copy
rewrite ^/old-page$ /new-page?$args permanent;
当你想要将请求从/old-page重定向到/new-page，并且希望保留任何的URI查询参数时，使用$args或者$query_string来保留这些参数。

4. 复杂条件下的重写

在更复杂的场景下，可能需要结合if语句来实现条件性重写：

nginx

Copy
if ($http_user_agent ~ MSIE) {
    rewrite ^(.*)$ /msie/$1 break;
}
这表示如果用户代理包含"MSIE"，那么请求的URI将会被重新写入，前缀为/msie/。这里使用break标志来停止处理当前集合中后续的rewrite指令。

5. 使用try_files作为首选方法

对于简单的文件存在性检查，推荐使用try_files而不是rewrite，因为它更简洁、高效：

nginx

Copy
try_files $uri $uri/ /index.html;
这条指令表示Nginx首先尝试直接访问请求的URI，如果失败，则尝试作为目录访问，最后都失败的话则重定向到/index.html页面。

注意事项

在编写rewrite规则时，务必确保理解其正则表达式的匹配模式，以避免无意中影响到其他的URI。
对于所有重定向，首选使用return指令进行简单的重定向操作，因为它的性能通常更好。

通过上述这些基础，你现在可以开始使用Nginx的rewrite指令来改进和优化你的网站的URL结构了。记得在每次修改后，都重新加载Nginx配置以使改动生效。

moluxiangfenglo

关注

30
点赞
踩
12

收藏

觉得还不错? 一键收藏
0
评论
Nginx Rewrite

Nginx是一款轻量级的Web服务器/反向代理服务器和电子邮件(IMAP/POP3)代理服务器，在高并发连接下表现优异。它的配置文件非常灵活，其中重写（Rewrite）规则就是其强大功能之一。Nginx的重写规则可以根据请求的URL进行重定向或者改变请求的URI，但不改变请求的内容，这对于网站的SEO（搜索引擎优化）、URL规范化、遗留系统迁移等方面非常有用。
复制链接

扫一扫