Skip to content

Instantly share code, notes, and snippets.

@ljlm0402

ljlm0402/README.md

Last active February 11, 2020 13:11
Show Gist options
  • Save ljlm0402/6e7f5883d0de72f5e656a275e49aed97 to your computer and use it in GitHub Desktop.
Save ljlm0402/6e7f5883d0de72f5e656a275e49aed97 to your computer and use it in GitHub Desktop.
Download ZIP
nginx 관련 Gist
Raw
README.md

Nginx

개요

  • Event-Driven 방식으로 클라 요청 처리하는 웹 서버
  • 이벤트 기반이라서 apache보다 좋은 성능 가짐

쓰임새

  • 리버스 프록싱
    • 외부에서 내부 서버 알 수 없으므로 보안 굿
    • 로드 밸런싱
    • ** forward(순방향) proxy는 내부망에서 외부로 나갈 때 프록시 거치는것
  • 정적파일 서빙

명령어

  • nginx -s SIGNAL

시작

  • nginx

종료

  • nginx -s stop
  • fast shutdown

조심스럽게 종료

  • nginx -s quit
  • graceful shutdown
  • 현재 연결된 요청까지 처리하고 shutdown

조심스럽게 리로드

  • nginx -s reload
  • graceful shutdown + 변경된 conf파일 적용 후 start

로그파일 재오픈

nginx -s reopen

conf 파일 분석

Simple directive

  • 한 줄짜리 지시어 -> 꼭 세미콜론(;) 붙혀야 함
user www-data; # 시스템의 어떤 사용자가 서버 동작시킬지 기술
# root 주면 워커 프로세스가 root 권한으로 동작하므로 위험  
# `useradd --shell /usr/sbin/nologin www-data` 이친구론 shell 접근 불가, nginx 구동용

worker_processes auto; # 워커 프로세스 생성 개수 - CPU 코어 수 맞추면 좋음
# worker_processes 4;

client_max_body_size 10M; # 업로드 최대 용량 (기본값 1MB)

log_not_found off; # 존재하지 않는 파일 요청 404를 로그 파일에 기록할 것인지
# log_not_found /logs/log/samplefile

pid /run/nginx.pid; # nginx pid 파일 위치
include /etc/nginx/modules-enabled/*.conf; # 외부 conf import

error_log /var/log/hwanseok.org.error debug;

Block directive

  • 블록 지시어
    • 블록 내부에 다수의 단순|블록 지시어 포함

events

  • 네트워크 동작방법 설정값
events {
	worker_connections 1024;
	# 하나의 워커 프로세스에서 몇개의 접속 동시 처리할 것인가
	# worker_connections * worker_processes = 4 * 1024 개의 동시 커넥션 
}

http - server - location

http {
	server {
		server_name hwanseok.org hs.com *.hs.org;  #호스트명(주로 도메인)
		# server_name localhost;
		include module_name/*;
		location {
		
		}
	}
}

http

  • server, location의 root 블록
    • 하위 블록에게 속성 상속
    • 하위 블록에서 중복 선언된 지시어는 상위 선언 무시

server

  • web site 하나 선언하는데 사용
    • 가상 호스팅(virtual host)
    • http://HS.org와 http://sy.org를 하나의 노드에서 운용 가능
server { 
	listen  80;
	server_name example.org www.example.org;
	...
}
server {
		listen 80;	      # 80포트에 대해서
		listen [::]:80;	 # 80포트에 대해서
		# https로 리다이렉트
		return 301 https://$host$request_uri;
	}

location

  • 특정 서버의 특정 URL을 처리하는 방법을 정의
  • URI 경로 일부이거나 정규식이 될 수 있음
  • 가장 긴 경로부터 비교하여 배정함
# 요청 경로에 images포함되면 /data, 파일 이름은 images 나머지는 다른 호스트
server {
	root 가서는 안될곳;  
	access_log 요런곳;  
	location /images/ { 
		access_log 요런저런곳;  
		root /data; 
		# http://hs.org/images/index.html 요청시 /data/index.html 반환
	} 
	location ~ \.(gif|jpg|png)$ {  
		access_log 저런곳;  
		# try_files $uri /index.html =404; 차례로 파일 있는지 확인
		root /data/images;
	}
	location / { 
		
		proxy_pass http://www.example.com;
	} 
}
# 리다이렉션
# last, break, redirect, permanent 플래그 있음
요청 URL: http://test.com/docs/readme.html

location ~ /docs/readme.html {
	rewrite ^ http://test.com/files/docs/readme.html;
}
# 내부 리다이렉션 - 브라우저는 모름
요청 URL: http://test.com/docs/readme.html
실제 파일 URL: http://test.com/files/docs/readme.html

location /docs/ {
	rewrite ^/docs/(.*)$ /files/docs/$1;
}
favicon때매 화나셨죠? 이걸로 해결하세요!
location = /favicon.ico {
	return 204;
}

upstream

  • 부하 분산, 속도 개선
  • 한 대의 웹 서버에 여러 대의 WAS 서버
  • ip_hash : 같은 ip 요청은 같은 서버가 처리
  • weight=n : 서버의 요청 처리 비중
  • max_fails=n : 지정한 횟수만큼 요청 실패시 죽은 것으로 간주
  • fail_timeout=n : 해당 시간만큼 timout이 max_fails 만큼 반복시 죽은 것으로 간주
  • down : 해당 서버를 사용하지 않게 지정 ip_hash 일때만 유효
  • backup : 모든 서버 다운시 활성화
http {
	server {
		location / {
			proxy_pass backend;
			proxy_http_version 1.1;
			proxy_set_header Upgrade $http_upgrade;
			proxy_set_header Connection 'upgrade';
			proxy_set_header Host $host;
			proxy_cache_bypass $http_upgrade;
		}
	}
	upstream backend {  
		ip_hash;
		# least_conn;
		# default round-robin
		
		server 192.168.125.142:9000 weight=3; # 다른 서버에 비해 3배 자주 사용
		server 192.168.125.143:9000; 
		server 192.168.125.144:9000 max_fails=5 fail_timeout=30s; # 30초 timeout 5번 반복되면 죽은것으로 간주해 요청 보내지 않음
		server unix:/var/run/php5-fpm.sock backup; # 나머지 서버 불능시 활성화 - 평소엔 비활성화
	}
}

mail

mail {

}

stream

  • TCP, UDP
stream {

}

연산자

  • (!)=
  • (!)~
    • 정규 표현식 매칭
    • $1 = 첫 번째로 매칭된 값 (n 가능)
    • location ~ "^/user/(?<user_id>[0-9]+)/(.*)$ 이면 첫번째 괄호가 $1, 두번째가 $2
#html로 끝나는($) 경로 접근에 대하여 처리
location ~ /.html$ { 
	error_log /var/log/hwanseok.org.error debug;
}
  • (!)~*
    • 대소문자 구별 안하는 정규 표현식 매칭

변수

다음 URL 접근시 환경 변수 http://hwanseok.org:80/production/module/index.html?type=module&id=12

  • $host : hwanseok.org
  • $uri : /production/module/index.html
  • $args : type=module&id=12
  • $server_addr : 115.68.24.88
  • $server_name : localhost
  • $server_port : 80
  • $server_protocol : HTTP/1.1
  • $arg_type : module
  • $request_uri : /production/module/index.php?type=module&id=12
  • $request_filename : /usr/local/nginx/html/production/module/index.html
  • $arg_type : module

$content_type $cookie_COOKIENAME $scheme - http/https

참조

  • 파일 위치 - linux
- /usr/local/nginx/conf
- /etc/nginx
- /usr/local/etc/nginx

참고한 블로그 및 사진 출처

Raw
nginx.md

nginx.conf

/etc/nginx/nginx.conf

user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
include /usr/share/nginx/modules/*.conf;

events {
    worker_connections 1024;
}

http {
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;

    sendfile            on;
    tcp_nopush          on;
    tcp_nodelay         on;
    keepalive_timeout   65;
    types_hash_max_size 2048;

    include             /etc/nginx/mime.types;
    default_type        application/octet-stream;
    include /etc/nginx/conf.d/*.conf;

    index   index.html index.htm;
}

default.conf

/etc/nginx/conf.d/default.conf

server {
    listen       80;
    server_name  localhost;

    location / {
        root   /usr/share/nginx/html;
        index  index.html index.htm;
        try_files $uri /index.html;
    }

    error_page   500 502 503 504  /50x.html;
    
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

reverse-proxy

server {
        listen 80;
        listen [::]:80;

        access_log /var/log/nginx/reverse-access.log;
        error_log /var/log/nginx/reverse-error.log;

        location / {
                    proxy_pass http://127.0.0.1:3000; # proxy pass
  }
}

defalut.conf

#user  nobody;
worker_processes  1;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;


events {
    worker_connections  1024;
}


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

    #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
    #                  '$status $body_bytes_sent "$http_referer" '
    #                  '"$http_user_agent" "$http_x_forwarded_for"';

    #access_log  logs/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;

    #gzip  on;

    server {
        listen       80;
        server_name  localhost;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location / {
            root   html;
            index  index.html index.htm;
        }

        #error_page  404              /404.html;

        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }

        # proxy the PHP scripts to Apache listening on 127.0.0.1:80
        #
        #location ~ \.php$ {
        #    proxy_pass   http://127.0.0.1;
        #}

        # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
        #
        #location ~ \.php$ {
        #    root           html;
        #    fastcgi_pass   127.0.0.1:9000;
        #    fastcgi_index  index.php;
        #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
        #    include        fastcgi_params;
        #}

        # deny access to .htaccess files, if Apache's document root
        # concurs with nginx's one
        #
        #location ~ /\.ht {
        #    deny  all;
        #}
    }


    # another virtual host using mix of IP-, name-, and port-based configuration
    #
    #server {
    #    listen       8000;
    #    listen       somename:8080;
    #    server_name  somename  alias  another.alias;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}


    # HTTPS server
    #
    #server {
    #    listen       443 ssl;
    #    server_name  localhost;

    #    ssl_certificate      cert.pem;
    #    ssl_certificate_key  cert.key;

    #    ssl_session_cache    shared:SSL:1m;
    #    ssl_session_timeout  5m;

    #    ssl_ciphers  HIGH:!aNULL:!MD5;
    #    ssl_prefer_server_ciphers  on;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}

}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment