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

NGINX ngx_http_addition_module 模块响应体前后注入内容

news 来源：原创 2025/5/24 14:52:12

一、模块概述

模块名称：ngx_http_addition_module
引入版本：自 0.7.9 起支持 addition_types，0.8.29 起支持“*”通配；
功能：对符合 MIME 类型的响应，在响应体前后分别插入指定子请求 URI 返回的内容；
默认状态：未内置，需要编译时加上 --with-http_addition_module。

二、编译启用

# 假设已下载 nginx 源码：
./configure --with-http_addition_module [其他参数...]
make
sudo make install

完成后可通过 nginx -V 查看是否出现 --with-http_addition_module 标志。

三、核心指令

1. `add_before_body`

add_before_body uri;

作用：在主响应体内容前，发起子请求 uri，并将子请求返回的响应体插入主响应中；
上下文：http、server、location；
取消继承：传入空字符串 add_before_body ""; 即可清除上级配置的前置注入。

2. `add_after_body`

add_after_body uri;

作用：在主响应体内容后，发起子请求 uri，并将子请求返回的响应体追加到主响应后；
上下文：同上；
取消继承：add_after_body "";

3. `addition_types`

addition_types mime-type ...;

默认值：仅对 text/html 响应生效；
扩展：可指定多种 MIME 类型，或使用 * 对任意类型生效（0.8.29+）；
上下文：http、server、location。

四、基本示例

http {server {listen 80;server_name example.com;# 对所有 text/html 响应，插入公共头与脚location / {add_before_body /common/header.html;add_after_body  /common/footer.html;}# 子请求返回的数据，仅做纯文本注入location = /common/header.html {default_type text/html;return 200 '<header><h1>欢迎访问 Example</h1></header>';}location = /common/footer.html {default_type text/html;return 200 '<footer><p>&copy; 2025 Example.com</p></footer>';}}
}

客户端访问 /index.html 时，NGINX 先读取原始文件内容，再分别向 /common/header.html、/common/footer.html 发起子请求，将两者内容前后拼接后返回。

五、进阶场景

1. 多类型注入

location /api/ {addition_types application/json text/plain;add_after_body  /injection/logging;
}

针对 JSON 接口或纯文本接口，也可注入调试信息或埋点脚本。

2. 条件注入

利用 if、map 等指令，按请求参数或 Header 控制是否注入：

map $arg_debug $do_add {default "";1       "/debug/info.html";
}location / {add_after_body $do_add;addition_types *;
}

当请求携带 ?debug=1 时，才将 /debug/info.html 内容追加至任意 MIME 类型响应后。

3. 与缓存配合

若子请求内容稳定，可借助 proxy_cache 或 fastcgi_cache 缓存子请求，减少注入带来的性能开销。

六、性能与注意事项

子请求开销
- 每一次注入都伴随子请求，可能增加延迟；建议将静态注入内容放在内存 lua_shared_dict（OpenResty）或缓存模块中。
MIME 类型过滤
- 默认仅对 text/html 注入；如果插入到二进制（如图片、下载包）将损坏响应，务必通过 addition_types 精确限定，或使用 * 时结合条件判断。
继承与层级
- 在 http/server 级定义全局注入，location 可覆盖：使用空参数清除继承。
循环注入
- 注意避免子请求 URI 又被自身注入，导致死循环；可通过精确 location = /uri 或在子请求中设置 add_before_body ""/add_after_body "" 取消注入。

七、总结

ngx_http_addition_module 提供了一种优雅的“响应体加料”手段，适合注入通用页头、页脚、埋点脚本及调试信息等场景。得益于子请求机制，可灵活复用已有模板或动态生成内容。结合 addition_types、条件判断与缓存优化，可在保证性能的前提下，实现高度可控的内容插入。希望本文示例与实践建议，能帮助你快速上手该模块，为你的 NGINX 服务增色添彩。

NGINX ngx_http_addition_module 模块响应体前后注入内容

一、模块概述模块名称：ngx_http_addition_module引入版本：自 0.7.9 起支持 addition_types，0.8.29 起支持“*”通配；功能：对符合 MIME 类型的响应，在响应体前后分别插入指定子请求 URI 返回的内容&#x…...

编程日记 2025/5/24 14:52:12

SpringMVC 使用thymeleaf 进行数据展示

thymeleaf 是前端的视图解析器，可以用于html页面上变量的渲染，如何来使用thymeleaf，下面我们来说一下： 首先引入相关的依赖： <dependency><groupId>org.thymeleaf</groupId><artifactId>thym…...

编程日记 2025/4/29 10:10:58

Github两种鉴权模式PAT与SSH

Github两种鉴权模式PAT与SSH 文章目录 Github两种鉴权模式PAT与SSH1. PAT鉴权2. SSH鉴权3.两种鉴权的切换 1. PAT鉴权通过 HTTPS 协议克隆和推送代码，使用用户名/密码或个人访问令牌（PAT）鉴权，所以PAT是与HTTPS协议相关的。该鉴…...

编程日记 2025/5/13 10:09:22

XrayR启动失败

公司要用服务器之间进行数据加密，这里用的XrayR 我使用的Centos 7。我这里使用一键脚本安装后，/etc/XrayR目录下没有配置文件。解决方案 XrayR安装时，系统没有unzip工具，也是会安装失败的，因为Centos7已经停止维…...

编程日记 2025/4/29 10:09:52

FPGA-数字时钟

FPGA-数字时钟总体设计用FPGA驱动数码管按照HH-MM-SS的格式显示时间，每秒用串口向上位机发送当前时间，当串口收到HH:MM:SS，对时间进行校准。由于年月要考虑到大小月，闰年等。为了简单起见，只考虑时分秒。数码管…...

编程日记 2025/5/22 4:23:11

数据结构 RBT 插入操作的 Python 代码实现

目录一、红黑树的性质二、红黑树的插入1. 插入根节点或根节点变红2. 双亲节点 P 为黑色3. 双亲结点 P 和叔伯结点 U 均为红色4. 双亲结点 P 为红色，叔伯结点 U 为黑色或缺失1）情形一2）情形二三、插入的 Python 代码实现红黑树动画演示网站…...

编程日记 2025/5/15 6:27:42

颖儿生活提案：用海信璀璨505U6真空冰箱重建都市鲜食自由

热播剧《六姊妹》中，演员颖儿饰演的何家艺以泼辣坚韧的形象深入人心，一双手撑起家庭的"烟火气"；戏外，她平衡事业与家庭，以自律姿态书写鲜活人生。近日，颖儿向公众展示家中厨房，意外…...

编程日记 2025/5/24 2:14:17

JQuery 使用技巧

文章目录隐藏/显示淡入淡出滑动追加新元素删除元素/内容设置 CSS 样式尺寸遍历Ajax根据 input 控件中的值实时改变另一个值 $()是jQuery()的简写getElementByTagName();如： $(“div”)getElementByTagName(“div”); $()的作用是用于查找出 HTML 的标签、属性、样…...

编程日记 2025/5/24 14:28:25

光流法：从传统方法到深度学习方法

1 光流法简介光流（Optical Flow）是指图像中像素灰度值随时间的变化而产生的运动场。简单来说，它描述了图像中每个像素点的运动速度和方向。光流法是一种通过分析图像序列中像素灰度值来计算光流的方法。对于图像数据计算出来的光流是一个二…...

编程日记 2025/4/29 10:07:44

如何选择合适的RFID手持终端设备？

一、明确核心需求，锁定关键参数选购RFID手持终端的首要任务是明确应用场景的核心需求。若用于仓储物流或零售盘点，推荐选择上海岳冉超高频RFID手持终端设备，支持1-20米远距离批量读取；若用于医疗耗材或图书管理，岳冉高…...

编程日记 2025/5/24 14:44:53

Axios 传参与 Spring Boot 接收参数完全指南

Axios 传参与 Spring Boot 接收参数完全指南本文详细说明前端 Axios 传参与后端 Spring Boot 接收参数的各类场景，包括 GET/POST/PUT/DELETE 请求、路径参数/查询参数/请求体参数的传递方式，以及如何接收 List、Map 等复杂类型。通过代码示例和对比表…...

编程日记 2025/5/24 14:08:31

NdrpPointerUnmarshallInternal函数分析之pStubMsg--pAllocAllNodesContext的由来

第一部分： // // Check if this is an allocate all nodes pointer AND that were // not already in an allocate all nodes context. // if ( ALLOCATE_ALL_NODES(pFormat[1]) && ! pStubMsg->pAllocAllNodesContext …...

编程日记 2025/5/19 6:17:02

人脑、深思考大模型与其他大模型的区别科普

文章目录大模型的基本概念与特点深思考大模型的独特之处深思考大模型与其他大模型的对比架构与技术训练数据应用场景提示词编写大模型给出答案的方式：基于概率还是真的会分析问题？人脑的思考过程基本单位与网络大脑结构与功能分区信息处理流程思维模式…...

编程日记 2025/5/24 14:25:16

Unity-粒子系统：萤火虫粒子特效效果及参数

萤火虫特效由两部分组成。萤火虫粒子底色粒子面片。萤火虫的旋转飞动主要由 Noise参数和Color over Lifetime模块控制。贴图：中间实周边虚的圆，可随意自行制作 Shader：Universal Render Pipeline/2D/Sprite-Lit-Default 以下是粒子详细参…...

编程日记 2025/4/29 10:06:37

Java垃圾收集器与内存分配策略深度解析

在 Java 与 C 的世界里，内存动态分配与垃圾收集技术仿佛筑起了一道高墙。墙外的人渴望进入，享受自动内存管理的便利；而墙内的人却试图突破，追求更高的性能与控制力。今天，就让我们深入探讨 Java 的垃圾收集器与内存分配…...

编程日记 2025/5/24 14:44:53

优化MySQL性能：主从复制与读写分离实践指南

目录一、知识介绍 1.MySQL主从复制原理 2.MySQL读写分离原理二、资源清单三、案例实施 1.修改主机名 2.搭建MySQL主从复制 3.搭建MySQL读写分离一、知识介绍 1.MySQL主从复制原理 MySQL支持的复制类型基于语句的复制基于行的复制混合模型复制工作过程主&#…...

编程日记 2025/5/24 14:41:26

Foupk3systemX5OS系统产品设备

Foupk3systemX5OS TXW8（基于Foupk3systemX5OS系统19.62正式版开发的智能移动设备由Foupk3systemX5OS系统与FOUPK3云服务平台共同自主研发） Foupk3systemX5OS TX6（Foupk3systemX5OS TX6基于Foupk3systemX5OS系统19.60正式版开发的智能平板设备…...

编程日记 2025/4/29 10:05:32

【计网】认识跨域，及其在go中通过注册CORS中间件解决跨域方案，go-zero、gin

一、跨域（CORS）是什么？ 跨域，指的是浏览器出于安全限制，前端页面在访问不同源（协议、域名、端口任一不同）的后端接口时，会被浏览器拦截。比如： 前端地址后端接口地址是…...

编程日记 2025/4/29 10:05:31

关于【Spring Boot Configuration Annotation Processor 未配置问题】的详细分析、解决方案及代码示例

以下是关于 Spring Boot Configuration Annotation Processor 未配置问题的详细分析、解决方案及代码示例： 1. 问题描述当使用 Spring Boot 的配置注解（如 ConfigurationProperties、Value、ConditionalOnProperty 等）时，若未…...

编程日记 2025/4/29 10:05:29

MySQL 的ANALYZE与 OPTIMIZE命令

MySQL 的ANALYZE与 OPTIMIZE命令一、ANALYZE TABLE - 更新统计信息 1. 基本语法与功能 ANALYZE [NO_WRITE_TO_BINLOG | LOCAL] TABLE tbl_name [, tbl_name] ...作用：收集表统计信息用于优化器生成更优的执行计划，主要更新： 索引基数&am…...

编程日记 2025/5/22 10:28:40

【机器学习】人工智能在电力电子领域的应用

摘要： 本文概述了电力电子系统的人工智能 (AI) 应用。设计、控制和维护这三个独特的生命周期阶段与人工智能要解决的一项或多项任务相关，包括优化、分类、回归和数据结构探索。讨论了专家系统、模糊逻辑、元启发法和机器学习四类人工智能的应用。我们对…...

编程日记 2025/4/29 10:05:28

InferType和_checked_type的区别？

在 TVM 的 Relay IR 中，relay.frontend.common.infer_shape(node) 和 node.checked_type.shape 都与**形状（Shape）**信息相关，但它们的用途、实现机制和性能特点有显著区别。以下是详细对比： 1. 功能区别特性node.ch…...

编程日记 2025/4/29 10:04:26

Flutter 学习之旅之 flutter 作为 module ，在 Android 端主动唤起 Flutter 开发的界面简单的整理

Flutter 学习之旅之 flutter 作为 module ，在 Android 端主动唤起 Flutter 开发的界面简单的整理目录 Flutter 学习之旅之 flutter 作为 module ，在 Android 端主动唤起 Flutter 开发的界面简单的整理一、简单介绍二、Android 端唤起 Flutter …...

编程日记 2025/4/29 10:04:26

vue3 css模拟语音通话不同语音、正在加载等的效果

实现效果如下： 在不同的时间，显示不一样的效果（大小是一样的，截图时尺寸发生了变化） 具体实现代码如下： <script setup> import {ref} from "vue";const max_hight ref(40px) const min…...

编程日记 2025/4/29 10:03:20

【Machine Learning Q and AI 读书笔记】- 01 嵌入、潜空间和表征

Machine Learning Q and AI 中文译名大模型技术30讲，主要总结了大模型相关的技术要点，结合学术和工程化，对LLM从业者来说，是一份非常好的学习实践技术地图. 本文是Machine Learning Q and AI 读书笔记的第1篇，对应原…...

编程日记 2025/5/23 20:01:23

[Agent]AI Agent入门02——ReAct 基本理论与实战

ReAct介绍 ReAct（Reasoning and Acting）是一种通过协同推理（Reasoning）与行动（Acting）提升大语言模型（LLM）任务解决能力的技术。其核心思想是在解决复杂问题时交替生成推理和动作&a…...

编程日记 2025/5/20 13:30:16

uniapp自定义头部(兼容微信小程序(胶囊和状态栏)，兼容h5)

很早之前就写过自定义头部，但是那时偷懒写死了，现在用插槽重新写了个有两种形式： type1是完全自定义的，可以自己去组件改也可以用插槽改 type2是正常的返回标题和右边按钮，使用就是 title"标题" rightClic…...

编程日记 2025/5/20 12:34:58

mybatis的xml ${item}总是更新失败

场景代码如下 void updateStatus(Param("deviceSerialIdCollection") Collection<String> deviceSerialIdCollection, Param("status") Integer status);<update id"updateStatus">UPDATE gb_monitor SET online#{status} WHERE d…...

编程日记 2025/5/19 20:16:09

数据库- JDBC

标题目录 JDBC基本概念JDBC 接口JDBC 工作原理 JDBC APIJDBC工作过程Driver 接口及驱动加载Connection 接口Statemen 接口ResultSet 接口PreparedStatement 接口 JDBC 基本概念 Java Database Connectivity：java访问数据库的解决方案希望用相同的方式访问不同的数…...

编程日记 2025/4/29 10:02:14

[26] cuda 应用之 nppi 实现图像格式转换

[26] cuda 应用之 nppi 实现图像格式转换讲述 nppi 接口定义通过nppi实现 bayer 格式转rgb格式官网参考信息：http://gwmodel.whu.edu.cn/docs/CUDA/npp/group__image__color__debayer.html#details1. 接口定义官网关于转换的原理是这么写的： Grayscale Color Filter Array …...

编程日记 2025/4/29 10:01:10

MYSQL-OCP官方课程学习截图

第一节介绍...

编程日记 2025/4/29 10:01:10

医院信息管理系统全解析

目录一、医院信息管理系统是什么 1. 概念阐释 2. 核心功能概述二、医院信息管理系统的种类 1. 医院信息系统（HIS） 2. 电子病历系统（EMR） 3. 实验室信息管理系统（LIS） 三、医院信息管理系统的实际…...

编程日记 2025/4/29 10:00:06

模型上下文协议（MCP）：技术解析与生态发展

一、概念与目标模型上下文协议（Model Context Protocol，MCP）是由Anthropic于2024年11月推出的开源协议，旨在为大语言模型（LLM）与外部工具、数据源提供标准化的双向通信框架。其核心目标是打破数据孤岛&am…...

编程日记 2025/5/5 21:36:36

laravel中layui的table翻页不起作用问题的解决

本地测试是好的，部署的时候就发现，翻页不起作用了。但lay_num序号是可以变化的，查看api接口传递的数据，发现数据没有变化，加上page2等翻页，也是不起作用，看来是url参数返回给后台，后…...

编程日记 2025/5/5 21:37:19

python上测试neo4j库

安装完了neo4j库后，如何使用。用python来小试牛刀 1.从其他博客上找来demo #coding:utf-8 from py2neo import Graph,Node,Relationship##连接neo4j数据库，输入地址、用户名、密码 graph Graph(bolt://xx.xx.xx.xx:7687,userneo4j,passwordneo4j1234)…...

编程日记 2025/5/5 21:38:39

云原生周刊：Kubernetes v1.33 正式发布

开源项目推荐 Robusta Robusta 是一个开源的 K8s 可观测性与自动化平台，旨在增强 Prometheus 告警的智能化处理能力。它通过规则和 AI 技术对告警进行丰富化处理，自动附加相关的 Pod 日志、图表和可能的修复建议，支持智能分组、自动修复和高…...

编程日记 2025/5/5 21:37:25

网络安全入门综述

引言在数字化时代，网络安全（Cybersecurity）已成为保护个人、企业和政府机构免受数字威胁的关键领域。随着互联网的普及、云计算的兴起以及物联网（IoT）设备的激增，网络攻击的频率和复杂性不断增加。从数据…...

编程日记 2025/5/5 21:37:23

LLaMA-Factory部署以及大模型的训练（细节+新手向）

LLaMA-Factory 经过一段时间的探索，从手动编写训练代码到寻求框架辅助训练，遇到了各种各样的问题。前面我介绍了dify的部署，但是并没有详细介绍使用方式，是因为我在尝试利用dify的时候碰到了很多困难，总结下来首先就是…...

编程日记 2025/5/5 21:37:29

ASP.NET MVC 入门指南四

21. 高级路由配置 21.1 自定义路由约束除了使用默认的路由约束，你还可以创建自定义路由约束。自定义路由约束允许你根据特定的业务逻辑来决定一个路由是否匹配。例如，创建一个只允许特定年份的路由约束： csharp public class YearRouteCo…...

编程日记 2025/5/5 21:37:25

rabbitmq-集群部署

场景：单个pod，部署在主节点，基础版没有插件，进阶版多了一个插件基础版本： --- apiVersion: v1 kind: PersistentVolume metadata:name: rabbitmq-pv spec:capacity:storage: 5GiaccessModes:- ReadWriteOncestorage…...

编程日记 2025/5/5 21:37:26

明远智睿SSD2351开发板：开启工业控制新征程

在工业控制领域，对开发板的性能、稳定性和扩展性有着极高的要求。明远智睿的SSD2351开发板凭借其卓越的特性，为工业控制带来了全新的解决方案。 SSD2351开发板搭载四核1.4GHz处理器，强大的运算能力使其在处理工业控制中的复杂任务时游刃有余。…...

编程日记 2025/5/5 21:37:29

RISCV学习（5）GD32VF103 MCU架构了解

RISCV学习（5）GD32VF103 MCU架构了解 1、芯片内核功能简介 GD32VF103 MCU架构，采用Bumblebee内核，芯来科技（Nuclei System Technology）与台湾晶心科技（Andes Technology）联合开发&am…...

编程日记 2025/5/5 21:37:19

IDEA2022.3开启热部署

1、开启IDEA的自动编译 1.1 具体步骤：打开顶部工具栏 File -> Settings -> Build,Execution,Deployment -> Compiler 然后勾选 Build project automatically 。 1.2 打开顶部工具栏 File -> Settings -> Advanced Settings -> Compiler -> 然…...

编程日记 2025/5/5 21:37:23

《算法吞噬幻想乡：GPT-4o引发的艺术平权运动与版权核爆》

一、引言：现象级AI艺术事件的社会回响 GPT - 4o吉卜力风格刷屏现象在当今数字化浪潮中，GPT - 4o吉卜力风格的作品在网络上掀起了一阵刷屏热潮。吉卜力工作室以其独特的水彩质感、奇幻氛围和孤独美学，在全球范围内拥有大量粉丝。而GPT - 4o强…...

编程日记 2025/5/5 21:37:27

yolov5 源码 +jupyter notebook 笔记 kaggle

YOLOv5 | Kaggle 直接用的githuab的源码，git clone 后output才有文件直接gitclone他的源码用Vscode看好久没见过16g了怎么这么便宜 https://gadgetversus.com/graphics-card/nvidia-tesla-p100-pcie-16gb-vs-nvidia-geforce-rtx-4060/#google_vignette 好的&am…...

编程日记 2025/5/5 21:37:27