ngx_http_sub_module

ngx_http_sub_module 모듈은 지정된 문자열을 다른 문자열로 교체하여 응답을 수정하는 필터입니다.

이 모듈은 기본적으로 구축되지 않으므로 –with-http_sub_module 구성 매개변수로 활성화해야 합니다.

예제 구성

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

교체할 문자열과 교체 문자열을 설정합니다. 교체할 문자열은 대소문자를 구분하지 않고 매칭됩니다. 교체할 문자열(1.9.4)과 교체 문자열에는 변수를 포함할 수 있습니다. 동일한 구성 수준에서 여러 sub_filter 명령을 지정할 수 있습니다(1.9.4). 이러한 명령은 현재 수준에서 sub_filter 명령이 정의되지 않은 경우에만 이전 구성에서 상속합니다.

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.

교체 중에 원본 응답에서 “Last-Modified” 헤더 필드를 보존하면 응답을 캐싱하기 용이합니다.

기본적으로 처리 중에 응답 내용이 수정되므로 헤더 필드는 제거됩니다.

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

각 문자열을 한 번, 또는 반복적으로 교체할지 나타냅니다.

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

“text/html” 외에 지정된 MIME 유형을 포함한 응답에서 문자열 교체를 활성화합니다. 특수 값 “*”는 모든 MIME 형식(0.8.29)과 일치합니다.