Nginx 지시자(directive) 기초 분석 예제!!

Nginx 기본 설정 파일 (nginx.conf) 예제이며, 지시자(directive)마다 한글 주석을 달아 이해하기 쉽게 구성해드렸습니다.
버전은 Nginx 1.24 기준이며, 대부분의 설정은 최신 버전에서도 동일하게 작동

# 전역 설정 영역 (Global Settings)
user  nginx;                    # Nginx 프로세스를 실행할 사용자 (리눅스 유저)
worker_processes  auto;        # 워커 프로세스 수 (CPU 수에 따라 자동 설정)

error_log  /var/log/nginx/error.log warn;  # 에러 로그 파일 경로 및 로그 수준
pid        /var/run/nginx.pid;             # PID 파일 경로

# 이벤트 처리 설정
events {
    worker_connections  1024;   # 각 워커 프로세스당 최대 동시 접속 수
}

# HTTP 서버 설정 블록
http {
    include       /etc/nginx/mime.types;    # MIME 타입 정의 포함
    default_type  application/octet-stream; # 기본 응답 Content-Type

    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;            # sendfile() 사용 여부 (성능 향상)
    tcp_nopush      on;            # sendfile 최적화 (헤더와 콘텐츠를 한꺼번에 전송)
    tcp_nodelay     on;            # 지연 없이 패킷 즉시 전송

    keepalive_timeout  65;         # 연결 유지 시간 (초)
    types_hash_max_size 2048;      # MIME 타입 해시 테이블 크기

    include /etc/nginx/conf.d/*.conf;  # 개별 서버 블록 포함

    # 기본 서버 설정 (예시)
    server {
        listen       80;                    # 80번 포트로 수신
        server_name  localhost;            # 수신할 도메인 또는 IP

        # 에러 페이지 처리
        error_page 404 /404.html;          # 404 페이지 지정

        location = /404.html {
            root   /usr/share/nginx/html;  # 정적 파일 위치
        }

        # 정적 파일 서빙 경로
        location / {
            root   /usr/share/nginx/html;  # 정적 파일 기본 루트 디렉토리
            index  index.html index.htm;   # 기본 인덱스 파일 목록
        }

        # 예시: API 프록시 설정
        location /api/ {
            proxy_pass http://localhost:3000/;  # 백엔드 API 서버로 프록시
            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;
        }

        # 기타 에러 페이지 정의
        error_page 500 502 503 504 /50x.html;

        location = /50x.html {
            root   /usr/share/nginx/html;
        }
    }
}

 

 

✅ 주요 디렉티브 요약

user	Nginx 데몬 실행 사용자 지정
worker_processes	병렬로 처리할 프로세스 수
error_log	에러 로그 저장 경로와 로그 레벨
events	워커당 커넥션 제한 등 이벤트 처리 설정
http	HTTP 설정을 포함한 서버 및 로깅 설정
server	하나의 가상 서버 블록
location	URI 패턴에 따른 요청 처리 방식 정의
proxy_pass	리버스 프록시 백엔드 주소 지정
root	정적 파일 루트 디렉토리 설정
index	index 파일 우선순위