Nginx 설치와 설정 - 기초부터 실전까지

server {
    # 정적 파일 (이미지, CSS, JS)
    location /static/ {
        root /var/www/static;
        expires 30d;  # 브라우저 캐싱
    }

    # 동적 API 요청
    location /api/ {
        proxy_pass http://backend:3000;
    }
}

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m;

server {
    location / {
        proxy_cache my_cache;
        proxy_cache_valid 200 10m;  # 10분간 캐시
        proxy_pass http://backend;
    }
}

# Node.js 앱을 Nginx 뒤에 숨기기
server {
    listen 80;
    server_name myapp.com;

    # 모든 요청을 Node.js로 전달
    location / {
        proxy_pass http://localhost:3000;

        # 원본 클라이언트 정보 전달
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# 최상위: main 컨텍스트
user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;

# events 블록: 연결 처리 설정
events {
    worker_connections 1024;
}

# http 블록: HTTP 서버 설정
http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

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

    # server 블록: 가상 호스트 설정
    server {
        listen 80;
        server_name example.com;

        # location 블록: URI별 설정
        location / {
            root /usr/share/nginx/html;
            index index.html;
        }
    }
}

server {
    # 포트 80에서 수신
    listen 80;

    # 서버 이름 (도메인 또는 IP)
    server_name localhost;

    # 접근 로그
    access_log /var/log/nginx/mysite.access.log;
    error_log /var/log/nginx/mysite.error.log;

    # 루트 location
    location / {
        root /var/www/mysite;
        index index.html index.htm;
    }

    # 이미지 디렉토리
    location /images/ {
        root /var/www/mysite;
        # /images/logo.png 요청 → /var/www/mysite/images/logo.png
    }
}

server {
    listen 80;
    server_name app.example.com;

    location / {
        # 백엔드 서버로 프록시
        proxy_pass http://localhost:3000;

        # 프록시 헤더 설정
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 80;
    server_name myapp.com;

    # 정적 파일 (React, Vue 등 빌드 결과물)
    location / {
        root /var/www/myapp/dist;
        try_files $uri $uri/ /index.html;
    }

    # API 요청은 백엔드로 프록시
    location /api/ {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

try_files $uri $uri/ /index.html;
# 1. $uri: 요청한 파일이 존재하면 반환
# 2. $uri/: 디렉토리면 index 파일 찾기
# 3. /index.html: 없으면 SPA의 index.html 반환

# upstream 블록 (http 컨텍스트 내부)
upstream backend {
    # 기본: 라운드 로빈
    server backend1.example.com;
    server backend2.example.com;
    server backend3.example.com;
}

server {
    listen 80;

    location / {
        proxy_pass http://backend;
    }
}

# 1. 라운드 로빈 (기본)
upstream backend {
    server server1.com;
    server server2.com;
}

# 2. 가중치 기반
upstream backend {
    server server1.com weight=3;  # 더 자주 선택됨
    server server2.com weight=1;
}

# 3. IP 해시 (같은 클라이언트는 같은 서버로)
upstream backend {
    ip_hash;
    server server1.com;
    server server2.com;
}

server {
    listen 80;
    server_name example.com www.example.com;
}

listen 80;                    # IPv4, 포트 80
listen [::]:80;               # IPv6, 포트 80
listen 443 ssl;               # HTTPS
listen 80 default_server;     # 기본 서버

# 정확한 이름
server_name example.com;

# 와일드카드
server_name *.example.com;
server_name example.*;

# 정규표현식
server_name ~^www\d+\.example\.com$;

# 접두사 매칭
location /images/ {
    root /data;
}

# 정확한 매칭
location = / {
    # 정확히 "/" 요청만
}

# 정규표현식 (대소문자 구분)
location ~ \.php$ {
    # .php로 끝나는 모든 요청
}

# 정규표현식 (대소문자 무시)
location ~* \.(jpg|jpeg|png|gif)$ {
    # 이미지 파일
}

# root: 경로를 URI에 추가
location /images/ {
    root /data;
    # /images/cat.jpg → /data/images/cat.jpg
}

# alias: 경로를 URI로 대체
location /images/ {
    alias /data/photos/;
    # /images/cat.jpg → /data/photos/cat.jpg
}

index index.html index.htm index.php;
# 순서대로 파일 존재 확인

location / {
    try_files $uri $uri/ =404;
    # 1. 파일 확인
    # 2. 디렉토리 확인
    # 3. 404 에러 반환
}

# ❌ 잘못된 예
location /static/ {
    root /var/www/files/;
    # /static/style.css → /var/www/files/static/style.css ⚠️
}

# ✅ 올바른 예
location /static/ {
    alias /var/www/files/;
    # /static/style.css → /var/www/files/style.css ✅
}

# 슬래시 없음
location /api/ {
    proxy_pass http://backend;
    # /api/users → http://backend/api/users
}

# 슬래시 있음
location /api/ {
    proxy_pass http://backend/;
    # /api/users → http://backend/users (api 제거됨!)
}

# ❌ 잘못된 예
try_files $uri $uri/;
# 마지막 옵션이 없어서 에러 발생

# ✅ 올바른 예
try_files $uri $uri/ =404;
try_files $uri $uri/ /index.html;

# 명시적으로 기본 서버 지정
server {
    listen 80 default_server;
    server_name _;
    return 444;  # 알 수 없는 호스트 요청 거부
}