ningx 响应内容替换

最新推荐文章于 2025-07-16 06:00:00 发布

原创最新推荐文章于 2025-07-16 06:00:00 发布 · 197 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#运维

nginx 专栏收录该内容

9 篇文章

订阅专栏

本文介绍了Nginx的ngx_http_sub_module子模块，该模块作为过滤器可以在响应中替换指定字符串。文章提供了配置示例，并详细解释了如何使用sub_filter指令及其它相关指令如sub_filter_last_modified和sub_filter_once等。

见官方文档：http://nginx.org/en/docs/http/ngx_http_sub_module.html

The ngx_http_sub_module module is a filter that modifies a response by replacing one specified string by another.

This module is not built by default, it should be enabled with the --with-http_sub_moduleconfiguration parameter.

Example Configuration

location / {
    sub_filter '<a href="http://127.0.0.1:8080/'  '<a href="https://$host/';
    sub_filter '<img src="http://127.0.0.1:8080/' '<img src="https://$host/';
    sub_filter_once on;
}

Directives

Syntax:	`sub_filter string replacement;`
Default:	—
Context:	`http`, `server`, `location`

Sets a string to replace and a replacement string. The string to replace is matched ignoring the case. The string to replace (1.9.4) and replacement string can contain variables. Severalsub_filter directives can be specified on one configuration level (1.9.4). These directives are inherited from the previous level if and only if there are no sub_filter directives defined on the current level.

Syntax:	`sub_filter_last_modified on \| off;`
Default:	sub_filter_last_modified off;
Context:	`http`, `server`, `location`

This directive appeared in version 1.5.1.

Allows preserving the “Last-Modified” header field from the original response during replacement to facilitate response caching.

By default, the header field is removed as contents of the response are modified during processing.

Syntax:	`sub_filter_once on \| off;`
Default:	sub_filter_once on;
Context:	`http`, `server`, `location`

Indicates whether to look for each string to replace once or repeatedly.

Syntax:	`sub_filter_types mime-type ...;`
Default:	sub_filter_types text/html;
Context:	`http`, `server`, `location`

Enables string replacement in responses with the specified MIME types in addition to “text/html”. The special value “*” matches any MIME type (0.8.29).