[Infra Ops] Nginx 설치, 기본 설정, 정적 파일 서빙 실무

# 상태 확인 (active/inactive/failed)
sudo systemctl status nginx

# 시작 / 중지 / 재시작
sudo systemctl start nginx
sudo systemctl stop nginx
sudo systemctl restart nginx   # 완전 재시작 — 순간적으로 연결 끊김

# 설정 재로드 (처리 중인 요청 유지, 권장)
sudo systemctl reload nginx
# 또는 Nginx 고유 시그널로도 가능
sudo nginx -s reload

# 부팅 시 자동 시작 등록/해제
sudo systemctl enable nginx
sudo systemctl disable nginx

# 설정 검증 → 이상 없으면 reload (운영 서버 표준 절차)
sudo nginx -t && sudo systemctl reload nginx

[기동]  systemctl start nginx
   │
   ① master가 설정 로드 + 포트 bind(80/443)
   │    └ worker 프로세스를 CPU 코어 수만큼 fork (worker_processes auto)
   │
[요청]  클라이언트 → :80
   │
   ② worker의 이벤트 루프(epoll)가 연결 수락        (연결 1개 = worker_connections 1칸)
   │
   ③ Host 헤더 → server 블록 선택(server_name)      (없으면 default_server)
   │
   ④ URL → location 매칭(= 먼저, 그다음 ^~, 정규식, prefix)
   │    ├─ 정적 파일: root 경로에서 파일 읽어 응답
   │    └─ 동적 요청: proxy_pass 로 upstream(WAS)에 전달
   │
   ⑤ 응답 반환 + access_log 기록                    (Keep-Alive면 연결 유지·재사용)
   ▼
[클라이언트]  200 / 403 / 404 / 502 …

# /etc/nginx/nginx.conf (기본 구조)

# -- 전역 블록 --
# Nginx 프로세스 전체에 적용되는 설정
user  nginx;
worker_processes  auto;          # CPU 코어 수만큼 worker 생성 (auto 권장)
error_log  /var/log/nginx/error.log warn;
pid        /var/run/nginx.pid;

# -- events 블록 --
# 연결(connection) 처리 방식 설정
events {
    worker_connections  1024;    # worker당 최대 동시 연결 수
    # multi_accept on;           # 한 번에 여러 연결 수락 (고트래픽 시 활성화)
}

# -- http 블록 --
# HTTP 처리 전반 설정 (server 블록의 부모)
http {
    include       /etc/nginx/mime.types;   # 파일 확장자 → Content-Type 매핑
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent"';
    access_log  /var/log/nginx/access.log  main;

    sendfile        on;    # 커널 레벨 파일 전송 (정적 파일 성능 향상)
    keepalive_timeout  65; # 클라이언트 연결 유지 시간(초)

    # -- server 블록 (가상 호스트) --
    # 한 서버에서 여러 도메인/포트를 서비스할 때 블록을 추가
    server {
        listen       80 default_server;
        server_name  _;    # _ 는 모든 Host 헤더에 매칭 (catch-all)

        # -- location 블록 (URL 패턴 매칭) --
        location / {
            root   /usr/share/nginx/html;
            index  index.html;
        }
    }

    # 추가 설정 파일 포함 (conf.d/*.conf)
    include /etc/nginx/conf.d/*.conf;
}

server {
    listen 80;
    server_name example.com;
    root /var/www/html;

    # ① 일반 prefix 매칭 (가장 길게 일치하는 것 선택)
    location / {
        try_files $uri $uri/ /index.html;  # SPA 라우팅에 필수
    }

    # ② 더 구체적인 prefix — /api/로 시작하는 요청
    location /api/ {
        proxy_pass http://localhost:3000;  # 백엔드 서버로 프록시
    }

    # ③ 정확히 일치 (= 기호)
    location = /favicon.ico {
        log_not_found off;   # 404 로그 억제
        access_log off;
    }

    # ④ 정규식 매칭 (~: 대소문자 구분, ~*: 구분 안 함)
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 30d;         # 브라우저 캐시 30일
        add_header Cache-Control "public, immutable";
    }
}

# 실시간 액세스 로그 모니터링
sudo tail -f /var/log/nginx/access.log

# 출력 예시:
# 192.168.1.10 - - [30/May/2026:09:23:14 +0000] "GET / HTTP/1.1" 200 345 "-" "curl/7.81.0"
# 192.168.1.10 - - [30/May/2026:09:23:20 +0000] "GET /favicon.ico HTTP/1.1" 404 153 "-" "Mozilla/5.0"

# 에러 로그 확인 (warn 이상)
sudo tail -f /var/log/nginx/error.log

# 특정 상태코드만 필터링 (500 에러 찾기)
sudo grep ' 500 ' /var/log/nginx/access.log | tail -20

# 특정 IP의 요청만 확인
sudo grep '192.168.1.100' /var/log/nginx/access.log | tail -10

# 최근 1분간 요청 수 집계
sudo awk '{print $4}' /var/log/nginx/access.log | grep "$(date +'%d/%b/%Y:%H:%M')" | wc -l

# 404 많이 나는 URI 찾기
sudo awk '$9==404{print $7}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head -10