1 Summary
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_module configuration parameter.
2 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;
}
3 Directives
sub filter
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. Several sub_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.
sub filter last modified
Syntax: sub_filter_last_modifiedon | off;
Default 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. sub filter once
Syntax: sub_filter_onceon | off;
Default on
Context: http, server, location
Indicates whether to look for each string to replace once or repeatedly. sub filter types
Syntax: sub_filter_types mime-type ...;
Default 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).