Repository navigation
Home
shcommit edited this page Nov 11, 2026
·
4 revisions
온마루(OnMaru) 백엔드 시스템의 아키텍처 의사결정, 인프라 전환 이력, 보안 방어선 및 실전 트러블슈팅을 기록하는 엔지니어링 위키입니다.
graph LR
User["사용자 / 브라우저"]
subgraph Edge["1. Edge Layer"]
CF["Cloudflare WAF<br/>(DDoS 방어, Rate Limit 10초 45회, IP 은닉)"]
end
subgraph Host["2. AWS Lightsail (Linux 1GB RAM)"]
Nginx["Nginx (TLS 종료, 80/443)"]
subgraph AppSlot["초경량 Blue-Green CD"]
Spring["Spring Boot (JVM 8080)"]
end
subgraph DB["Docker 사설 내부 네트워크"]
PG["PostgreSQL 17 + PostGIS 3.5<br/>(TourAPI / Odii 원본 데이터)"]
end
end
User -->|api.onmaru.site| CF
CF -->|포워딩| Nginx
Nginx -->|무중단 upstream| Spring
Spring -->|5432 사설 직결| PG
인프라 및 애플리케이션 레벨에서 서비스 가용성과 사용자 데이터를 지켜내는 방어 체계입니다.
-
Cloudflare WAF & Rate Limiting 도입기: 초당 수십 번의 광클과 DDoS를 에지에서 막아낸 여정
- 배경: 단일 인스턴스 환경에서 악의적 스크립트/광클로 인한 톰캣 스레드 고갈 방어
- 핵심: Vercel 프론트엔드와 이중 SSL 충돌을 피하는 선택적 프록시(Selective Proxying) 및 10초당 45회 차단 룰 구축
실제 온마루가 겪었던 인프라 한계와 이를 극복하기 위한 아키텍처 전환 스토리입니다.
-
Neon Serverless DB에서 AWS Lightsail 자체 PostgreSQL로 갈아탄 이유
- 배경: Serverless DB의 Cold Start 타임아웃, 대규모 TourAPI 적재 병목, PostGIS 공간 연산 레이턴시 편차
- 해결: AWS Lightsail 내부 Docker 사설 네트워크로 이전하여 Zero-Hop 로컬 I/O 및 데이터 주권 확보 (Issue #519)
-
1GB RAM 환경에서 살아남는 초경량 Blue-Green 무중단 배포 구축기
- 배경: 월 $7(1GB RAM) 호스트에서 Nginx + Spring + PostgreSQL이 상주하는 극한의 메모리 제약
- 해결: 상시 2대가 아닌 배포 시 30초만 짧게 겹치는 동적 cgroup 제약과 192MB Swap 안전망 기반 무중단 배포
한옥·동네 탐색, AI 기반 여정 추천, 오디오 가이드 등 핵심 비즈니스 로직의 구현과 최적화 기록입니다.
-
지도 공동 편집: WebSocket부터 C4, 멱등성, 다중 인스턴스 확장까지
- 배경: Liveblocks 중심 상태를 OnMaru 도메인과 PostgreSQL 이벤트 이력으로 내재화
-
핵심: 방별 Actor 직렬 처리,
opId멱등성,seqreplay, Redis 확장 시 지켜야 할 쓰기 소유권
- AI 여정 생성 런타임 라이프사이클과 SSE 실시간 스트리밍 (준비 중)
- ODII 한국관광공사 오디오 도슨트 데이터 동기화 및 캐싱 (준비 중)
- 방문 리뷰 멱등성(Idempotency) 보장과 소유권 은닉화 (준비 중)
💡 Tip: 우측(또는 좌측)의 Sidebar를 통해 원하는 기술 아티클로 즉시 이동하실 수 있습니다.
- Cloudflare WAF & Rate Limiting 도입기
- Opaque Session & Guest Grant 격리 (준비 중)
- CsrfProtectionFilter & Same-Origin Defense (준비 중)
- Neon Serverless에서 AWS Lightsail로 갈아탄 이유
- 1GB RAM에서 살아남는 초경량 Blue-Green 무중단 배포
- Spring Boot ↔ FastAPI 내부 서비스 토큰(HS256) 통신 (준비 중)
- TourAPI & Odii 대규모 배치 동기화 파이프라인 (준비 중)
- 지도 공동 편집: WebSocket, 멱등성, 다중 인스턴스 확장
- 한옥·동네 탐색 및 AI 여정 추천 엔진 (준비 중)
- ODII 한국관광공사 오디오 도슨트 스트리밍 (준비 중)
- 방문 리뷰 멱등성(Idempotency) 및 소유권 은닉 (준비 중)