5월 23, 2026가이드

Nginx 리버스 프록시 설정

Node.js, Docker 등을 Nginx로 프록시. WebSocket·VPS SSL.

리버스 프록시는 Nginx가 공개 HTTP/HTTPS를 받아 백엔드(localhost:3000 Node.js, Docker, Python API 등)로 넘깁니다. Hiddence VPS 프로덕션에 필수입니다.

사전 요건

Nginx 설치·실행 중
백엔드가 localhost에서 대기(예: 127.0.0.1:3000)
SSL용 도메인이 VPS를 가리킴
방화벽에서 80·443 개방

기본 리버스 프록시 설정

도메인용 사이트 설정을 만듭니다:

bash

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

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        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;
    }
}

sudo nginx -t && sudo systemctl reload nginx

WebSocket 지원

Socket.io, 많은 대시보드, 실시간 앱에 필요합니다:

bash

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
}

Certbot으로 HTTPS 추가

HTTP가 동작하면 무료 인증서를 발급합니다:

bash

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d app.yourdomain.com

# Certbot will update your server block for SSL automatically

팁

스트리밍/SSE는 필요 시 proxy_buffering off
업로드용 client_max_body_size 설정
여러 백엔드는 서브도메인으로 분리
로드 밸런싱은 upstream 블록
502 Bad Gateway 시 error.log 확인