当前位置： 首页 > news >正文

Nginx详解（三）：ngx_http_rewrite_module模块核心指令详解

news 来源：原创 2025/6/1 8:18:33

概要：

在 Nginx 的众多功能模块中，ngx_http_rewrite_module是实现请求动态处理的核心组件，它通过一系列指令实现 URI 重写、条件判断、响应返回等功能。本文将以 CentOS 7.9 环境为例（主机名www.a.com，IP 172.25.0.100，网站数据目录 /data/sitea/），详细解析break、if、return、rewrite、set五大指令的使用方法，并提供完整的配置验证流程。

环境准备与配置规范

基础环境搭建

在 CentOS 7.9 系统中，首先需要完成 Nginx 的安装与基础配置：

# 安装Nginxsudo yum install -y nginx# 创建网站数据目录sudo mkdir -p /data/sitea/{html,static,mobile,api/v1,api/v2}# 准备测试文件sudo echo "SiteA Home" > /data/sitea/html/index.htmlsudo echo "Mobile Version" > /data/sitea/html/mobile/index.htmlsudo touch /data/sitea/static/style.csssudo echo "API V1" > /data/sitea/api/v1/test.txtsudo echo "API V2" > /data/sitea/api/v2/test.txtsudo echo "API root index" > /data/sitea/api/index.html# 创建虚拟主机配置文件sudo mkdir -p /etc/nginx/conf.d/vhostssudo nano /etc/nginx/conf.d/vhosts/a.com.conf

基础虚拟主机配置

在a.com.conf中添加基础配置：

server {listen 80;server_name www.a.com;root /data/sitea/html;index index.html;location /static/ {root /data/sitea;}location /api/ {root /data/sitea;}
}

环境验证

完成基础配置后，通过以下命令验证环境：


# 检查配置语法nginx -t# 重载Nginx配置nginx -s reload# 测试访问（需在客户端修改hosts文件添加172.25.0.100 www.a.com）curl http://www.a.com# 应返回"SiteA Home"

break 指令：终止请求处理流程

指令语法与作用

break指令用于立即终止当前location或server块内的后续指令执行，不再进行 URI 重写或位置匹配，语法非常简单：

                break;

典型应用场景

  • 静态资源路径直接响应，避免执行多余逻辑
  • 条件判断后提前终止请求处理

实战配置示例

在静态资源路径中添加break指令：

server {listen 80;server_name www.a.com;root /data/sitea/html;index index.html;location /static/ {root /data/sitea;expires 30d;break;invalid_directive;}location /api/ {root /data/sitea;}
}

验证步骤

  1. 重载 Nginx 配置：reload nginx
  1. 访问静态资源并查看响应头：
curl -I http://www.a.com/static/style.css

 

预期输出应包含Expires字段，且由于break指令的存在，该location内的其他错误指令不会影响执行（可故意添加错误指令测试）。

if 指令：条件判断的核心工具

语法与条件类型

if指令通过条件表达式控制请求处理流程，语法为：

if (condition) { ... }

if (condition) { ... }
        条件满足时，执行配置块中的配置指令； server, location
        condition：
          比较操作符：
                = 相同 != 不同
                
                ~ 模式匹配，区分字符大小写
                ~* 模式匹配，不区分字符大小写
                !~ 模式不匹配，区分字符大小写
                !~* 模式不匹配，不区分字符大小写
                
            文件及目录存在性判断：
                -e， !-e 存在与否（ 包括文件，目录，软链接）
                -f， !-f 文件 -d， !-d 目录 -x， !-x 执行

支持的条件类型包括：

  • 变量判空：if ($variable)（变量值为空或 "0" 时为假）
  • 字符串比较：if ($variable = value) 或 if ($variable != value)
  • 正则匹配：if ($variable ~ pattern)（区分大小写）、if ($variable ~* pattern)（不区分大小写）
  • 文件检查：if (-f $filename)（文件存在）、if (-d $dirname)（目录存在）等

return 指令：快速返回响应结果

指令语法与功能

return指令用于直接返回 HTTP 状态码和响应内容，终止请求处理，语法为：

return code [text|url];

典型应用场景

  • 域名重定向（301/302）
  • 禁止特定 IP 访问（403）
  • 维护模式返回（503）

应用场景实例

server {listen 80 default_server;server_name www.a.com;root /data/sitea/html;index index.html;access_log /var/log/nginx/access-www.a.com.log main;# 首页：移动端跳转逻辑location = / {if ($http_user_agent ~* "android|iphone") {return 302 /mobile/;}try_files $uri $uri/ /404.html;}# 静态资源location /static/ {root /data/sitea;}# API 路由，并检查 id 参数格式location /api/ {root /data/sitea;set $invalid_id 0;if ($arg_id ~ ".+") {set $invalid_id 1;}if ($arg_id ~ ^\d+$) {set $invalid_id 0;}if ($invalid_id = 1) {return 400 "Invalid ID Format";}}# 移动页面location /mobile/ {root /data/sitea/html;index index.html;}# 其他路径 fallbacklocation / {try_files $uri $uri/ /404.html;}
}

 

验证方法
 

curl -I http://www.a.com/            # 应该返回 200 页面为curl http://www.a.com/               # 页面显示“SiteA Home”curl -I -H "User-Agent: iPhone" http://www.a.com/   #跳转移动端页面 返回302curl http://www.a.com/api/?id=abc    # 应该返回 400curl http://www.a.com/api/?id=123    # 应该返回 200curl http://www.a.com/mobile/        # 应该返回 index.htmlcurl http://www.a.com/maintenance=1  # 返回500 最终显示404
 

 

rewrite 指令：URI 重写的核心能力
 

rewrite 指令简介
 

​​​​​​​rewrite regex replacement [flag];
 

  •  
    regex：正则表达式，用来匹配原始 URI；
     
  •  
    replacement：用于替换的 URI；
     
  •  
    flag：可选参数，常用有：
     
    •  
      last：停止 rewrite，重新进入新的 location 匹配流程；
       
    •  
      break：停止 rewrite，但不重新匹配 location；
       
    •  
      redirect：返回 302 临时重定向；
       
    •  
      permanent：返回 301 永久重定向。
       
     
 

应用场景配置
 

server {listen 80 default_server;server_name www.a.com;root /data/sitea;index index.html index.php;access_log /var/log/nginx/access-www.a.com.log main;########################################  301/302 Redirect Rewrite######################################## 永久跳转 old-about → about.htmllocation = /old-about {rewrite ^ /about.html permanent;}# 临时跳转 beta → static 页面location = /beta {rewrite ^ /static/beta/index.html redirect;}########################################  break 内部 rewrite######################################## /doc → /static/docs/index.html，地址栏不变location = /doc {rewrite ^ /static/docs/index.html break;}########################################  首页移动端重定向#######################################location = / {if ($http_user_agent ~* "android|iphone") {return 302 /mobile/index.html;}try_files $uri $uri/ /404.html;}########################################  静态资源路径#######################################location /static/ {root /data/sitea;}########################################  RESTful API Rewrite#######################################location ~ ^/api/user/(\d+)$ {rewrite ^/api/user/(\d+)$ /api/v1/user.php?id=$1 last;}location ~ ^/api/product/(\d+)/detail$ {rewrite ^/api/product/(\d+)/detail$ /api/v1/product_detail.php?id=$1 last;}location ~ ^/api/order/(\d+)$ {rewrite ^/api/order/(\d+)$ /api/v1/order.php?id=$1 last;}########################################  通用 API 入口 + 参数校验#######################################location /api/ {root /data/sitea;index index.php;# 参数 id 格式校验set $invalid_id 0;if ($arg_id ~ ".+") {set $invalid_id 1;}if ($arg_id ~ ^\d+$) {set $invalid_id 0;}if ($invalid_id = 1) {return 400 "Invalid ID Format";}try_files $uri $uri/ /404.html;}########################################  移动页面#######################################location /mobile/ {root /data/sitea/html;index index.html;}########################################  默认 fallback，支持 .html 补全#######################################location / {try_files $uri $uri.html $uri/ /404.html;}########################################  PHP 处理 via FastCGI#######################################location ~ \.php$ {root /data/sitea;fastcgi_pass unix:/run/php-fpm/www.sock;fastcgi_index index.php;include fastcgi_params;fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;}
}
 

 目录结构应如下：
 

/data/sitea/
├── index.html
├── about.html
├── mobile/index.html
├── static/docs/index.html
├── static/beta/index.html
├── api/v1/user.php
├── api/v1/order.php
└── api/v1/product_detail.php
#php文件自行配置
 

 
 

测试命令：# 301 永久跳转
curl -I http://www.a.com/old-about# 302 临时跳转
curl -I http://www.a.com/beta# break 内部转向
curl http://www.a.com/doc# 自动补 .html
curl http://www.a.com/about# RESTful API
curl http://www.a.com/api/user/123
curl http://www.a.com/api/product/456/detail
curl http://www.a.com/api/order/789
 



                
                

                  

                    
                      
                  



                

                

                  
相关文章：

                    
                      
  • 
                        python同步mysql数据
                      
    • 
                    
                      
  • 
                        报错SvelteKitError: Not found: /.well-known/appspecific/com.chrome.devtools.json
                      
    • 
                    
                      
  • 
                        macOS 安装 Grafana + Prometheus + Node Exporter
                      
    • 
                    
                      
  • 
                        命令模式，观察者模式，状态模式，享元模式
                      
    • 
                    
                      
  • 
                        支持selenium的chrome driver更新到137.0.7151.55
                      
    • 
                    
                      
  • 
                        俄罗斯无人机自主任务规划！UAV-CodeAgents：基于多智能体ReAct和视觉语言推理的可扩展无人机任务规划
                      
    • 
                    
                      
  • 
                        【读代码】BabyAGI：自我构建的自主代理框架深度解析
                      
    • 
                    
                      
  • 
                        VR视角下，浙西南革命的热血重生​
                      
    • 
                    
                      
  • 
                        spark-AQE/Tungsten介绍及其触发条件
                      
    • 
                    
                      
  • 
                        手机打电话时将对方DTMF数字转为RFC2833发给局域网SIP坐席
                      
    • 
                    
                      
  • 
                        MongoDB（七） - MongoDB副本集安装与配置
                      
    • 
                    
                      
  • 
                        性能优化深度实践：突破vue应用性能
                      
    • 
                    
                      
  • 
                        机器学习数据降维方法
                      
    • 
                    
                      
  • 
                        【论文解读】DETR: 用Transformer实现真正的End2End目标检测
                      
    • 
                    
                      
  • 
                        【2025文博会现场直击】多图预警
                      
    • 
                    
                      
  • 
                        WSL 开发环境搭建指南：Java 11 + 中间件全家桶安装实战
                      
    • 
                    
                      
  • 
                        甘特图 dhtmlxGantt.js UA实例
                      
    • 
                    
                      
  • 
                        LVS-Keepalived高可用群集
                      
    • 
                    
                      
  • 
                        3D PDF如何制作？SOLIDWORKS MBD模板定制技巧
                      
    • 
                    
                      
  • 
                        LVS+Keepalived高可用集群
                      
    • 
                    

  • 合肥外贸网站建设公司/广告推广平台代理
    • 


  • 青岛网站建设邓巴迪/百度推广怎么注册账号
    • 


  • 厦门软件园网站建设/网络安全培训机构哪家好
    • 


  • wordpress增加页面分类/seo优化易下拉排名
    • 


  • pc网站怎么做自适应/百度网游排行榜
    • 


  • 网站做建筑三维图/宁波seo深度优化平台有哪些
    •