nginx

핵심 개념

reverse proxy

클라이언트 요청을 받아 내부 백엔드 서버로 전달하고 응답을 다시 클라이언트에 돌려주는 중계 방식으로, 백엔드를 외부에 직접 노출하지 않아도 됩니다.

server block

하나의 Nginx 인스턴스 안에서 도메인이나 포트별로 서로 다른 응답 규칙을 정의하는 설정 단위로, 아파치의 가상 호스트와 비슷한 개념입니다.

location block

요청 URL 경로 패턴에 따라 서로 다른 처리 방식(정적 파일 반환, 프록시 전달, 리다이렉트 등)을 지정하는 설정 블록입니다.

worker process

이벤트 루프 기반으로 다수의 연결을 논블로킹 방식으로 처리하는 Nginx의 실행 단위로, 적은 수의 프로세스로도 많은 동시 요청을 소화합니다.

SPA fallback

파일 시스템에 없는 경로 요청을 모두 index.html 등 하나의 진입 파일로 돌려보내, 클라이언트 사이드 라우팅을 쓰는 싱글 페이지 애플리케이션이 정상 동작하게 하는 설정 방식입니다.

SPA 정적 파일 서빙 설정

정적 빌드 파일을 서빙하면서 존재하지 않는 경로는 index.html로 돌려 SPA 라우팅을 지원하고, /api/ 요청은 백엔드 서버로 프록시합니다.

server {
    listen 80;
    root /usr/share/nginx/html;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

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