Nginx & Caddy 완전 정복 2편 — Nginx 기초: 아키텍처와 설정 파일 읽는 법

                ┌──────────────────┐
                │  master process  │  ← root 권한, 설정 로드, 포트 바인딩, 워커 관리
                └────────┬─────────┘
          ┌──────────────┼──────────────┐
   ┌──────▼─────┐ ┌──────▼─────┐ ┌──────▼─────┐
   │  worker 1  │ │  worker 2  │ │  worker N  │  ← 일반 권한, 실제 요청 처리
   │ (event loop)│ │ (event loop)│ │ (event loop)│
   └────────────┘ └────────────┘ └────────────┘
     수천 개 연결     수천 개 연결     수천 개 연결

# 간단하게: 배포판 패키지
sudo apt update
sudo apt install nginx
 
# 공식 저장소 (stable/mainline 선택 가능)
sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring
curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
  | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
http://nginx.org/packages/ubuntu $(lsb_release -cs) nginx" \
  | sudo tee /etc/apt/sources.list.d/nginx.list
sudo apt update && sudo apt install nginx

brew install nginx
# 설정 파일: /opt/homebrew/etc/nginx/nginx.conf (Apple Silicon 기준)

docker run -d --name web -p 8080:80 \
  -v $(pwd)/html:/usr/share/nginx/html:ro \
  nginx:stable-alpine

nginx -v          # 버전
nginx -V          # 버전 + 컴파일 옵션 + 포함된 모듈 (중요!)
systemctl status nginx
curl -I localhost

/etc/nginx/
├── nginx.conf              # 메인 설정 파일 (진입점)
├── mime.types              # 확장자 → Content-Type 매핑
├── conf.d/                 # *.conf 파일이 자동 include 됨 (공식 패키지 방식)
│   └── default.conf
├── sites-available/        # 사이트별 설정 보관 (Debian 계열 관례)
├── sites-enabled/          # 활성화할 사이트의 심볼릭 링크
└── snippets/               # 재사용 조각
/var/log/nginx/
├── access.log
└── error.log
/var/www/html/              # 기본 문서 루트 (공식 패키지는 /usr/share/nginx/html)

# Debian 방식으로 사이트 활성화
sudo ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

# ─── main 컨텍스트 (최상위) ───
user  nginx;
worker_processes  auto;
error_log  /var/log/nginx/error.log notice;
pid        /run/nginx.pid;
 
events {                       # ─── events 컨텍스트 ───
    worker_connections  1024;
}
 
http {                         # ─── http 컨텍스트 ───
    include       /etc/nginx/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  /var/log/nginx/access.log  main;
 
    sendfile        on;
    keepalive_timeout  65;
 
    server {                   # ─── server 컨텍스트 (가상 호스트) ───
        listen       80;
        server_name  localhost;
 
        location / {           # ─── location 컨텍스트 ───
            root   /usr/share/nginx/html;
            index  index.html index.htm;
        }
    }
 
    include /etc/nginx/conf.d/*.conf;
}

main
├── events
├── http
│   ├── upstream
│   └── server
│       └── location
│           └── location (중첩 가능)
└── stream          (L4 프록시, 4편)
    └── server

http {
    gzip on;                   # 모든 server가 상속
 
    server {
        root /var/www/site;    # 이 server의 모든 location이 상속
 
        location /legacy/ {
            gzip off;          # 여기서만 덮어씀
        }
    }
}

server {
    listen 80;
    server_name mysite.local;
 
    root  /var/www/mysite;
    index index.html;
 
    access_log /var/log/nginx/mysite.access.log;
    error_log  /var/log/nginx/mysite.error.log warn;
 
    location / {
        try_files $uri $uri/ =404;
    }
 
    # 정적 자산은 브라우저 캐시를 길게
    location ~* \.(css|js|png|jpg|jpeg|gif|svg|ico|woff2?)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
        access_log off;
    }
 
    error_page 404 /404.html;
}

sudo mkdir -p /var/www/mysite
echo '<h1>Hello Nginx</h1>' | sudo tee /var/www/mysite/index.html
sudo nginx -t && sudo systemctl reload nginx
curl -H "Host: mysite.local" http://localhost

# root: location 경로를 "붙여서" 찾는다
location /images/ {
    root /data;
}
# /images/cat.png → /data/images/cat.png
 
# alias: location 경로를 "대체해서" 찾는다
location /images/ {
    alias /data/pictures/;
}
# /images/cat.png → /data/pictures/cat.png

try_files $uri $uri/ /index.html;

sudo nginx -t                # 설정 문법 검사 (리로드 전에 무조건!)
sudo nginx -T                # 검사 + include된 것까지 합친 전체 설정 출력
sudo nginx -s reload         # 무중단 설정 리로드 (= systemctl reload nginx)
sudo nginx -s quit           # 처리 중인 요청을 마치고 종료 (graceful)
sudo nginx -s stop           # 즉시 종료
sudo nginx -s reopen         # 로그 파일 다시 열기 (logrotate 후)

sudo nginx -t && sudo systemctl reload nginx

sudo tail -f /var/log/nginx/access.log
sudo tail -f /var/log/nginx/error.log

203.0.113.7 - - [06/Oct/2026:10:15:32 +0900] "GET /index.html HTTP/1.1" 200 612 "-" "curl/8.5.0"