什么是 Nginx 的 rewrite 指令？（Nginx rewrite 指令详解）

赵其鑫 • 2024年 10月 27日 18:39:30 • 中间件

在 Nginx 的众多功能中，rewrite 指令尤为突出，它是进行 URL 重定向和重写的核心工具，可以实现在不改变原始请求的情况下修改目标 URL，从而提供更灵活的 URL 管理方式，增强网站的 SEO 友好性和功能性。

rewrite 指令允许你根据特定规则修改请求的 URI（Uniform Resource Identifier）。它可以匹配 URL 的部分或全部，执行重定向或者内部重写操作，从而影响请求的流向和最终被处理的资源。

rewrite 指令的基本语法如下：

rewrite [flag] pattern replacement [flag];

其中，

简单的重定向
如果你想将所有旧的 URL http://oldsite.com/path/* 重定向至 https://newsite.com/newpath/*:
```
location / {
    rewrite ^/oldsite/(.*) https://newsite.com/newpath/$1 permanent;
}
```
内部重写
如果需要将请求 /product/123 重写为 /products/view?pid=123:
```
location / {
    rewrite ^/product/([0-9]+)$ /products/view?pid=$1 last;
}
```
注意 $1 表示捕获第一个括号内的数字。

条件判断

只有当 URL 匹配某条件时才重写：

if ($host = oldsite.com) {
    rewrite ^/(.*) https://www.newsite.com/$1 permanent;
}

rewrite 指令还可以嵌套使用，例如：

location / {
   rewrite ^(/images|/css|/js)/(.*) $1$2 break;
   rewrite ^/images/ (.*\.jpg|.*\.png|.*\.gif)$ /images/$1 last;
}

这里先检查是否请求了 /images, /css, 或 /js，如果是，则继续进行更精确的匹配和重写。

rewrite 指令是 Nginx 中极其强大的工具，掌握了它的使用方法，可以极大增强网站的灵活性和功能性，帮助优化 SEO 和用户体验。但是，不当的配置可能导致性能下降，所以建议谨慎使用，避免过度复杂的规则链。