ngx_http_sub_module 모듈

• Nginx http sub 모듈 : Module ngx_http_sub_module (nginx.org)

Module ngx_http_sub_module

 

• 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;
    }

 

 

sub_filter 지시자

• 바꿀 문자열과 대체 문자열을 설정
• 바꿀 문자열은 대소문자를 무시
• 대체할 문자열(The string to replace)과 대체 문자열(replacement string)은 변수를 포함할 수 있음
• 동일한 구성 수준(same configuration level)에서 여러 개의 sub_filter 지시어를 지정 가능
• sub_filter 지시어는 현재 수준(current level)에 정의된 sub_filter 지시어가 없는 경우에만 이전 구성 수준(previous configuration level)에서 상속됨
  
  
• 문맥 : http, server, location
• 사용 문법

    ## 문법
    sub_filter string replacement;

 

 

sub_filter_last_modified 지시자

• 응답 캐싱(response caching)을 용이하게 하기 위해 교체하는 동안 원본 응답(original response)의 "Last-Modified" 헤더 필드를 보존할 수 있음
• 기본적으로 헤더 필드(header field)는 처리 중에 응답의 내용(contents of the response)이 수정되면 제거됨
  
  
• 문맥 : http, server, location
• 사용 문법

    ## 문법
    sub_filter_last_modified on | off;

• 사용 예시

    ## 기본 설정
    sub_filter_last_modified off;

 

 

sub_filter_once 지시자

• 대체할 각 문자열(each string to replace)을 한 번만 찾을지 반복해서 찾을지 여부를 나타냄
  
  
• 문맥 : http, server, location
• 사용 문법

    ## 문법
    sub_filter_once on | off;

• 사용 예시

    ## 기본 설정
    sub_filter_once on;

 

 

sub_filter_types 지시자

• 응답(responses)에서 "text/html" 외에 지정된 MIME 유형으로 문자열을 대체할 수 있도록 함
• 특수 값(special value)인 "*"는 모든 MIME 유형과 일치
  
  
• 문맥 : http, server, location
• 사용 문법

    ## 문법
    sub_filter_types mime-type ...;

• 사용 예시

    ## 기본 설정
    sub_filter_types text/html;