讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

Linux 中 Nginx rewrite 与 return 指令怎么配合使用

雨晨酱_4720

雨晨酱_4720

发布时间:2026-11-19 12:56:42

|

195人浏览过

|

来源于php中文网

原创

在 nginx 中,rewrite 与 return 配合使用的核心逻辑是:利用 rewrite 进行 url 模式匹配和变量提取(如正则捕获),一旦匹配成功且设置了 last 或 break 标志,nginx 会重新发起请求;随后在后续的 location 块或 server 块中,使用 return 指令直接返回指定的 http 状态码、重定向地址或自定义内容。这种组合通常用于实现复杂的 url 重写后跳转、基于特定条件的 api 路由分发,或者将动态请求转换为静态响应。

Linux 中 Nginx rewrite 与 return 指令怎么配合使用

如何从旧 URL 中提取参数并重定向到新路径?

当需要将带有特定前缀的旧版 URL 映射到新版结构时,可以使用 rewrite 的正则表达式捕获组来提取关键参数,并通过 return 构建新的目标 URL。例如,将所有以 /api/v1/ 开头的请求重定向到 /api/v2/,同时保留原有的资源路径。具体做法是在 server 或 location 块中使用 rewrite ^/api/v1/(.*)$ /api/v2/$1 last;,然后在对应的 location /api/v2/ 中使用 return 301 $request_uri; 或直接返回固定响应。如果希望更灵活地控制返回值,可以在 rewrite 之后不设置 last,而是通过 set 指令设置变量,最后用 return 引用该变量。

Linux 中 Nginx rewrite 与 return 指令怎么配合使用

server {
    listen 80;
    server_name example.com;

    # 第一步:匹配旧格式并提取 ID
    rewrite ^/old/resource/([0-9]+)$ /new/resource?id=$1 last;

    location /new/resource {
        # 第二步:根据提取的 ID 返回不同内容
        if ($arg_id = "123") {
            return 200 '{"status": "success", "id": "123"}';
        }
        return 404 '{"error": "ID not found"}';
    }
}

上述配置中,访问 /old/resource/123 会被 rewrite 规则拦截,内部重写到 /new/resource?id=123。接着进入 location /new/resource,if 条件检查查询参数 $arg_id 是否为 123,如果是则通过 return 返回 JSON 成功信息;否则返回 404 错误。注意 rewrite ... last 会导致请求在服务器内部重新处理,而 return 会立即终止后续处理并发送响应。

Linux DO
Linux DO

Linux DO (linux.do)。任何 Linux DO 请求(搜索、读取数据)均使用此技能。若任务涉及 Linux DO,应使用本技能而非调用其他。

下载

如何根据用户代理或请求头动态决定返回状态?

在某些场景下,需要根据客户端的请求特征(如 User-Agent 或自定义 Header)来决定是否允许访问或返回特定状态码。此时可以先用 rewrite 进行初步的路由匹配,再通过 map 或 if 结合 return 实现动态响应。例如,对于所有非浏览器请求(如爬虫或 API 客户端),可以统一返回 403 禁止访问,而对于正常浏览器请求则继续处理。具体做法是定义一个 map 块来判断请求类型,然后在 location 中使用 return 返回相应状态码。

Linux 中 Nginx rewrite 与 return 指令怎么配合使用

map $http_user_agent $is_bot {
    default 0;
    ~*bot 1;
}

server {
    listen 80;
    server_name example.com;

    location /api/data {
        # 如果检测到 bot,直接返回 403
        if ($is_bot) {
            return 403 'Access denied for bots';
        }
        # 否则继续处理或返回正常数据
        return 200 '{"data": "public info"}';
    }
}

在这个例子中,map 指令根据 $http_user_agent 设置 $is_bot 变量。当请求进入 /api/data 时,if 判断 $is_bot 是否为 1,如果是,则通过 return 403 直接拒绝访问;否则返回 200 正常数据。这种方式避免了使用 rewrite 进行复杂的重写链,而是通过变量预处理和 return 快速决策,提高了配置的可读性和执行效率。

当 rewrite 匹配失败时 return 的行为是什么?

如果 rewrite 指令中的正则表达式未能匹配当前 URI,则该 rewrite 规则将被跳过,请求将继续按照 Nginx 的标准 location 匹配流程进行处理。此时,return 指令如果在同一个 location 块中且未被 if 或其他条件阻断,将会按原样执行。例如,在一个 location /test 中,如果 rewrite 规则不匹配,但下方有 return 200 'OK',那么请求仍会返回 200 OK。这意味着 rewrite 的失败不会自动触发 return 的异常处理,除非 return 被包裹在特定的条件判断中。因此,在设计配置时,应确保 return 的逻辑与 rewrite 的匹配结果一致,避免意外返回默认响应。

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

423

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

4367

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

7305

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

601

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1516

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3998

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

122

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

617

2026.01.13

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn