news 2026/4/18 6:57:51

Nginx 之Rewrite 使用详解

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Nginx 之Rewrite 使用详解
文章目录
    • 1. 概述
    • 2. Rewrite 指令
      • 2.1 指令语法
      • 2.2 Flag 标记说明
    • 3. Rewrite 与 Location
      • 3.1 Location 分类
      • 3.2 Rewrite 和 Location 比较
    • 4. Rewrite 实际场景
      • 4.1 基于域名的跳转
      • 4.2 基于客户端 IP 访问跳转
      • 4.3 基于参数匹配的跳转
      • 4.4 基于目录下所有 PHP 文件跳转
      • 4.5 基于最普通 URL 请求的跳转
    • 5. Rewrite 执行顺序
    • 6. Rewrite 与 If 指令
    • 7. Rewrite 正则表达式
    • 8. Rewrite 指令的脚本指令
    • 9. Rewrite 配置示例
      • 9.1 301/302 重定向
      • 9.2 非 www 域名重定向到 www 域名
      • 9.3 URL 正则重写：简化 URL 结构
    • 10. 结论

1. 概述

Nginx 的rewrite模块是处理 HTTP 请求过程中的一个重要功能，它允许基于 Perl 兼容正则表达式（PCRE）对用户请求的 URI 进行重写，并返回 30x 重定向跳转或按条件执行相关配置。这个模块提供了灵活的 URL 重写和重定向功能，可以用于实现友好 URL、301/302 重定向、条件重写等。

2. Rewrite 指令

2.1 指令语法

Nginx 中的 URL 重写主要依赖于rewrite指令，其基本语法如下：

rewrite <regex> <replacement> [flag];

  • regex：用于匹配 URI 的正则表达式。

  • replacement：将匹配到的 URI 替换成的新 URI。

  • flag（可选）：控制重写的行为，常见的标志有：

    • last：表示重新搜索新的 location 块（即继续匹配新的规则）。
    • break：停止当前 location 块中的规则匹配，执行后续指令。
    • redirect：执行临时 重定向（302）。
    • permanent：执行永久重定向（301）。
2.2 Flag 标记说明
  • last：重写请求并继续搜索 location 匹配。
  • break：重写请求并停止搜索 location 匹配。
  • redirect：返回 302 临时重定向。
  • permanent：返回 301 永久重定向。

3. Rewrite 与 Location

rewrite指令可以在server或location块中配置。location块只对域名后除去传递参数的字符串起作用，而rewrite可以对域名或参数字符串进行匹配和重写。

3.1 Location 分类
  • 普通 location：匹配特定路径。
  • 正则 location：使用正则表达式匹配路径。
  • 优先级：Nginx 会优先匹配带有正则表达式的 location，然后是最长非正则 location。
3.2 Rewrite 和 Location 比较
  • rewrite用于重写请求 URI。
  • location用于定义请求的处理方式。

4. Rewrite 实际场景

4.1 基于域名的跳转

将旧域名的访问重定向到新域名，同时保持参数不变。

# 定义一个 server 块，用于处理进来的 HTTP 请求 server { # 监听 80 端口，即 HTTP 默认端口 listen 80; # 指定该 server 块响应的域名，这里是 olddomain.com server_name olddomain.com; # 定义 location 块，匹配所有 URI（/ 表示根路径） location / { # 使用 rewrite 指令将所有请求从 olddomain.com 重定向到 newdomain.com # 并保持原有的请求路径和查询参数不变 rewrite ^/(.*)$ http://newdomain.com/$1 permanent; } }

这段配置的作用是将所有访问olddomain.com的请求通过 Nginx 重定向到newdomain.com，并且保持请求的路径不变。permanent标志表示这是一个永久重定向（301 状态码），告诉搜索引擎和浏览器该资源已经被永久移动到新的位置。

4.2 基于客户端 IP 访问跳转

只允许特定 IP 访问，其他 IP 重定向到维护页面。

# 定义一个 server 块，用于处理进来的 HTTP 请求 server { # 监听 80 端口，即 HTTP 默认端口 listen 80; # 指定该 server 块响应的域名，这里是 example.com server_name example.com; # 定义 location 块，匹配所有 URI（/ 表示根路径） location / { # 使用 if 指令进行条件判断，$remote_addr 是客户端的 IP 地址 if ($remote_addr != '192.168.1.100') { # 如果客户端 IP 地址不是 '192.168.1.100'，则返回 302 状态码 # 并将请求重定向到 /maintenance.html，表示网站正在维护中 return 302 /maintenance.html; } } }

这段配置的作用是限制对example.com的访问，只允许 IP 地址为192.168.1.100的客户端访问所有资源，其他所有 IP 地址的访问都会被重定向到/maintenance.html页面，通常用于网站维护期间。这里使用的是临时重定向（302 状态码），意味着浏览器会显示新的 URL（即/maintenance.html），但搜索引擎和缓存可能会保留原始请求的 URL。

4.3 基于参数匹配的跳转

根据请求参数进行跳转。

# 定义一个 server 块，用于处理进来的 HTTP 请求 server { # 监听 80 端口，即 HTTP 默认端口 listen 80; # 指定该 server 块响应的域名，这里是 example.com server_name example.com; # 定义 location 块，匹配所有 URI（/ 表示根路径） location / { # 使用 rewrite 指令进行 URL 重写 # 正则表达式 ^/(.*)?param=value$ 匹配任何以 / 开头，后面跟着任意字符 # 并且以 ?param=value 结尾的请求 URI rewrite ^/(.*)?param=value$ /new-path/$1 last; # last 标志表示重写完成后，继续搜索匹配的 location 块 # 这里的 $1 是正则表达式中括号内匹配到的部分，即任意字符的部分 } }

这段配置的作用是将所有匹配特定模式的请求重写到一个新的路径。具体来说，它会查找所有以/开头，后面跟着任意内容，并且以?param=value结尾的请求，并将这些请求重写到/new-path/开头的路径下，同时保留原始请求中的路径部分（不包括查询参数）。last标志意味着在重写后，Nginx 将继续检查其他location块以找到最合适的匹配项。

4.4 基于目录下所有 PHP 文件跳转

将特定目录下的所有 PHP 文件请求重写到新路径。

# 定义一个 server 块，用于处理进来的 HTTP 请求 server { # 监听 80 端口，即 HTTP 默认端口 listen 80; # 指定该 server 块响应的域名，这里是 example.com server_name example.com; # 定义一个 location 块，使用 ~ 表示这是一个正则表达式匹配 # 正则表达式 .php$ 匹配以 .php 结尾的请求 URI location ~ .php$ { # 使用 rewrite 指令进行 URL 重写 # 正则表达式 ^/(.*).php$ 匹配任何以 / 开头，后面跟着任意字符，以 .php 结尾的请求 URI rewrite ^/(.*).php$ /new-path/$1.php last; # last 标志表示重写完成后，继续搜索匹配的 location 块 # 这里的 $1 是正则表达式中括号内匹配到的部分，即除去 .php 后缀的文件名部分 } }

这段配置的作用是将所有请求 URI 以.php结尾的请求重写到/new-path/下的相同文件名。例如，请求/example.com/about.php会被重写为/example.com/new-path/about.php。last标志意味着在重写后，Nginx 将继续检查其他location块以找到最合适的匹配项，而不是立即停止处理当前location块。

4.5 基于最普通 URL 请求的跳转

将普通 URL 请求重写到新路径。

# 定义一个 server 块，用于处理进来的 HTTP 请求 server { # 监听 80 端口，即 HTTP 默认端口 listen 80; # 指定该 server 块响应的域名，这里是 example.com server_name example.com; # 定义 location 块，匹配所有 URI（/ 表示根路径） location / { # 使用 rewrite 指令进行 URL 重写 # 正则表达式 ^/(.*)$ 匹配任何以 / 开头，后面跟着任意字符的请求 URI rewrite ^/(.*)$ /new-path/$1 permanent; # permanent 标志表示这是一个永久重定向（301 状态码） # 告诉浏览器和搜索引擎该资源已经被永久移动到新的位置 # $1 是正则表达式中括号内匹配到的部分，即除去第一个斜杠后的整个请求路径 } }

这段配置的作用是将所有访问example.com的请求重定向到/new-path/下的相同路径。例如，请求/example.com/about会被永久重定向到/example.com/new-path/about。permanent标志意味着这是一个永久重定向，浏览器会更新收藏夹中的 URL，搜索引擎也会更新其索引。

5. Rewrite 执行顺序

rewrite指令的执行顺序如下：

  1. 执行server块里面的rewrite指令。
  2. 执行location匹配。
  3. 执行选定location中的rewrite指令。

6. Rewrite 与 If 指令

if指令用于条件判断，可以与rewrite结合使用，但需要注意if是邪恶的，因为它可能导致 Nginx 配置变得复杂和难以维护。推荐使用rewrite来实现条件重写。

7. Rewrite 正则表达式

Nginx 的rewrite模块支持 PCRE 正则表达式，以下是一些常用的正则表达式元字符：

  • .：匹配任意单个字符。
  • ^：匹配字符串的开始。
  • $：匹配字符串的结束。
  • *：匹配前面的元素 0 次或多次。
  • +：匹配前面的元素 1 次或多次。
  • ?：匹配前面的元素 0 次或 1 次。
  • []：匹配括号内的任意一个字符。
  • |：逻辑或操作符。

8. Rewrite 指令的脚本指令

rewrite模块提供了类似脚本语言的指令，可以在 HTTP 请求处理过程中对 URI 进行更灵活的操作控制。

9. Rewrite 配置示例

以下是一些rewrite配置的示例：

9.1 301/302 重定向
# 定义一个 server 块，用于处理 HTTP 请求 server { # 监听 80 端口，这是 HTTP 协议的默认端口 listen 80; # 指定 server 块服务的域名，这里是 olddomain.com server_name olddomain.com; # 定义 location 块，用于匹配所有请求的 URI（/ 表示根路径） location / { # 使用 rewrite 指令进行 URL 重写 # 正则表达式 ^/(.*)$ 匹配所有以 / 开头的请求 URI rewrite ^/(.*)$ http://newdomain.com/$1 permanent; # 将匹配到的请求重写到 newdomain.com 的相同路径 # $1 表示正则表达式中括号内匹配到的部分，即除了根斜杠外的路径部分 # permanent 标志表示这是一个永久重定向（301 状态码） # 告诉浏览器和搜索引擎该资源已经被永久移动到新域名 } }

这段配置的作用是将所有访问olddomain.com的请求永久重定向到newdomain.com的相同路径。例如，如果用户访问olddomain.com/about，他们将被重定向到newdomain.com/about。这个重定向是永久的，意味着搜索引擎和浏览器会更新相应的链接，并且用户浏览器的地址栏也会显示新的 URL。

9.2 非 www 域名重定向到 www 域名
# 第一个 server 块，用于处理对 example.com 的非 www 前缀域名的请求 server { # 监听 80 端口，这是 HTTP 协议的默认端口 listen 80; # 指定 server 块服务的域名，这里是 example.com（没有 www 前缀） server_name example.com; # 对于所有请求，返回一个 301 永久重定向响应 # 这会将用户从 http://example.com 重定向到 http://www.example.com，并保留原始请求的 URI return 301 http://www.example.com$request_uri; } # 第二个 server 块，用于处理对 www.example.com 的请求 server { # 监听 80 端口，这是 HTTP 协议的默认端口 listen 80; # 指定 server 块服务的域名，这里是 www.example.com（带有 www 前缀） server_name www.example.com; # 定义 location 块，用于匹配所有请求的 URI（/ 表示根路径） location / { # 这里可以放置处理 www.example.com 域名请求的配置 # 例如，可以配置 proxy_pass 来代理请求，或者 root 指令来指定文件根目录等 # 正常站点配置 } }

这段配置的作用是将所有对example.com（没有www前缀）的 HTTP 请求永久重定向到www.example.com（带有www前缀）。第一个server块监听example.com并返回一个 301 状态码，将请求重定向到www.example.com，同时保留请求的 URI。第二个server块则处理对www.example.com的请求，可以在这里进行进一步的配置，比如设置代理、静态文件服务等。

关于您提到的网址http://www.example.com$request_uri，由于网络原因，解析并没有成功。这可能是由于链接格式不正确或者网络连接问题。请检查网页链接的合法性，并在确保网络连接正常的情况下适当重试。如果问题依旧存在，可能需要进一步的网络诊断或联系网站管理员。如果您有其他问题或需要帮助，请随时告知。

9.3 URL 正则重写：简化 URL 结构
# 定义一个 server 块，用于处理进来的 HTTP 请求 server { # 监听 80 端口，即 HTTP 默认端口 listen 80; # 指定该 server 块响应的域名，这里是 example.com server_name example.com; # 定义一个 location 块，匹配请求 URI 路径以 /category/id/ 开头的请求 location /category/id/ { # 使用 rewrite 指令进行 URL 重写 # 正则表达式 ^/category/id/(d+)$ 匹配以 /category/id/ 开头，接着是数字的请求 URI rewrite ^/category/id/(d+)$ /category/$1 last; # last 标志表示重写完成后，继续搜索匹配的 location 块 # $1 是正则表达式中括号内匹配到的部分，即 URI 中的数字部分 } }

这段配置的作用是将所有匹配/category/id/路径并且后面跟着数字的请求重写到/category/路径下。例如，请求/category/id/123会被重写为/category/123。last标志意味着在重写后，Nginx 将继续检查其他location块以找到最合适的匹配项。这样做可以允许 Nginx 在重写请求后，根据新的 URI 再次检查是否有更具体的location匹配，从而应用更具体的配置。

10. 结论

Nginx 的rewrite模块提供了强大的 URL 重写和重定向功能，可以用于实现各种复杂的 URL 处理需求。通过合理配置rewrite指令，可以提高网站的可用性、改善 SEO、实现域名迁移等。本手册详细介绍了rewrite的命令、语法、含义、环境和示例，希望能够帮助用户更好地理解和使用 Nginx 的rewrite功能。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/18 3:27:39

新手必看：JavaScript堆内存问题入门指南

快速体验 打开 InsCode(快马)平台 https://www.inscode.net输入框内输入如下内容&#xff1a; 创建一个交互式学习工具&#xff0c;通过简单的示例和逐步引导&#xff0c;帮助初学者理解JavaScript堆内存分配失败的常见原因&#xff08;如内存泄漏、大对象分配等&#xff09;…

作者头像 李华
网站建设 2026/4/18 3:30:20

Neo4j图数据库学习(二)——SpringBoot整合Neo4j

一. 前言 本文介绍如何通过SpringBoot整合Neo4j的方式&#xff0c;对图数据库进行简单的操作。 Neo4j和SpringBoot的知识不再赘述。关于Neo4j的基础知识&#xff0c;有兴趣可以看看作者上一篇的文章&#xff1a;Neo4j图数据库学习(一)——初识CQL 二. 前置准备 新建SpringBo…

作者头像 李华
网站建设 2026/4/18 2:10:39

nginx 代理 redis

kubernetes 发布的redis服务端口为 31250 通过命令查询 [miniecs-88500735 /]$ minikube service redis --url http://192.168.49.2:31250[rootecs-88500735 /]# vi /etc/nginx/nginx.conf配置nginx.conf stream {upstream redis {server 192.168.49.2:31250;}server {listen 6…

作者头像 李华
网站建设 2026/4/15 9:04:51

背调软件如何重塑企业人才风控的底层逻辑

在信息高度不对称的招聘市场中&#xff0c;一份精心修饰的简历可能隐藏着企业难以承受的风险。近年来&#xff0c;超过60%的企业在招聘中层以上岗位时遭遇过履历信息失实的情况&#xff0c;其中近三分之一因此遭受了直接经济损失。当传统的人工背调在效率与深度之间陷入两难时&…

作者头像 李华
网站建设 2026/4/18 5:42:54

金运环球：金价静待非农定调，晚盘警惕数据引爆波动

【市场晚间简述】大宗商品指数年度再平衡的被动抛压持续影响市场&#xff0c;但金银价格在关键技术位获得买盘支撑后呈现震荡格局。地缘政治风险与美联储降息预期共同构成中长期支撑&#xff0c;限制了价格下行空间。市场焦点已转向晚间将公布的美国非农就业数据&#xff0c;该…

作者头像 李华