nginx - WindyHana's Solanara

Category: 어플리케이션
Description: 공개 경량 웹 서버인 nginx 의 설치와 실행에 대해 설명 (2014-01-27)
Location: WindyHana's Solanara: nginx (For first visitor, read About Solanara)
WindyHana's Solanara Twitter @solanara
Sorry, Korean Only.

개요

nginx(엔진엑스)는 러시아에서 만든 HTTP 서버, 리버스 프록시 서버다. 2002년 Igor Sysoev가 rambler.ru 에서 사용하기 위해 만들었으며, 쓰레드 기반이 아닌 이벤트 기반이며, 비동기식 서버다. 현재 알려져 있는 것 중에서는 윈디하나의 솔라나라: lighttpd와 함께 경량이면서도 빠른 것으로 알고 있다.
필자의 경우 nginx를 주로 리버스 프록시(웹캐시)로 사용하지만, 이 문서에서는 PHP-FPM(FastCGI Process Manager)를 이용해 PHP와 nginx 연동한다. PHP와 연동하려면 윈디하나의 솔라나라: AMP - PHP: Hypertext Preprocessor를 참고해 PHP-FPM을 설치하자.
참조

설치

Freetype
- 무료 오픈소스 폰트 라이브러리
- configure전에 include/config/ftoption.h의 FT_CONFIG_OPTION_SUBPIXEL_RENDERING을 언코멘트 하면 서브픽셀렌더링을 사용할 수 있지만, 기본적으로 비활성화되어있다. 마이크로소프트의 특허때문이다. FreeType & Patents를 읽어보자.
- harfbuzz 라이브러리와 같이 설치하면, 더 좋은 힌팅 기능을 사용할 수 있다.
- freetype 과 같이 컴파일시 "/usr/local/include/ft2build.h", line 56: cannot find include file: <freetype/config/ftheader.h> 와 유사한 오류가 나면 /usr/local/include/ft2build.h파일을 지운다. 이 파일은 더이상 사용되지 않으며 /usr/local/include/freetype2/ft2build.h으로 대체되었다.
- 공식홈페이지: The FreeType Project
```
# wget http://download.savannah.gnu.org/releases/freetype/freetype-2.8.1.tar.bz2
# tar xvfj freetype-2.8.1.tar.bz2
# cd freetype-2.8.1
# GNUMAKE="gmake" ./configure --with-harfbuzz=no 1)
# gmake
# gmake install
```
1) 64비트로 컴파일 하려면 CFLAGS="-m64" LDFLAGS="-m64"를 추가한다.

LibGD

동적 이미지 생성 라이브러리
공식홈페이지: LibGD
freetype 라이브러리가 필요

# wget https://github.com/libgd/libgd/releases/download/gd-2.2.3/libgd-2.2.3.tar.xz
# tar xvfJ libgd-2.2.3.tar.xz
# cd libgd-2.2.3
# ./configure --with-xpm=/usr --with-tiff=/usr --with-liq=/usr --with-webp=/usr
...
   Support for Zlib:                 yes
   Support for PNG library:          yes
   Support for JPEG library:         yes
   Support for WebP library:         no
   Support for TIFF library:         yes
   Support for Freetype 2.x library: yes
   Support for Fontconfig library:   yes
   Support for Xpm library:          yes
   Support for liq library:          no
   Support for pthreads:             yes
....
# vi Makefile
CFLAGS= -g -I/usr/openwin/include 1)
# vi src/Makefile
CFLAGS= -g -I/usr/openwin/include 1)
# /usr/sfw/bin/gmake
# /usr/sfw/bin/gmake install

1) -warn all를 삭제한다.

Perl Compatible Regular Expressions
- 펄 호환 정규 표현식 라이브러리
- 공식홈페이지: PCRE - Perl Compatible Regular Expressions
- 솔라리스 11에는 번들되어있다.
- libedit 필요
```
# wget ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-8.39.tar.bz2
# tar xvfj pcre-8.39.tar.bz2
# cd pcre-8.39
# ./configure CFLAGS="-I/usr/local/include"\
  --enable-utf \
  --enable-unicode-properties \
  --enable-pcregrep-libz \
  --enable-pcregrep-libbz2 \
  --enable-newline-is-anycrlf \
  --enable-pcre16 \
  --enable-pcre32 \
  --enable-jit \
  --enable-pcretest-libedit 1) 2)
# make
# make install
```
1) pcretest에 라인 편집 기능이 필요하지 않다면 이 줄을 제외하고 컴파일 해도 된다.
2) 64비트로 컴파일 하려면 CFLAGS="-m64" LDFLAGS="-m64" CXXFLAGS="-m64"를 추가하고 컴파일 하자.
nginx 를 빌드하기 위해 PCRE 라이브러리가 필요한 것이 아니라, 소스가 필요하다. 라이브러리를 만들어도 되지만 소스만 압축을 풀어놓아도 된다.
GeoIP C 라이브러리
- MaxMind 의 GeoIP 용 C 라이브러리
- 현재 새로은 GeoIP2 를 지원하는 새로운 C 라이브러리가 배포되어있지만, 여전히 구형 C 라이브러리를 사용하는 어플리케이션이 많다.
- 공식홈페이지: GeoIP C API
```
# wget https://github.com/maxmind/geoip-api-c/releases/download/v1.6.12/GeoIP-1.6.12.tar.gz
# tar xvfz GeoIP-1.6.12.tar.gz
# cd GeoIP-1.6.12
# ./configure CFLAGS="-m64"
# make
# make install
```

nginx

nginx 를 컴파일 하려면, OpenSSL과 PCRE 의 소스를 받아 압축을 풀어놓아야 한다. 윈디하나의 솔라나라: OpenSSL를 참조하자.

windy@wl ~/src # wget https://nginx.org/download/nginx-1.14.0.tar.gz
windy@wl ~/src # tar xvfz nginx-1.14.0.tar.gz
windy@wl ~/src # cd nginx-1.14.0
windy@wl ~/src/nginx-1.14.0 # ./configure \
  --prefix=/usr/local/nginx \
  --with-threads \
  --with-http_ssl_module \
  --with-http_v2_module \
  --with-http_realip_module \
  --with-http_addition_module \
  --with-http_xslt_module \
  --with-http_image_filter_module \
  --with-http_geoip_module \
  --with-http_sub_module \
  --with-http_dav_module \
  --with-http_flv_module \
  --with-http_mp4_module \
  --with-http_gunzip_module \
  --with-http_gzip_static_module \
  --with-http_auth_request_module \
  --with-http_random_index_module \
  --with-http_secure_link_module \
  --with-http_degradation_module \
  --with-http_slice_module \
  --with-http_stub_status_module \
  --with-mail \
  --with-mail_ssl_module \
  --with-stream \
  --with-stream_ssl_module \
  --with-pcre-jit \
  --with-pcre=../pcre-8.39 \
  --with-cc-opt="-O4" \
  --with-cpu-opt=amd64 \
  --with-openssl=../openssl-1.1.0g
windy@wl ~/src/nginx-1.14.0 # vi objs/Makefile 1)
CFLAGS =  -fast -m64  -g -O4
windy@wl ~/src/nginx-1.14.0 # make
windy@wl ~/src/nginx-1.14.0 # sudo make install
windy@wl ~/src/nginx-1.14.0 # /usr/local/nginx/sbin/nginx -v
nginx version: nginx/1.14.0

1) -xipo -errwarn=%all을 삭제한다.

설정

nginx.conf 설정
문서 루트를 정의하고 php 와의 연동을 위한 설정을 한다.
```
root@wl ~ # vi /usr/local/nginx/conf/nginx.conf
...
thread_pool   default threads=32 max_queue=65536; 1)
events {
    use eventport; 2)
...
}

http {
    server {
    ...
        # 문서의 루트를 정의. /usr/local/nginx/html
        location / {
            ...
            root   html;
            ...
        }
        # NGINX 상태 보기(http_stub_status_module 사용) 3)
		location /nginx_status {
			stub_status on;
			access_log   off;
			allow w.x.y.z;
			deny all;
		}
        ...
        # Fast-CGI로 PHP와 연동한다.
        location ~ \.php$ {
            try_files $uri =404;
            root           html;
            fastcgi_pass   127.0.0.1:9000;
            fastcgi_index  index.php;
            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
            include        fastcgi_params;
        }
        ...
root@wl ~ #
```
1) thread_pool 을 사용하도록 한다. NGINX는 솔라리스 AIO를 지원하지 않기 때문에 aio threads구문은 지원하지 않는다.
2) 솔라리스 10에 추가된 Event Port를 사용하도록 해준다. 하지만 솔라리스 10의 커널 패치(102485이상)를 하지 않으면 커널 패닉이 일어날 수 있으니 반드시 패치한다. (솔라리스 10 u10을 사용하고 있다면 이미 패치 되어있다. Sun Alert 102485 Security Vulnerabilities in The Solaris Event Port API May Result in a Denial of Service (DoS) Condition을 읽어보자) 이 옵션을 지정하지 않으면 /dev/poll 을 사용한다. 이외에도 리눅스에서는 epoll, BSD계열은 kqueue 를 사용할 수 있다. 자세한 사항은 Optimizations - Nginx Community을 참고하자.
3) http://w.x.y.z/nginx_status 에 접속해보면 아래와 유사한 화면을 볼 수 있다.
```
Active connections: 291
server accepts handled requests
  16630948 16630948 31070465
Reading: 6 Writing: 179 Waiting: 106
```
text/plain 형식으로 제공되기 때문에 커맨드라인 툴로 잘라내서 원하는 곳에서 사용할 수 있다. 의미는 다음과 같다.
- Active connections: 활성 커넥션 수
  - accepts: 접속 승인 개수
  - handled: 접속 처리 개수. 오류가 발생한 것이 아니라면, 일반적으로 accepts 와 동일하다.
  - requests: 총 요청 건수. keep-alive 가 off 인경우 handled 와 requests 가 동일하다.
- 커넥션 수 상세
  - Reading: 읽기(클라이언트에서 요청을 받음)중인 활성 커넥션 수
  - Writing: 쓰기(클라이언트로 응답을 전송)중인 활성 커넥션 수
  - Waiting: 대기중인 활성 커넥션 수
  따라서 Active connections = Reading + Writing + Waiting 이 성립한다.

특정 국가의 IP 블록

GeoIP, GeoLiteCity 를 사용해 특정 국가를 블록할 수 있다. 속도는 생각만큼 느리지 않은 것으로 생각한다.

root@wl ~ # mkdir /usr/local/geoip
root@wl ~ # cd /usr/local/geoip
root@wl /usr/local/geoip # wget http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz
root@wl /usr/local/geoip # gunzip GeoIP.dat.gz
root@wl /usr/local/geoip # wget http://geolite.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz
root@wl /usr/local/geoip # gunzip GeoLiteCity.dat.gz

nginx.conf 는 아래와 같은 설정을 추가한다. 이 설정은 중국IP를 블록한다.

root@wl ~ # vi /usr/local/nginx/conf/nginx.conf
...
http {
...
    geoip_country  /usr/local/geoip/GeoIP.dat;
    geoip_city     /usr/local/geoip/GeoLiteCity.dat;
...
    map $geoip_country_code $ip_allow {
        default yes;
        cn no;
    }

    server {
        ...
        if ($ip_allow = no) {
            return 403;
        }
    }
}
root@wl ~ #

리버스 프록시(Reverse Proxy)

서문에도 나와있듯, 필자는 nginx 를 주로 리버스 프록시로 사용한다.
nginx 를 웹 서버로 사용하기 보단 리버스 프록시 서버로 사용하고, 프록시 서버에서 gzip 압축을 통해 외부로 나가는 트래픽을 줄이도록 설정하자. 웹 서버는 '같은 호스트의 81번 포트'에서 서비스하고 있다고 가정한다. 설정 파일을 수정해야 할 곳이 많기 때문에 nginx의 전체 conf 파일을 싣는다. 그리고 이 설정은 필자가 사용하고 있는 설정과 비슷하다.
proxy 로 설정한후, proxy_pass 지시자를 사용하는게 핵심이다. 단 프록시를 사용하는 곳이 더 비효율적인 경우에는 nginx 가 직접 호스트하도록 한다.

root@wl ~ # cat /usr/local/nginx/conf/nginx.conf
user              nobody;
worker_processes  2;
error_log         logs/error.log;
pid               logs/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include        mime.types;
    default_type   application/octet-stream;

    access_log     logs/access.log;

    sendfile       on;
    tcp_nopush     on;
    keepalive_timeout 5;
    server_tokens  off;

    limit_conn_zone   $binary_remote_addr zone=zoneone:10m;

    gzip              on;
    gzip_comp_level   5;
    gzip_http_version 1.0;
    gzip_min_length   0;
    gzip_types        text/plain text/css image/x-icon application/x-javascript;
    gzip_vary         on;

    geoip_country  /usr/local/geoip/GeoIP.dat;
    geoip_city     /usr/local/geoip/GeoLiteCity.dat;
    map $geoip_country_code $ip_allow {
        default yes;
        cn no;
    }

    proxy_redirect            off;
    proxy_set_header          Host            $host;
    proxy_set_header          X-Real-IP       $remote_addr;
    proxy_set_header          X-Real-PORT     $remote_port;
    proxy_set_header          X-Forwarded-For $proxy_add_x_forwarded_for;
    client_max_body_size      10m;
    client_body_buffer_size   128k;
    client_header_buffer_size 64k;
    proxy_connect_timeout     90;
    proxy_send_timeout        90;
    proxy_read_timeout        90;
    proxy_buffer_size         16k;
    proxy_buffers             32   16k;
    proxy_busy_buffers_size   64k;

    server {
        listen       80;
        server_name  www.xxx.com;

        access_log   logs/www.xxx.com.access.log;
        error_log    logs/www.xxx.com.error.log debug;

        location / {
            proxy_pass      http://localhost:81/;
            limit_conn      zoneone 10;
        }
        
        location = /_.gif {
            empty_gif;
        }

        location /admin {
            proxy_pass      http://localhost:81/admin;
            allow 127.0.0.1;
            deny all;
        }

        location /images {
            proxy_pass      http://localhost:81/images;
            expires         max;
        }

        location /thumbimages {
            proxy_pass      http://localhost:81/images;
            image_filter    resize  150 100;
            image_filter_buffer 1M;
            image_filter_jpeg_quality 75;
            error_page      415 = /_.gif;
        }

        location /share {
            root   /share/;
            expires     max;
        }

        error_page  404              /404.html;
        error_page  500 502 503 504  /50x.html;

        location = /50x.html {
            root   html;
        }

        if ($ip_allow = no) {
            return 403;
        }
    }
}
root@wl ~ #

아파치 로그파일에는 접속IP가 모두 nginx 가 설치된 서버의 IP로 저장된다. 따라서 http.conf 의 로그 포맷을 바꿔야 한다.

root@wl ~ # vi /usr/local/apache2/conf/httpd.conf
...
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio
LogFormat "%{X-Real-IP}i:%{X-Real-PORT}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio-forward
...
SetEnvIf X-Real-IP "^.*\..*\..*\..*" forward
CustomLog "/var/log/httpd-access.log" combinedio-forward env=forward
CustomLog "/var/log/httpd-access.log" combinedio env=!forward
...

운영

시작 및 종료
※ nginx는 별도의 실행 스크립트를 제공하지 않는다. 아래와 같이 시작한다.
```
root@wl ~ # /usr/local/nginx/sbin/nginx
```
※ 실행한 후 http://localhost/ 을 보면 아래와 같은 화면이 나온다.

※ 종료는 아래와 같이 할 수 있다.
```
root@wl ~ # /usr/local/nginx/sbin/nginx -s stop
```
PHP 연동 확인
아래와 같이 실행해 http://localhost/phpinfo.php 에서 잘 실행되는지 확인하자. 만약 php에 접근할때 [No input file specified.] 가 나오면 SCRIPT_FILENAME 부분을 다시 한번 살펴보자.
```
root@wl ~ # vi /usr/local/nginx/html/phpinfo.php
<?php phpinfo(); ?>
root@wl ~ # /etc/init.d/php-fpm start 1)
```
1) 이 스크립트는 윈디하나의 솔라나라: AMP에서 PHP, PHP-FPM 설치및 설정 섹션에 설명했다.

시작/종료 스크립트

nginx 홈페이지에서는 아래와 같은 실행 파일을 제공해준다. 적당히 수정했다.
출처: Installing on Solaris 10u5 Installing on Solaris 11

nginx.sh

(774 바이트)

#!/bin/sh
 
NGINX_BASE_DIR="/usr/local/nginx"
NGINX_DAEMON="${NGINX_BASE_DIR}/sbin/nginx"
NGINX_CONF="${NGINX_BASE_DIR}/conf/nginx.conf"
  
__launch_signal( ) {
  ${NGINX_DAEMON} -s ${1} &>/dev/null
}

__checkconfig( ) {
  ${NGINX_DAEMON} -c ${NGINX_CONF} -t &>/dev/null
}
  
__start( ) {
  [ -r ${NGINX_CONF} ] || exit 1 
  __checkconfig && ${NGINX_DAEMON} -c ${NGINX_CONF} &>/dev/null || return ${?}
}
  
__stop( ) {
  __launch_signal stop
}
  
__reload( ) {
  __checkconfig && __launch_signal reload || return ${?}
}
 
__restart( ) {
  __stop && __start
}
 
__show_usage( ) {
  echo "Usage: ${0} {start|stop|restart|reload}"
  exit 3
}
 
case "${1}" in
  start|stop|restart|reload)
    [ -x ${NGINX_DAEMON} ] || exit 2
    __${1}
    ;;
  *)
    __show_usage
    ;;
esac

RSS ATOM XHTML 5 CSS3

nginx - WindyHana's Solanara

목차

개요

설치

Freetype

LibGD

Perl Compatible Regular Expressions

GeoIP C 라이브러리

nginx

설정

nginx.conf 설정

특정 국가의 IP 블록

리버스 프록시(Reverse Proxy)

운영

시작 및 종료

PHP 연동 확인

시작/종료 스크립트

nginx.sh