1교시 · 요청 흐름과 인프라
브라우저에서 보낸 요청이 우리 서버의 어디를 거쳐 응답으로 돌아오는지 설명할 수 있으면 이 교시는 끝이에요. 운영 사실은 2026-11-18에 운영 서버에서 직접 확인한 값이에요.
① 큰 그림 — 백지에 그릴 수 있어야 해요
브라우저
│ ① DNS: 도메인 → 서버 IP
│ ② TCP 연결(3-way handshake) → TLS 핸드셰이크(HTTPS)
▼
nginx (443에서 TLS를 풀고, 속도 제한 검사)
│ ③ proxy_pass → 127.0.0.1:3000
▼
Node.js (SvelteKit을 adapter-node로 빌드한 build/index.js) ← PM2가 관리
│ ④ hooks.server.ts(로그인 확인) → +server.ts / load 함수
▼
MariaDB (커넥션 풀로 쿼리)
└ 응답은 거꾸로: DB → Node → nginx → 브라우저
server_name)을 보고 어느 포트로 보낼지 정해요.② 꼭 알아야 할 개념
DNS
도메인 이름을 IP 주소로 바꿔 주는 전화번호부예요. 브라우저는 IP를 알아야 접속할 수 있어요. 결과는 캐시돼서 매번 묻지 않아요(TTL).
TCP와 TLS(HTTPS)
- TCP: 데이터를 순서대로, 빠짐없이 주고받는 연결. 시작할 때 SYN → SYN-ACK → ACK(3-way handshake).
- TLS: TCP 위에 암호화를 얹는 것. HTTPS = HTTP + TLS. 서버는 인증서로 "내가 진짜 그 도메인"임을 증명해요.
- 인증서: 신뢰받는 기관(CA)이 서명한 파일. Let's Encrypt는 무료 CA이고, 유효기간이 90일이라 자동 갱신이 필수예요.
- TLS 종료(termination): 암호화를 nginx에서 풀고, 뒤의 Node와는 같은 서버 안에서 평문 HTTP로 통신하는 방식.
리버스 프록시(nginx)
손님(브라우저)은 nginx와만 대화하고, nginx가 뒤의 서버(Node)에 대신 전달해요. Node 앞에 두는 이유는 HTTPS 처리·속도 제한·도메인별 분기·정적 파일·접근 차단을 Node 대신 맡아서, Node는 비즈니스 로직에만 집중하게 하려는 거예요.
속도 제한(rate limit)
limit_req_zone: "누구를 기준으로, 초당 몇 건"인지 정의. 보통 IP 기준.rate=10r/s: 평균 초당 10건(정확히는 100ms마다 1건씩 통과).burst=100: 순간적으로 몰려도 100건까지는 대기열에 받아 줌.nodelay: 대기열에 든 요청을 기다리게 하지 않고 바로 처리. 대기열이 다 차면 거절.- 거절 응답 코드: 기본은 503이지만
limit_req_status 429로 429 Too Many Requests를 돌려주게 할 수 있어요.
Node.js 이벤트 루프
- JS를 실행하는 스레드는 하나. 대신 DB 응답·파일 읽기를 기다리는 동안 다른 요청을 처리해요(비동기 I/O).
- 그래서 기다림이 많은 웹 서버에 강해요.
- 약점: PDF·엑셀 생성처럼 CPU를 오래 쓰는 일을 하면 그동안 다른 요청이 전부 멈춰요. 해결책은
worker_threads, 별도 작업 서버, 큐.
PM2
- Node 프로세스가 죽으면 자동으로 다시 띄워 주는 프로세스 매니저.
- fork 모드: 프로세스 1개. cluster 모드: CPU 코어 수만큼 띄워서 요청을 나눠 받음.
- 재시작 한도(
max_restarts) 기본값은 16. 짧은 시간에 계속 죽으면 PM2가 포기하고errored상태로 둬요.
502 vs 504
| 코드 | 뜻 | 흔한 원인 |
|---|---|---|
| 502 Bad Gateway | nginx는 살아 있는데 뒤 서버가 응답을 못 줌 | Node 프로세스 죽음, 포트 연결 실패 |
| 504 Gateway Timeout | 뒤 서버가 제한 시간 안에 응답 안 함 | 느린 쿼리, CPU 블로킹 |
| 429 Too Many Requests | 속도 제한에 걸림 | nginx limit_req |
| 413 Payload Too Large | 업로드가 한도를 넘음 | client_max_body_size, BODY_SIZE_LIMIT |
EMFILE
프로세스가 동시에 열 수 있는 파일(소켓 포함) 수 한도를 넘었다는 에러예요. 접속이 몰려 정적 파일을 동시에 많이 열면 생겨요.
소켓 상태 TIME_WAIT / CLOSE_WAIT
- TIME_WAIT: 내가 먼저 연결을 끊은 뒤 잠시 기다리는 정상 상태. 너무 많으면 임시 포트가 마를 수 있어요(Windows 기본 240초 유지).
- CLOSE_WAIT: 상대는 끊었는데 내 쪽 프로그램이 소켓을 안 닫은 상태. 저절로 안 사라지고, 쌓이면 소켓 자원을 잡아먹어요. 프로그램 버그나 이상 프로세스의 신호예요.
③ 우리 서버 실제 — 숫자로 말할 수 있게
저장소의 nginx/nginx.conf, docker-compose.yml은 Docker 실험용이고 운영과 달라요. 아래가 운영 서버에서 확인한 값이에요.
| 항목 | 운영 값 |
|---|---|
| 서버 | Windows Server 1대(클라우드 호스팅), 여러 서비스가 함께 돎 |
| nginx | 1.22.1, 서버에 직접 설치(Docker 아님). 설정 파일 하나(nginx.conf)에 도메인별 server 블록 |
| Node 앱 | PM2로 11개. 공무링크는 build/index.js, PORT 3000, Node 20.20.2, fork 모드 1개 |
| HTTPS | Let's Encrypt 인증서. win-acme(wacs)가 작업 스케줄러로 매일 갱신 여부 확인(11-18 실행 성공). nginx가 443에서 TLS 종료 |
| nginx → Node | proxy_pass로 127.0.0.1:3000 |
| 속도 제한(운영 도메인) | 페이지 IP당 5r/s, API IP당 10r/s, 둘 다 burst 100 nodelay. 초과 시 429. 정적 파일은 제외, 사무실은 예외(2026-11-17 적용) |
| 속도 제한(테스트 도메인) | IP당 30r/s, burst 100 |
| 업로드 한도 | nginx client_max_body_size 1000M, Node BODY_SIZE_LIMIT 100MB → 실제로 먼저 걸리는 건 Node의 100MB |
| 배포 | deploy.sh: git pull → npm i → build2로 빌드 → 스왑(build→build1 백업, build2→build) → pm2 restart. 실패하면 그 단계에서 멈춤. rollback 모드는 build1을 되돌림 |
build2)에 하니까 빌드하는 동안에도 기존 서비스는 그대로 돌아요. 끊기는 건 pm2 restart 순간 몇 초뿐이고, 문제가 생기면 직전 빌드로 바로 되돌릴 수 있어요. 완전한 무중단은 아니에요(프로세스가 1개라서).④ 장애와 사고 두 가지
A. EMFILE로 Node가 죽던 502 (2026-06 대응)
- 증상: 접속이 몰리면 502.
- 원인: adapter-node가 쓰는 정적 파일 라이브러리
sirv(2.0.4)가createReadStream().pipe()를 에러 처리 없이 호출. 파일 핸들이 고갈되면 EMFILE이 처리되지 않은 예외(uncaughtException)가 되어 프로세스 전체가 종료. - 해결: 진입 파일
server-start.js를 따로 만들고, 앱(build/index.js)을 동적 import로 나중에 불러와서 그보다 먼저 전역 핸들러를 등록.EMFILE/ENFILE/EBADF만 로그 남기고 흡수, 나머지는 종료시켜 PM2가 재시작하게 함. 저장소의 PM2 설정에서 재시작 한도도 16 → 50. - 핵심: 모든 에러를 삼키지 않고 복구 가능한 것만 골라서 삼켰다. 다 삼키면 진짜 버그가 숨어요.
- 운영 PM2는
build/index.js를 직접 실행해요. 가드가 돌려면server-start.js가 실행돼야 해요. 재시작 한도도 운영은 기본값 16이에요. - 적용했다가 되돌린 게 아니에요. 09-04 502 진단 기록에도 이미 "가드 빠짐"으로 적혀 있어요.
- 이유: 저장소의 PM2 설정을 운영에 그대로 쓸 수 없었어요. 앱 이름이 운영 이름과 다르고, 빌드 폴더(
build2)도 달라요. 운영 설정은 앱 11개가 같이 쓰는 파일이라 서버에서 손으로 관리해요. 그래서 저장소 쪽 변경이 옮겨지지 않았어요. - 실제 위험은 작아요. 지금은 nginx가
/_app/정적 파일을 직접 내보내서, Node(sirv)가 정적 파일을 열다 EMFILE을 낼 일이 드물어요. - 로그의
[recovered]0건은 증거가 아니에요. 가드가 돌고 있어도 EMFILE이 안 났다면 똑같이 0건이에요.
B. 운영 서버 침해 사고 (2026-08)
회사·서버 이름 없이 일반화해서 말해요.
- 증상: 한 서버에 있는 모든 서비스가 동시에 502. 한 앱이 아니라 전부라는 게 첫 단서.
- 로그: nginx에
no live upstreams와10055(WSAENOBUFS, Windows 소켓 자원 부족)가 포트를 가리지 않고 반복. - 첫 가설 기각: 10055의 대표 원인인 임시 포트 고갈을 의심했지만, TIME_WAIT가 16,384개 중 17개뿐이라 기각. 에러 코드만 보고 단정하지 않고 숫자로 확인함.
- 단서: CLOSE_WAIT가 156개로 비정상. 소켓을 붙잡은 프로세스를 PID로 추적.
- 원인: 지원 종료된 구버전 Java 기반 Tomcat의 AJP 포트(8009)가 인터넷에 노출돼 있었고(Ghostcat 취약점 추정 경로), 공격자가 관리자 계정을 만들어 약 3주간 암호화폐 채굴기와 포트 스캐너를 돌리고 있었음. 이것들이 소켓을 고갈시켜 502가 남.
- 조치: 악성 파일 무력화 → 공격자 계정 삭제가 아닌 비활성화(증거 보존) → 3분마다 재실행되던 예약 작업 제거 → 노출 포트(AJP, WinRM, DB) 방화벽 차단·제한 → 보안 로그 20MB → 512MB 확대(공격 트래픽에 밀려 증거가 유실됐기 때문).
- 교훈: 쓰지 않는 서비스·포트를 열어 두지 않는다. 로그 보관량이 부족하면 원인 추적이 불가능해진다. 가설은 수치로 검증한다.
본인이 직접 한 부분(로그 분석, 가설 검증, 조치 실행 등)만 "제가"로 말하세요. 계정 이름·IP·회사명은 말하지 않아요.
참고: 남아 있는 nginx 에러 로그 기준 502
2026-10-16(2건), 2026-10-26(6건) 뒤 서버 연결 실패 기록이 있어요. 서버 전체 기준이라 어느 서비스인지는 따로 확인해야 해요.
⑤ 암기 카드 — 눌러서 답 확인
502 뜻
504 뜻
429 뜻
EMFILE
CLOSE_WAIT가 쌓인다는 건?
운영 속도 제한 (페이지 / API)
burst와 nodelay
업로드 한도 (nginx / Node)
HTTPS 인증서
nginx가 Node로 보내는 주소
PM2 모드와 프로세스 수, 이유
PM2 재시작 한도 기본값
EMFILE 가드가 흡수하는 에러 3개
가드를 동적 import로 한 이유
배포 스왑 순서
침해 사고 때 기각한 가설과 근거
침해 사고 진짜 원인
SvelteKit을 Node 서버로 만드는 것
로그인 확인이 일어나는 파일
⑥ 예상 질문과 모범답안 — 소리 내어 3번
Q1. 브라우저에 주소를 치면 응답이 오기까지 무슨 일이 일어나나요?
DNS로 도메인을 IP로 바꾸고, 그 IP로 TCP 연결을 맺은 뒤 TLS 핸드셰이크로 암호화 채널을 만듭니다. 저희 서비스는 그 요청을 nginx가 443에서 받아서 TLS를 풀고, 속도 제한을 확인한 다음 같은 서버의 Node(3000번 포트)로 넘깁니다. Node에서는 SvelteKit의 hooks에서 쿠키 속 JWT로 로그인을 확인하고, API나 load 함수가 커넥션 풀로 MariaDB에 쿼리한 결과를 돌려줍니다. 응답은 같은 길을 거꾸로 돌아갑니다.
Q2. nginx를 왜 Node 앞에 두나요? Node가 직접 443을 받으면 안 되나요?
받을 수는 있지만 앞에 두는 게 낫다고 봅니다. 저희는 한 서버에서 11개 서비스를 돌리는데, nginx가 도메인 이름을 보고 각 포트로 나눠 주고, 인증서도 한곳에서 관리합니다. 속도 제한과 접근 차단도 nginx에서 처리하니 Node는 비즈니스 로직에만 집중합니다. Node가 직접 받으면 서비스마다 인증서와 제한 로직을 따로 구현해야 합니다.
Q3. 속도 제한은 어떻게 설정했나요? 값은 어떻게 정했나요?
nginx limit_req로 IP 기준 페이지는 초당 5건, API는 초당 10건, 둘 다 burst 100에 nodelay로 걸었고 넘으면 429를 돌려줍니다. 정적 파일은 화면 하나에 수십 개씩 요청되니 제외했고, 사무실은 업무상 요청이 많아 예외로 뒀습니다. burst를 넉넉히 둔 건 화면 진입 순간 API가 한꺼번에 나가는 정상 사용자를 막지 않으려는 것이고, 대신 평균 속도로 크롤링 같은 지속적인 대량 요청을 거르는 구조입니다.Q4. HTTPS 인증서는 어떻게 관리하나요?
Let's Encrypt 인증서를 쓰고, 유효기간이 90일이라 Windows 작업 스케줄러에 win-acme를 등록해 매일 갱신 대상인지 확인하고 자동으로 갱신합니다. nginx가 도메인별로 인증서를 물고 443에서 TLS를 종료하고, 뒤의 Node와는 같은 서버 안이라 HTTP로 통신합니다.
Q5. PM2는 왜 쓰고, 왜 프로세스를 1개만 띄우나요?
프로세스가 죽었을 때 자동으로 다시 띄우려고 씁니다. cluster 모드로 여러 개 띄우면 CPU를 더 쓸 수 있지만, 저희는 node-schedule로 예약 작업(예: 매일 아침 자동결제)을 서버 안에서 돌리고 있어서 프로세스마다 같은 작업이 중복 실행됩니다. 결제처럼 중복되면 안 되는 작업이라 1개로 유지했고, 확장이 필요해지면 예약 작업을 별도 프로세스로 분리한 뒤 웹 서버만 여러 개로 늘리는 게 다음 단계라고 봅니다.
Q6. 502가 나면 어떤 순서로 원인을 찾나요?
먼저 범위를 봅니다. 한 서비스만인지, 서버의 모든 서비스인지에 따라 앱 문제인지 서버 자원 문제인지 갈립니다. 그다음 nginx 에러 로그에서 연결 실패 사유를 보고, PM2 상태와 재시작 횟수, 앱 에러 로그를 확인합니다. 서버 전체라면 netstat으로 연결 상태 분포와 어떤 프로세스가 소켓을 잡고 있는지 봅니다. 가설을 세우면 반드시 수치로 확인하고 넘어갑니다.
Q7. 장애를 해결한 경험이 있나요? (EMFILE)
접속이 몰리면 502가 나는 문제가 있었습니다. 로그를 보니 정적 파일을 여느라 파일 핸들 한도를 넘는 EMFILE이 났는데, SvelteKit이 쓰는 sirv 라이브러리가 이 스트림 에러를 처리하지 않아서 처리되지 않은 예외로 Node 프로세스 전체가 죽고 있었습니다. 진입 파일을 따로 두고 앱을 동적 import로 나중에 불러와서, 그보다 먼저 전역 예외 핸들러를 등록했습니다. 파일 핸들 계열 에러 세 가지만 기록하고 넘기고, 그 밖의 에러는 종료시켜 PM2가 재시작하게 했습니다. 모든 에러를 삼키면 진짜 버그가 숨기 때문에 복구 가능한 것만 골랐습니다.
⚠ 꼬리질문 대비
"운영에 적용됐나요?" → "저장소에는 넣었지만, 운영 서버의 PM2 설정은 서버에서 따로 관리하는 파일이라 옮겨지지 않았습니다. 나중에 운영 설정을 직접 확인하면서 알았습니다. 지금은 nginx가 정적 파일을 직접 내보내서 Node가 정적 파일을 열 일이 드물어, 실제 위험은 작습니다."
교훈: 코드에 넣은 것과 운영에 돌고 있는 것은 따로 확인해야 한다.
Q8. 배포는 어떻게 하나요? 무중단인가요?
배포 스크립트로 git pull, 패키지 설치, 빌드를 하는데 빌드는 별도 폴더에 합니다. 빌드가 끝나면 현재 빌드를 백업 폴더로 옮기고 새 빌드로 바꾼 뒤 PM2로 재시작합니다. 그래서 빌드하는 동안에도 서비스는 그대로이고, 문제가 생기면 rollback 모드로 직전 빌드를 바로 되돌립니다. 다만 프로세스가 1개라 재시작 순간 몇 초는 끊길 수 있어서 완전한 무중단은 아닙니다. 무중단이 필요하면 프로세스를 2개 이상 두고 하나씩 재시작하거나, 앞단에서 트래픽을 옮기는 방식이 필요합니다.
Q9. 보안 사고를 겪어 본 적 있나요?
운영 서버의 모든 서비스가 동시에 502를 낸 적이 있습니다. 로그에 Windows 소켓 자원 부족 에러가 반복돼서 처음엔 임시 포트 고갈을 의심했는데, 실제로 세어 보니 TIME_WAIT가 1만 6천여 개 중 17개뿐이라 기각했습니다. 대신 CLOSE_WAIT가 비정상적으로 많아 소켓을 잡고 있는 프로세스를 추적했더니, 노출돼 있던 구버전 Tomcat 경로로 침입한 공격자가 채굴기와 스캐너를 3주 가까이 돌리고 있었습니다. 악성 파일을 무력화하고, 공격자 계정은 증거 보존을 위해 삭제 대신 비활성화했고, 재감염용 예약 작업을 지우고, 쓰지 않던 포트를 차단했습니다. 보안 로그가 작아서 침입 시점 기록이 밀려 사라진 것도 확인해 로그 보관량을 늘렸습니다. 에러 코드만 보고 단정하지 않고 숫자로 검증한 게 원인을 찾은 핵심이었습니다.
Q10. 큰 파일을 올리면 어디서 막히나요?
nginx는 1000MB까지 받도록 열려 있고, Node 쪽 BODY_SIZE_LIMIT가 100MB라서 실제로는 Node에서 413으로 막힙니다. 원래는 바깥쪽인 nginx에서 먼저 막는 게 낫습니다. 큰 요청이 Node까지 들어와 메모리와 연결을 쓰기 전에 거를 수 있기 때문입니다. 한 서버에 여러 서비스가 있어 nginx 전역 값을 크게 둔 것 같은데, 서비스별 server 블록에서 따로 줄이는 게 개선 방향입니다.
Q11. CPU를 많이 쓰는 작업(PDF·엑셀 생성)이 몰리면요?
Node는 JS 실행 스레드가 하나라 그 작업을 하는 동안 다른 요청이 모두 기다립니다. 응답이 늦어지면 504가 날 수 있습니다. worker_threads로 다른 스레드에 넘기거나, 작업 큐에 넣고 별도 프로세스가 처리하게 하고 사용자는 완료 알림을 받는 구조로 바꿉니다.
다음 교시 전에 체크
- ① 큰 그림을 백지에 그릴 수 있다
- 암기 카드를 답을 보지 않고 다 맞힌다
- Q1, Q3, Q6, Q9를 막히지 않고 1분 안에 말한다