fix(infra): nginx 하드닝 — AI 서버 공개 노출 제거 + 보안 헤더·TLS·rate limit

[i3months]

🔴 가장 큰 것 — AI 서버가 인터넷에 열려 있었습니다

location /ai/ { proxy_pass http://127.0.0.1:38030/; }

외부에서 실제로 접근됩니다:

경로	응답
https://stack-up.shop/ai/health	200 {"status":"ok"}
https://stack-up.shop/ai/docs	200 — FastAPI 대화형 문서
https://stack-up.shop/ai/openapi.json	200 — 전체 스펙
https://stack-up.shop/ai/redoc	200

ai/CLAUDE.md 는 이 서버를 이렇게 설계했다고 적고 있습니다:

❌ 사용자 인증 (내부 통신만) — api/ 는 헬스체크 / 내부 도구

즉 인증을 전제하지 않고 만든 서버가 인터넷에 노출돼 있었습니다. 내부 전용 WS(/internal/voice/stream)도 인터넷에서 닿고, 유일한 방어선이 X-Internal-API-Key 하나뿐이었습니다. 원래 설계는 "네트워크 경계 + 키" 이중이었는데 경계가 없었던 셈입니다.

쓰는 데도 없습니다:

• 프론트 운영 번들에 /ai/ 참조 0건
• RealTime 은 도커 네트워크로 직접 연결 (REALTIME_AI_WS_URL=ws://ai:8000/internal/voice/stream)

순수한 잉여 노출이라 제거했습니다.

나머지 발견

항목	이전	이후
TLS 1.0/1.1	전역 설정이 허용, 서버가 실제로 수락	이 사이트만 TLSv1.2/1.3
보안 헤더	전무	HSTS·nosniff·X-Frame-Options·Referrer-Policy·Permissions-Policy
rate limit	없음	API 20r/s(burst 60), 인증 2r/s(burst 20)
버전 노출	nginx/1.18.0 (Ubuntu)	server_tokens off
설정 자체가 버전 관리 밖	서버에만 존재	infra/nginx/ 로 이관

TLS 1.0/1.1 은 처음에 "미지원"으로 잘못 읽었습니다 — 제 로컬 OpenSSL 3.6 이 아예 제안하지 않아서였습니다. -cipher DEFAULT@SECLEVEL=0 으로 다시 확인하니 서버가 수락했습니다. RFC 8996(2021) 폐기 권고, PCI DSS 금지 대상입니다.

rate limit 은 2026-09-17 에 실제로 게이트웨이 크레딧이 소진돼 운영이 402 로 죽은 전례가 근거입니다. /realtime/ 에는 걸지 않았습니다 — 재연결 폭주가 정상 동작인 경우가 있어 끊으면 오히려 나빠집니다.

⚠️ 전역 설정은 건드리지 않았습니다

이 호스트의 /etc/nginx/nginx.conf 는 다른 사이트 4개와 공유됩니다 (beontteuk.com, udangtang.site, udangtangames.cloud, warurulab.site). 전역을 고치면 남의 프로젝트가 같이 바뀝니다.

그래서 하드닝을 전부 server 블록 안으로 한정했습니다 — ssl_protocols, server_tokens, 보안 헤더는 server 컨텍스트에서 재정의됩니다. limit_req_zone 만 http 컨텍스트가 필요해 conf.d 로 뺐는데, zone 선언은 공유 메모리만 잡고 실제 제한은 limit_req 를 붙인 곳에만 걸리므로 다른 사이트에 영향이 없습니다.

바꾸지 않은 것 (이미 올바름)

• client_max_body_size 25m — 백엔드 VoiceAnswerSubmitService.MAX_BYTES 와 일치. 더 작았으면 백엔드 검증에 닿기도 전에 413 이 났을 겁니다.
• /realtime/ 의 proxy_buffering off + 1h 타임아웃 — SSE·WS 가 이게 없으면 깨집니다.

검증

운영과 같은 nginx 1.18 컨테이너로 실제 파싱시켰습니다:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

⚠️ 적용은 수동입니다 (sudo 필요)

deploy-app.yml 은 /etc/nginx 를 건드리지 않습니다(sudo 필요 + 다른 사이트 공유). 제가 적용하려 했으나 sudo 가 비밀번호를 요구해 실행하지 못했습니다.

ts=$(date +%Y%m%d-%H%M%S)
sudo cp /etc/nginx/sites-available/stack-up.shop /etc/nginx/sites-available/stack-up.shop.bak-$ts
sudo cp ~/stackup/infra/nginx/conf.d-stackup-ratelimit.conf /etc/nginx/conf.d/stackup-ratelimit.conf
sudo cp ~/stackup/infra/nginx/stack-up.shop.conf /etc/nginx/sites-available/stack-up.shop
sudo nginx -t && sudo systemctl reload nginx

nginx -t 가 실패하면 reload 하지 말고 백업으로 되돌립니다. 적용 후 제가 결과를 확인하겠습니다(헤더·TLS·/ai/ 차단·정상 동작).

리뷰어 체크포인트

• rate limit 수치 — API 20r/s(burst 60) 가 넉넉한지. 실부하로 검증하지 못했습니다. 너무 빡빡하면 429 가 납니다.
• HSTS — preload 없이 시작했습니다. preload 는 등록 후 되돌리기가 매우 어렵습니다.
• /ai/ 제거 — 정말 아무도 안 쓰는지 한 번 더 봐주세요. 제가 확인한 건 프론트 번들과 RealTime 설정입니다.

🤖 Generated with Claude Code