讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

Nginx 中 sub 模块怎么批量替换响应内容

冬明小哥_3728

冬明小哥_3728

发布时间:2026-11-18 10:32:26

|

445人浏览过

|

来源于php中文网

原创

在 nginx 中,原生配置无法直接实现基于正则表达式的批量替换响应内容。要实现此功能,必须使用第三方模块 ngx_http_substitutions_filter_module。该模块通过指令 sub_filter 定义替换规则,利用 sub_filter_types 指定生效的 mime 类型,并配合 sub_filter_once 控制匹配次数,从而在代理返回给客户端的过程中完成内容的动态修改。

Nginx 中 sub 模块怎么批量替换响应内容

如何配置基础的正则替换规则

要启用替换功能,首先需要在 Nginx 编译时加载 ngx_http_substitutions_filter_module 模块。在服务器块或位置块中,使用 sub_filter 指令指定源字符串和目标字符串。默认情况下,该模块仅对 text/html 类型的响应生效,若需处理 CSS 或 JS 文件,必须显式添加 sub_filter_types。此外,sub_filter 支持简单的字符串匹配,若需使用正则表达式,需安装带有 --with-regex 标志的特定版本或使用 sub_filter_regex on 开启正则模式。

Nginx 中 sub 模块怎么批量替换响应内容

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://backend;

        # 启用替换功能
        sub_filter 'old-domain.com' 'new-domain.com';
        sub_filter 'src="/images/' 'src="/cdn/';

        # 指定生效的文件类型
        sub_filter_types text/html application/javascript text/css;

        # 确保只替换一次,避免死循环
        sub_filter_once on;
    }
}

上述配置将把 HTML、JS 和 CSS 响应中的 old-domain.com 替换为 new-domain.com,并将图片路径前缀从 /images/ 改为 /cdn/。sub_filter_once on 确保每个匹配项只被替换一次,防止因替换结果再次匹配原规则而导致无限循环。

如何处理多行内容和特殊字符

当需要替换的内容跨越多个行,或者包含引号等特殊字符时,配置方式略有不同。sub_filter 默认不跨行匹配,若需跨行替换,需确保源字符串中包含换行符(如 \n),或在某些版本中使用 sub_filter_last_modified off 来保证缓冲区的完整性。对于包含单引号或双引号的字符串,需在配置文件中正确转义,通常使用反斜杠 \ 进行转义。此外,若替换目标为空字符串,可直接留空,但需注意保留必要的空格或换行符以避免破坏页面布局。

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载

Nginx 中 sub 模块怎么批量替换响应内容

# 示例:替换包含引号的字符串
sub_filter 'class="active"' 'class="selected"';

# 示例:跨行替换(假设源文本中有换行)
sub_filter 'line1\nline2' 'replaced-line';

# 示例:删除某段内容(替换为空)
sub_filter '<!-- debug info -->' '';

在处理多行内容时,务必测试替换后的 HTML 结构是否依然合法。例如,删除某个标签时,需确保其闭合标签也被一并移除,否则可能导致浏览器解析错误。对于特殊字符,建议在本地 Nginx 环境中先进行小规模测试,确认替换效果后再部署到生产环境。

替换后如何验证响应内容是否正确

替换完成后,可通过 curl 命令查看响应头和内容,验证替换是否生效。使用 -I 参数检查 Content-Type 是否符合预期,使用 -v 参数查看详细交互过程。若替换未生效,需检查 sub_filter_types 是否包含当前响应的 MIME 类型,以及 proxy_pass 是否正确指向后端服务。此外,可使用 grep 或 awk 提取响应体中的关键部分,与预期结果对比,确保替换逻辑无误。

curl -I http://example.com/
curl -s http://example.com/ | grep 'new-domain.com'

若发现替换未生效,可尝试清除 Nginx 缓存或重启服务。同时,检查后端返回的响应是否被压缩(如 gzip),因为压缩后的内容可能无法被 substitutions_filter_module 正确处理。此时,需在 location 块中添加 proxy_set_header Accept-Encoding '';` 以禁用压缩,确保替换模块能读取原始响应内容。

热门AI工具

更多
函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

DeepSeek

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

UpDream
UpDream Hot

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

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

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

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

WorkBuddy

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

音述AI
音述AI Hot

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

相关专题

更多
nginx 重启
nginx 重启

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

423

2023.07.27

nginx 配置详解
nginx 配置详解

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

4327

2023.08.04

nginx配置详解
nginx配置详解

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

7265

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鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

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

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