스프쌤
아키텍처

Three.js와 Cloudflare Workers 기반 웹 배포 아키텍처 분석

✍ 야금야금⏱ 15분 소요2026-10-19👁
← 목록으로 돌아가기

호스팅 서버 비용 0원으로 인터랙티브 3D 웹 서비스를 세상에 공개하는 것은 어디까지 가능할까요?

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: Three.js와 서버리스 엣지를 활용한 실전 배포 및 상태·데이터 설계

✦ KR 핵심 요약: 초기 서비스는 Vercel과 Cloudflare Workers를 조합해 인프라 비용을 최소화할 수 있습니다. 그러나 프로덕션 단계로 진입할수록 인증 토큰 만료 처리, NoSQL 비정규화에 따른 쓰기 비용, 스토리지 파일 수명주기 관리가 중요한 기술적 분기점이 됩니다.

🌐 Global Takeaway: Building interactive web apps with Three.js, Vercel, and Cloudflare Workers minimizes initial infrastructure overhead to domain costs. However, production sustainability requires strategic decisions around selective state subscription, token persistence, and denormalized NoSQL write tradeoffs.

아래 그림은 프론트엔드 인터랙션부터 엣지 연산, 정적 배포까지 이어지는 경량 웹 서비스 인프라 계층을 보여줍니다.

경량 3D 인터랙티브 웹 인프라 계층
클라이언트 계층Three.js 기반 반응형 인터랙션 렌더링
호스팅·배포 계층GitHub 연동 Vercel 자동 빌드 및 엣지 캐싱
데이터 중계 계층Cloudflare Workers 엣지 컴퓨팅을 통한 사용자 간 통신
도메인·DNS 계층Cloudflare Registrar 도메인 및 네임서버 라우팅
정적 호스팅과 서버리스 엣지 환경을 결합해 도메인 비용만으로 구축한 서비스 구조
전역 상태 관리 도구 비교
Context API
  • 기본 내장 기능으로 의존성 없음
  • 객체 일부 변경 시 구독 컴포넌트 전면 리렌더링
  • 상태 분리 시 Provider 계층 중첩 심화
VS
Zustand
  • 선택적 구독으로 필요한 필드 변경 시만 렌더링
  • 보일러플레이트가 적고 가벼운 번들 크기
  • 미들웨어 확장이 용이하나 규모별 기준 필요
단순 Context 사용과 Zustand 도입 시 리렌더링 및 복잡도 차이

1. 1인 개발 사이트 배포 스택의 현실적 조합

초기 웹 프로젝트를 구상할 때 개발자가 직면하는 가장 큰 진입 장벽 중 하나는 인프라 유지 비용입니다. 고정형 가상 사설 서버(VPS)나 상시 구동되는 백엔드 컨테이너는 트래픽이 발생하지 않는 유휴 시간에도 지속적인 비용을 발생시킵니다. 최근 웹 생태계에서는 브라우저 렌더링 파워를 극대화하고, 정적 자산 호스팅과 분산 엣지 컴퓨팅을 결합하여 고정 서버 비용을 0원에 가깝게 수렴시키는 아키텍처가 널리 사용되고 있습니다.

실제로 2026년 11월 개발 커뮤니티에 공개된 한 반려동물 커뮤니티('멍냥' 사이트)의 개발 기록에 따르면, 웹 프론트엔드는 Three.js를 사용해 3D 인터랙션을 구현하고, 호스팅은 Vercel을 채택해 GitHub 푸시 기반의 자동 배포 파이프라인을 구축했습니다. 사용자 간 실시간 데이터 중계에는 Cloudflare Workers를 연결하고, 도메인은 Cloudflare Registrar를 통해 구매하여 '도메인 등록 비용' 외에 추가적인 고정 인프라 지출 없이 서비스를 배포한 사례가 공유되었습니다.

이러한 구조는 초기 진입 비용을 극단적으로 낮출 수 있지만, 트래픽이 증가하는 시점부터는 각 플랫폼의 무료 티어 한도를 초과하여 유료 플랜으로 전환해야 하는 임계점이 존재합니다. 프로덕션 서비스로 안착시키기 위해서는 정적 에셋의 압축률, 엣지 런타임의 호출 횟수, 그리고 사용자 브라우저의 렌더링 부하를 체계적으로 계산해야 합니다.

1-1. Three.js 프론트와 Vercel·Cloudflare 연동 구성

Three.js는 WebGL/WebGPU 기반으로 브라우저 캔버스 내에 복잡한 3D 그래픽을 렌더링할 수 있도록 돕는 자바스크립트 라이브러리입니다. 모델 파일(.gltf, .glb)과 텍스처 이미지의 용량이 크기 때문에, CDN(콘텐츠 전송 네트워크)의 전송 효율과 브라우저 캐싱 전략이 서비스 체감 속도를 좌우합니다.

Vercel은 정적 빌드 결과물을 전 세계 엣지 네트워크로 자동 배포하며, GitHub 레포지토리와 연동되어 main 브랜치에 변경 사항이 머지될 때마다 빌드와 배포를 즉각 처리합니다. 여기에 전송 지연 시간이 중요한 사용자 간 데이터 중계 계층을 Cloudflare Workers로 분리하면, 중앙 집중형 백엔드 서버 없이도 전 세계 노드에서 밀리초 단위로 응답하는 서버리스 환경을 구성할 수 있습니다.

구성 요소 선택 기술 주요 역할 및 특징
프론트엔드 그래픽 Three.js 브라우저 내 3D 장면 및 반응형 그래픽 렌더링
정적 호스팅 Vercel GitHub 연계 자동 배포 및 글로벌 CDN 캐싱
데이터 중계 Cloudflare Workers 엣지 기반 서버리스 연산 및 사용자 간 데이터 전송
도메인 및 DNS Cloudflare 수수료 없는 도메인 등록 및 Anycast DNS 라우팅

2. 멍냥 프로젝트로 본 프론트엔드 설계와 상태 관리

실제 개발 현장에서는 UI 라이브러리를 선정하는 것 이상으로 프로젝트 초기 1~2주 차의 기본 골격을 잡는 작업에 많은 시간이 소요됩니다. 오픈소스 커뮤니티의 '멍냥생활' 프로젝트 회고에 따르면, 개발 1주 차에는 와이어프레임과 유저 플로우를 확정하는 데 약 2.5일이 걸렸으며, GitHub 이슈 템플릿, PR 룰, 라우팅 구조를 설계하는 데 약 3일이 투입되었습니다.

# React 및 전역 상태 관리 라이브러리 설치 예시
npm install zustand

초기 설계 단계에서 핵심적인 쟁점은 페이지 라우팅과 함께 컴포넌트 지연 로딩(Lazy Loading)을 어디까지 적용할 것인가, 그리고 전역 상태를 어떻게 분리할 것인가였습니다. Three.js 씬(Scene)을 포함하는 무거운 컴포넌트가 초기 번들에 포함되면 First Contentful Paint(FCP) 지표가 급격히 악화되므로, 라우트 단위의 코드 스플리팅이 필수적으로 수반됩니다.

2-1. Context API vs Zustand: 상태 동기화와 리렌더링

React 생태계에서 전역 상태를 다룰 때 가장 흔한 고민은 내장 Context API와 외부 상태 관리 라이브러리(Zustand 등) 간의 선택입니다. Context API는 별도의 외부 패키지 없이 구현할 수 있지만, 상태를 단일 객체로 관리할 경우 객체의 일부 필드만 변경되어도 해당 Context를 구독하는 모든 하위 컴포넌트가 불필요하게 리렌더링되는 성능 한계가 있습니다.

"Context가 객체라면 객체의 일부 프로퍼티만 변경되어도 해당 context를 사용하는 모든 consumer가 리렌더링된다. Zustand 역시 기본적으로는 상태 객체의 일부 변경 시 구독 컴포넌트가 반응하지만, 선택적 구독(Selector)을 통해 필요한 상태 조각만 지정할 수 있다."

프로젝트 규모가 초기 단계이고 컴포넌트 트리가 깊지 않다면 과도한 최적화는 불필요할 수 있습니다. 멍냥생활 개발 회고에서도 소규모 단계에서는 선택적 구독의 성능 이점이 극적이지 않을 수 있다는 조언을 바탕으로, 코드의 일관성과 팀 내 선호도를 종합하여 Zustand를 최종 채택한 기술적 의사결정 과정이 기록되어 있습니다.

3. 인증 시스템과 영속화(Persist) 트러블슈팅

서비스의 인증 체계를 구축할 때 백엔드리스(Backendless) 대안으로 Firebase Auth가 널리 쓰입니다. 이메일 회원가입과 Google 소셜 로그인을 빠르게 연동할 수 있지만, 클라이언트 상태와 인증 토큰의 생명주기를 동기화하는 과정에서 구조적인 문제가 자주 발생합니다.

일반적인 실수는 로그인 성공 시 반환되는 유저 객체를 Zustand 스토어에 넣고, 브라우저 새로고침 시 상태가 초기화되는 것을 막기 위해 zustand/middleware의 persist를 적용하여 localStorage에 무조건 저장하는 방식입니다. 그러나 Firebase Auth의 ID 토큰은 기본적으로 약 1시간의 유효 기간을 가집니다.

  • 로컬스토리지에 저장된 유저 정보는 브라우저를 닫거나 새로고침해도 그대로 유지됩니다.
  • 하지만 백그라운드에서 Firebase 인증 토큰이 만료되거나 토큰 갱신(Refresh)에 실패하면 실제 서버와의 통신은 불가능해집니다.
  • 결과적으로 UI 상에서는 로그인 상태로 표시되지만, 실제 API 요청은 권한 없음(401 Unauthorized)으로 실패하는 '유령 세션' 현상이 발생합니다.

따라서 스토리지에 인증 상태를 맹목적으로 캐싱하기보다는, Firebase SDK가 자체적으로 관리하는 인증 상태 변경 리스너(onAuthStateChanged)를 최상위 엔트리포인트에 바인딩하여 토큰 갱신 시점에 맞춰 Zustand 스토어를 업데이트하는 패턴이 안정적입니다.

4. 데이터베이스 아키텍처와 비정규화 트레이드오프

프로젝트 2주 차로 넘어가면서 사용자 프로필 수정, 팔로잉·팔로워 관계, 포스트 CRUD(생성·조회·수정·삭제)와 같은 핵심 소셜 기능이 구현됩니다. 관계형 데이터베이스(RDBMS)에서는 조인(JOIN)을 통해 외래 키를 엮어내지만, Cloudflare D1이나 Firebase Firestore 같은 문서형/엣지 데이터베이스에서는 쿼리당 읽기·쓰기 비용을 고려한 역정규화(Denormalization) 전략이 필수적입니다.

NoSQL 카운트 및 관계 데이터 설계 매트릭스
읽기 쿼리 성능
비정규화 필드 저장
  • likeCount 문서 내 직접 기록
  • 단일 읽기 비용 최소화
완전 집계 쿼리
  • 매 요청마다 조인·카운트 계산
  • 데이터 정합성 보장되나 비용 증가
양방향 관계 복제
  • 팔로잉·팔로워 목록 양측 저장
  • 양방향 즉시 조회 유리
단방향 참조 연결
  • 단일 컬렉션 참조 키만 보관
  • 조회 시 다중 쿼리 발생
데이터 일관성
단순 조회 최적화와 쓰기 트랜잭션 비용 간의 포지셔닝

4-1. 소셜 상호작용과 양방향 관계 저장 비용

소셜 기능에서 팔로잉과 팔로워 목록을 구현할 때 단일 문서에 배열로 ID를 누적하면 문서 크기 제한(예: 1MB)에 빠르게 도달합니다. 이를 해결하기 위해 사용자의 서브컬렉션이나 별도 관계 컬렉션을 구축할 때, '단방향 참조'와 '양방향 복제' 사이의 선택이 발생합니다.

  1. 양방향 저장 전략: 사용자가 다른 사용자를 팔로우할 때 A의 following 목록과 B의 follower 목록 양측 데이터베이스에 레코드를 동시에 기록합니다. 쓰기 연산은 2회 발생하지만, 양쪽 사용자의 프로필 페이지에서 추가 조인 쿼리 없이 목록을 즉시 렌더링할 수 있습니다.
  2. 카운트 필드 비정규화: 포스트 목록을 조회할 때마다 연관된 좋아요 테이블과 댓글 테이블의 전체 행을 카운트(COUNT(*))하는 것은 읽기 비용을 크게 증가시킵니다. 따라서 포스트 문서 내에 likeCount와 commentCount 필드를 별도로 두고, 좋아요가 추가되거나 취소될 때마다 해당 필드를 증감시키는 방식이 조회 효율성 측면에서 우수합니다.

비정규화는 읽기 속도를 비약적으로 개선하지만, 동시 다발적인 쓰기 요청이 몰릴 때 정합성이 깨질 수 있으므로 원자적 증가(Atomic Increment) 연산이나 배치 트랜잭션을 적용해야 합니다.

5. 이미지 파이프라인과 스토리지 참조 동기화 오류

게시글 작성 및 수정 과정에서 가장 까다로운 트러블슈팅 지점은 바이너리 파일과 텍스트 데이터의 수명주기 불일치입니다. 클라이언트에서 이미지를 등록할 때 URL.createObjectURL()을 사용하여 즉각적인 미리보기를 구현하는 방식은 널리 사용됩니다.

이미지 처리 파이프라인 흐름
파일 선택임시 URL 생성
→
스토리지 저장고유 경로 업로드
→
URL 반환다운로드 링크 추출
→
문서 동기화폼 데이터와 함께 DB 반영
포스트 수정 시 미리보기 URL과 원본 스토리지 파일 동기화 순서

그러나 기존 게시글을 수정할 때 심각한 예외가 발생할 수 있습니다. 게시글 수정 폼은 신규 작성 폼과 동일한 컴포넌트를 재사용하는 경우가 많습니다. 이때 서버에서 불러온 기존 이미지는 원격 스토리지 URL 문자열 배열(string[]) 형태이지만, 사용자가 새로 추가하려는 이미지는 브라우저 메모리에 존재하는 File 객체입니다.

폼 제출(submit) 시점에 파일 객체와 문자열 URL을 분기하지 않고 단일 방식으로 전송하면, 기존 이미지의 참조가 손실되거나 스토리지에 빈 데이터가 전송되는 현상이 발생합니다. 이를 방지하기 위해서는 폼을 최종 제출하기 전에 신규 File 객체를 먼저 스토리지에 업로드하여 원격 URL로 변환한 뒤, 최종 수정 페이로드에는 모든 이미지를 통일된 URL 배열 규격으로 묶어 서버로 전송해야 합니다.

또한 수정 과정에서 제외된 기존 이미지는 스토리지에서 즉시 삭제되어야 유휴 파일이 누적되지 않습니다. 포스트 생성 시점에는 아직 postId를 알 수 없기 때문에 파일 저장 경로를 userId/createdTime/fileName 형태로 설계하고, 문서 삭제 시 해당 경로의 스토리지 오브젝트를 일괄 정리하는 로직이 뒷받침되어야 합니다.

6. 개발일지와 협업 인프라가 남기는 기술적 자산

작은 규모의 프로젝트나 1인 개발일수록 체계적인 기록의 유무가 개발 지속성을 결정합니다. 여러 오픈소스 개발일지 사례에서 확인되듯, 개발이 진행될수록 프론트엔드와 백엔드의 커뮤니케이션 문서, API 스펙, 미해결 이슈가 뒤섞여 프로젝트 통제력을 잃는 상황이 발생합니다.

GitHub Projects를 활용하여 백로그, 진행 중(In Progress), 완료(Done)의 칸반 보드를 구성하고, 명확한 이슈 라벨 컨벤션을 도입하는 것은 단순한 형식주의가 아닙니다. 기능 브랜치가 머지되고 배포 환경에서 실제 동작이 확인된 시점에만 카드를 Done으로 옮기는 규칙을 세움으로써 기능 누락과 회귀 버그를 방지할 수 있습니다.

동시에 개발 과정에서 겪은 기술적 의사결정의 이유—예를 들어 왜 React Query의 낙관적 업데이트(Optimistic Update)를 도입하려 했는지, 무한 스크롤 구현 시 교차 관찰자 API(Intersection Observer)와 스크롤 이벤트 중 무엇을 선택했는지—를 기록해 두면, 향후 코드베이스를 리팩토링하거나 규모를 확장할 때 강력한 설계 근거가 됩니다.

7. 최소 비용 아키텍처 구축 시 점검해야 할 한계와 체크리스트

Three.js, Vercel, Cloudflare Workers의 조합은 초기 고정 비용을 도메인 구입비 수준으로 억제할 수 있는 매력적인 스택입니다. 그러나 프로젝트가 성공적으로 트래픽을 유치하기 시작하면 다음과 같은 기술적 한계에 부딪히게 되며, 사전에 대비책을 마련해야 합니다.

  • 클라이언트 렌더링 부하: Three.js는 사용자의 기기 GPU 자원을 소모합니다. 저사양 모바일 기기 사용자를 위해 렌더링 해상도를 동적으로 조절하거나 3D 씬의 폴리곤 수를 낮추는 LOD(Level of Detail) 기법이 필요합니다.
  • 엣지 런타임의 제약: Cloudflare Workers 무료 플랜은 일일 요청 수 및 CPU 실행 시간(예: 10ms 단위)에 제한이 있습니다. 연산량이 많은 복잡한 비즈니스 로직은 엣지 함수 내에서 타임아웃을 유발할 수 있습니다.
  • 스토리지 아웃바운드 비용: 고해상도 이미지가 누적될 경우 스토리지 용량 초과 및 데이터 전송 비용이 급격히 증가합니다. WebP/AVIF 포맷으로의 사전 압축 파이프라인 구축이 필수적입니다.

결국 인프라의 '무료 티어'를 활용하는 것은 비용을 완전히 없애는 것이 아니라, 서버 유지 비용을 클라이언트 최적화와 아키텍처 설계 비용으로 치환하는 과정입니다. 초기 개발 단계부터 도메인 비용만으로 서비스를 안정적으로 런칭하되, 사용자 증가에 대비한 유료 티어 전환 기준과 데이터베이스 스케일링 전략을 명확히 수립하는 것이 성공적인 서비스 운영의 핵심입니다.

자주 묻는 질문

Q. Three.js와 Vercel 조합으로 서비스할 때 가장 주의할 점은 무엇인가요?
A. Three.js 라이브러리와 3D 모델(.gltf 등)의 용량이 크기 때문에 초기 로딩 지연이 발생할 수 있습니다. 3D 컴포넌트에 코드 스플리팅(지연 로딩)을 적용하고, 모델 압축 및 브라우저 캐싱 헤더를 적절히 설정해야 합니다.

Q. Firebase Auth와 Zustand를 함께 쓸 때 새로고침 로그아웃 문제는 어떻게 해결하나요?
A. 단순히 localStorage에 로그인 상태를 보관하면 토큰 만료 시 동기화가 깨질 수 있습니다. 최상위 컴포넌트에서 Firebase의 onAuthStateChanged 리스너를 등록해 인증 토큰 상태가 확인된 후 Zustand 스토어를 업데이트하는 방식이 권장됩니다.

Q. 소셜 기능에서 좋아요와 댓글 수를 포스트 문서에 직접 필드로 저장하는 이유는 무엇인가요?
A. 포스트를 조회할 때마다 매번 좋아요 컬렉션의 행 수를 카운트하면 읽기 연산 비용이 과도하게 발생하기 때문입니다. 카운트 필드를 비정규화하여 보관하면 단일 문서 읽기로 즉시 표시할 수 있으며, 데이터 변경 시에만 카운트를 증감시키는 방식으로 최적화합니다.

원본

https://www.threads.com/@brandon.hongs/post/DfUbd5Kowam

https://yuuxi.tistory.com/263

https://yuuxi.tistory.com/267

함께 보면 좋은 글

댓글 0개