히포

• Nginx http image filter 모듈 : Module ngx_http_image_filter_module (nginx.org)

• ngx_http_image_filter_module모듈(0.7.54+)은 JPEG, GIF, PNG 및 WebP 형식의 이미지를 변환하는 필터
• --with-http_image_filter_module 모듈은 기본적으로 빌드되지 않으며 구성 매개변수로 활성화
• nginx의 nginx-module-image-filter 모듈에 필요한 library들을 미리 다운로드 → 다운되지 않아서 해당 내용 확인 필요
• 이미지를 변환하려면 libgd라이브러리를 WebP 지원으로 컴파일필요

    $ yum install -y gd gd-devel libc.so.6 libgd.so.2

ngx_http_image_filter_module 모듈 사용 예시

location /img/ {
    proxy_pass   http://backend;
    image_filter resize 150 100;
    image_filter rotate 90;
    error_page   415 = /empty;
}

location = /empty {
    empty_gif;
}

image_filter 지시어

• 이미지에 수행할 변환 유형을 설정
• 문맥: location
• 사용 문법과 사용 예시

    # 문법 : image_filter 설정값
    image_filter off;
    image_filter test;
    image_filter size;
    image_filter rotate 90 | 180 | 270;
    image_filter resize width height;
    image_filter crop width height;

• image_filter 설정값 종류
  1. off
     • 모듈 처리를 종료
       
       
  2. test
     • 응답이 JPEG, GIF, PNG 또는 WebP 형식의 이미지인지 확인
     • 그렇지 않으면 415(지원되지 않는 미디어 유형) 오류가 반환
       
       
  3. size
     • 이미지에 대한 정보를 JSON 형식으로 출력 → 출력 예시 : { "img" : { "width": 100, "height": 100, "type": "gif" } }
     • 오류 출력 → 출력 예시 : {}
       
       
  4. rotate 90|180|270
     • 지정된 각도만큼 이미지를 시계 반대 방향으로 회전함
     • 매개변수 값은 변수를 포함할 수 있음
     • 이 모드는 단독으로 또는 resize및 crop변환과 함께 사용 가능
       
       
  5. resize width height
     • 이미지를 지정된 크기로 비례적으로 축소함
     • 한 차원만 줄이려면 다른 차원을 " -"로 지정할 수 있음
     • 오류가 발생하면 서버는 코드 415(지원되지 않는 미디어 유형)를 반환
     • 매개변수 값에는 변수가 포함될 수 있음
     • rotate 매개변수와 함께 사용하면, 이미지의 크기를 축소한 후에 rotate 회전이 발생.
       
       
  6. crop width height
     • 비례적으로 이미지를 줄이고 불필요한 가장자리를 다른 면으로 자름 → 해당 이미지를 정해진 크기로 자르는 기능
     • 한 차원만 줄이려면 다른 차원을 " -"로 지정할 수 있음
     • 오류가 발생하면 서버는 코드 415(지원되지 않는 미디어 유형)를 반환
     • 매개변수 값에는 변수가 포함될 수 있음
     • rotate 매개변수와 함께 사용하면, 이미지의 크기를 축소한 후에 rotate 회전이 발생.

image_filter_buffer 지시어

• 이미지를 읽는 데 사용되는 버퍼의 최대 크기를 설정함
• 크기를 초과하면 서버에서 오류 415(지원되지 않는 미디어 유형)를 반환
• 문맥: http, server, location
• 사용 문법과 사용 예시

    # 문법 : image_filter_buffer size;
    image_filter_buffer 1M;

image_filter_interlace 지시어

• 활성화하면 최종 이미지가 인터레이스됨
• JPEG의 경우 최종 이미지는 "progressive JPEG" 형식이 됨
• 문맥: http, server, location
• image_filter_interlace 지시문은 버전 1.3.15에서부터 지원
• 사용 문법과 사용 예시

    # 문법 : image_filter_interlace on | off;
    image_filter_interlace off;

image_filter_jpeg_quality 지시어

• 변환된 JPEG 이미지 중 원하는 화질을 설정
• 허용되는 값은 1에서 100 사이
• 값이 작을수록 일반적으로 이미지 품질이 낮고 전송할 데이터가 적음
• 최대 권장 값은 95임
• 매개변수 값은 변수를 포함할 수 있음
• 문맥: http, server, location
• 사용 문법과 사용 예시

    # 문법 : image_filter_jpeg_quality quality;
    image_filter_jpeg_quality 75;

image_filter_sharpen 지시어

• 최종 이미지의 선명도를 높일 수 있음
• 선명도 백분율은 100을 초과할 수 있음
• 0 값은 선명도를 비활성화
• 매개변수 값은 변수를 포함할 수 있음
• 문맥: http, server, location
• 사용 문법과 사용 예시

    # 문법 : image_filter_sharpen percent;
    image_filter_sharpen 0;

image_filter_transparency 지시어

• GIF 이미지 또는 PNG 이미지를 팔레트로 지정된 색으로 변환할 때 투명도를 유지해야 하는지 여부를 정의
• 투명도의 손실은 더 나은 품질의 이미지를 만듦
• PNG의 알파 채널 투명도는 항상 유지됨
• 문맥: http, server, location
• 사용 문법과 사용 예시

    # 문법 : image_filter_transparency on|off;
    image_filter_transparency off;

image_filter_webp_quality 지시어

• 변환된 WebP 영상의 원하는 화질을 설정함
• 허용되는 값은 1에서 100 사이의 범위임
• 값이 작을수록 일반적으로 이미지 품질이 낮고 전송할 데이터도 적다는 것을 의미함
• 매개변수 값은 변수를 포함할 수 있음
• image_filter_webp_quality 지시문은 버전 1.11.6에서부터 지원
• 문맥: http, server, location
• 사용 문법과 사용 예시

    # 문법 : image_filter_webp_quality quality;
    image_filter_webp_quality 80;

참고 자료

• https://ohgyun.com/622

• Nginx http gzip_static 모듈 : Module ngx_http_gzip_static_module (nginx.org)

• ngx_http_gzip_static_module 모듈을 사용하면 일반 파일 대신 파일 확장자가 ".gz"인 미리 압축된 파일을 전송할 수 있음
• ngx_http_gzip_static_module 모듈은 기본적으로 빌드되지 않으며 --with-http_gzip_static_module 구성 매개변수를 사용하여 사용하도록 설정
• gzip_static은 정적 파일을 미리 gzip으로 압축해 두면 압축 프로세싱 과정 없이 즉시 해당 압축 파일을 전송함
• gzip_static 사용 시 CPU 점유율이 낮아지고 성능이 향상됨
• 예시) test.js파일에 대한 요청이 올 경우 test.js.gz를 찾아서 해당 파일이 존재하면 압축된 버전을 전송하고, 없으면 원본 파일을 압축한 뒤에 전송

• 구성 예시

    gzip_static  on;
    gzip_proxied expired no-cache no-store private auth;

gzip_static 지시자

• 미리 압축된 파일(precompressed files)의 존재 여부를 확인하도록 설정("on")하거나 해제("off")함
  • gzip_http_version → Module ngx_http_gzip_module (nginx.org)
  • gzip_proxied → Module ngx_http_gzip_module (nginx.org)
  • gzip_disable → Module ngx_http_gzip_module (nginx.org)
  • gzip_vary → Module ngx_http_gzip_module (nginx.org)

• "always" 값(1.3.6)을 사용하면 클라이언트가 지원하는지 확인하지 않고 모든 경우에 gzip 파일이 사용
• gzip_static 옵션은 디스크에 압축되지 않은 파일(uncompressed files)이 없거나 ngx_http_gunzip_module이 사용되는 경우에 유용
• 파일은 gzip 명령 또는 기타 호환되는 명령을 사용하여 압축할 수 있음
• 원본 파일과 압축 파일의 수정 날짜(modification data) 및 시간(time)은 동일하게 하는 것이 좋음

• 문맥 : http, server, location
• 사용 문법

    # 문법
    gzip_static on | off | always;

• 사용 예시

    # 사용 예시
    gzip_static off;

참고 자료

• nginx:gzip [권남] (kwonnam.pe.kr)

• Nginx http gunzip 모듈 : Module ngx_http_gunzip_module (nginx.org)

• ngx_http_gunzip_module 모듈은 "gzip" 인코딩 방식을 지원하지 않는 클라이언트에 대해 "Content-Encoding: gzip"으로 응답의 압축을 해제하는 필터
• ngx_http_gunzip_module 모듈은 공간을 절약하고 I/O 비용을 줄이기 위해 데이터를 압축하여 저장하는 것이 바람직할 때 유용
• ngx_http_gunzip_module 모듈은 기본적으로 빌드되지 않으며, --with-http_gunzip_module 구성 매개변수를 사용하여 활성화
  
  
• 구성 예시

    location /storage/ {
      gunzip on;
      ...
    }

gunzip 지시자

• gzip을 지원하지 않는 클라이언트에 대해 gzip 응답의 압축 해제를 사용하거나 사용하지 않도록 설정
• gunzip 지시자를 사용하면 클라이언트가 gzip을 지원하는지 여부를 결정할 때 다음 지시문도 고려
  • gzip_http_version → Module ngx_http_gzip_module (nginx.org)
  • gzip_proxied → Module ngx_http_gzip_module (nginx.org)
  • gzip_disable → Module ngx_http_gzip_module (nginx.org)
  • gzip_vary → Module ngx_http_gzip_module (nginx.org)
    
    

• 문맥 : http, server, location
• 사용 문법

  # 문법
  gunzip on | off;

• 사용 예시

  # 기본 설정
  gunzip off;

gunzip_buffers 지시자

• 응답의 압축을 푸는 데 사용되는 버퍼의 수와 크기를 설정
• 기본적으로 버퍼 크기는 1개의 메모리 페이지(one memory page)와 같음
• 플랫폼에 따라 4K 또는 8K
  
  
• 문맥 : http, server, location
• 사용 문법

  # 문법
  gunzip_buffers number size;

• 사용 예시

  # 기본 설정
  gunzip_buffers 32 4k|16 8k;

gunzip 사용 목적

• 목적
  1. 오리진 → nginx는 gzip 통신
  2. nginx → 사용자는 Accept-Encoding에 gzip(deflate)이 없으면 gunzip해서 보내기
     
     

• 사용자의 gzip content 종류 파악 (location 조정 필요)

    location / {
        gunzip on;   # 압축해제 기능 (기본 포함 되어 있음(현재 docker에))
        gunzip_buffers 16 64k; # 튜닝 필요
        proxy_set_header Accept-Encoding "gzip"; #오리진이 gzip 지원 해야 함.
        set $gaccept 'gzip';
    }

• ngx_http_empty_gif_module 모듈은 단일 픽셀 투명 GIF를 전송
• ngx_http_empty_gif_module 모듈 : Module ngx_http_empty_gif_module (nginx.org)

empty_gif 지시자

• 주변 위치에서 모듈 처리를 켬
• 문맥 : location
• 사용 문법

    # 문법
    empty_gif;

empty_gif 예제 구성

• 파일이 없는 경우 단일 픽셀 투명 GIF 전송할 수 있도록 설정

    location = /my_img {
      access_log off;
      empty_gif;
    }

• Nginx http addition 모듈 : Module ngx_http_addition_module (nginx.org)

• ngx_http_addition_module 모듈은 응답 전후에 텍스트를 추가하는 필터
• ngx_http_addition_module 모듈은 기본적으로 빌드되지 않으며 --with-http_addition_module 구성 매개변수를 사용하여 사용하도록 설정
  
  
• 구성 예시

    location / {
        add_before_body /before_action;
        add_after_body  /after_action;
    }

add_before_body 지시자

• 지정된 하위 요청을 처리한 결과 반환된 텍스트를 응답 본문 앞에 추가
• 매개변수로 빈 문자열("")을 사용하면 이전 구성 수준(previous configuration level)에서 상속된 추가를 취소할 수 있음
  
  
• 문맥 : http, server, location
• 사용 문법

    # 문법
    add_before_body uri;

add_after_body 지시자

• 응답 본문 뒤에 지정된 하위 요청을 처리한 결과로 반환된 텍스트를 추가
• 매개변수로 빈 문자열("")을 사용하면 이전 구성 수준(previous configuration level)에서 상속된 추가를 취소함
  
  
• 문맥 : http, server, location
• 사용 문법

    # 문법
    add_before_body uri;

addition_types 지시자

• "text/html" 외에 지정된 MIME 유형의 응답에 텍스트를 추가할 수 있음
• 특수 값 "*"는 모든 MIME 유형(0.8.29)과 일치
  
  
• 문맥 : http, server, location, limit_except
• 사용 문법

    # 문법
    addition_types mime-type ...;

• 사용 예시

    # 사용 예시
    addition_types text/html;

• Nginx http access 모듈 : Module ngx_http_access_module (nginx.org)

• ngx_http_access_module 모듈을 사용하면 특정 클라이언트 주소에 대한 액세스를 제한할 수 있음
• password, result of subrequest 또는 JWT에 의해 액세스를 제한할 수도 있음
• address와 password에 의한 동시 접근 제한(Simultaneous limitation of access)은 satisfy 지시어로 제어
  
  
• 구성 예시

  location / {
      deny  192.168.1.1;
      allow 192.168.1.0/24;
      allow 10.1.1.0/16;
      allow 2001:0db8::/32;
      deny  all;
  }

• rules은 첫 번째 일치 항목이 발견될 때까지 순차적으로 확인
• 주소 192.168.1.1을 제외한 IPv4 네트워크 10.1.1.0/16 및 192.168.1.0/24와 IPv6 네트워크 2001:0db8::/32에 대해서만 액세스가 허용
• 규칙이 많은 경우 ngx_http_geo_module 모듈 변수를 사용하는 것이 좋음

allow 지시자

• 지정된 네트워크 또는 주소에 대한 액세스를 허용
• 특수 값인 unix:(1.5.1)를 지정하면 모든 UNIX 도메인 소켓에 대한 액세스를 허용
  
  
• 문맥 : http, server, location, limit_except
• 사용 문법

  ## 문법
  allow address | CIDR | unix: | all;

deny 지시자

• 지정된 네트워크 또는 주소에 대한 액세스를 거부
• 특수 값인 unix:(1.5.1)를 지정하면 모든 UNIX 도메인 소켓에 대한 액세스를 거부
  
  
• 문맥 : http, server, location, limit_except
• 사용 문법

  ## 문법
  deny address | CIDR | unix: | all;