[Froppy 개발기 6편] Supabase + Cloudflare로 인프라 구성하기
5일 전
▣Froppy7개 기록▲ 목록 접기
Supabase + Cloudflare로 인프라 구성하기
인프라는 유명한 서비스를 많이 붙이는 일이 아니라,
각 데이터와 파일을 어디에 둘지 정하는 일이었다.
Froppy는 Flutter Web과 NestJS 백엔드로 구성된 서비스였다. 웹 앱을 배포하고, API를 운영하고, 이미지와 영상 파일을 저장하고, 채팅 미디어도 전달해야 했다.
처음에는 “Supabase를 쓰면 데이터베이스와 파일 저장을 한 번에 해결할 수 있겠지”라고 생각했다. 실제로 프로젝트가 커지면서 저장소 역할은 한 곳에 모이지 않았다.
- Flutter Web 정적 파일은 Cloudflare Pages
- NestJS API는 Railway
- 관계형 데이터는 PostgreSQL과 TypeORM
- 이미지와 영상은 Cloudflare Images와 Stream
- 채팅 미디어는 Cloudflare R2
- Supabase는 SDK와 기존 Storage 경로, 인프라 관리 용도로 일부 사용
이 글에서는 서비스 이름을 나열하기보다, Froppy에서 각각 어떤 역할을 맡았는지 정리해본다.
전체 구성
flowchart TD
Repo[GitHub 저장소]
Web[Flutter Web]
API[NestJS API]
DB[(PostgreSQL)]
CFPages[Cloudflare Pages]
Railway[Railway]
Images[Cloudflare Images]
Stream[Cloudflare Stream]
R2[Cloudflare R2]
Supabase[Supabase]
Repo --> CFPages
Repo --> Railway
Web --> CFPages
Web --> API
API --> Railway
API --> DB
API --> Images
API --> Stream
API --> R2
API -. 레거시 파일 정리 및 관리 .-> Supabase
Cloudflare Pages는 Flutter Web 결과물을 제공하고, Railway는 NestJS API를 실행한다. 두 서비스는 역할이 다르므로 Pages가 백엔드 서버까지 실행한다고 생각하면 안 된다.
브라우저에서 API 요청을 보내려면 CORS, API 기본 URL, 환경별 주소도 각각 맞아야 했다.
GitHub에서 배포까지
GitHub는 소스 코드의 기준점이었다. Cloudflare Pages와 Railway를 저장소에 연결해 코드 변경을 각 배포 환경으로 전달하는 형태로 운영했다.
개념적으로 흐름은 다음과 같다.
코드 변경
→ GitHub에 push
→ Cloudflare Pages에서 Flutter Web 빌드 및 배포
→ Railway에서 NestJS 백엔드 빌드 및 배포
프론트엔드와 백엔드가 같은 저장소에 있더라도 빌드 설정과 환경변수는 서비스별로 구분해야 한다.
- Flutter Web은 프론트엔드 API 주소를 알아야 한다.
- NestJS는 DB 연결 정보와 외부 서비스 자격 증명이 필요하다.
- 웹에서 OAuth나 결제를 사용한다면 각 서비스의 redirect URL과 도메인 설정도 맞아야 한다.
배포 자동화가 편리해질수록, 어떤 브랜치가 어떤 환경으로 배포되는지 명확하게 관리하는 것이 중요했다. 개발용 설정이 운영 환경에 섞이지 않도록 환경변수를 서비스별로 관리해야 한다.
Cloudflare Pages: Flutter Web 배포
Flutter Web은 빌드하면 정적 파일 묶음이 생성된다. Cloudflare Pages는 이 결과물을 웹에서 제공하는 역할을 맡았다.
Flutter 소스 코드
→ Flutter Web 빌드
→ 정적 산출물
→ Cloudflare Pages 배포
Froppy는 해시가 없는 경로를 사용하도록 설정했다. 이런 경로 전략을 쓰면 /main 같은 주소를 새로고침하거나 직접 열 때 Pages가 Flutter 앱의 진입 파일로 요청을 연결해야 한다.
따라서 단순히 파일을 배포하는 것으로 끝나지 않고 다음을 함께 점검해야 했다.
- Pages 빌드 명령과 산출물 디렉터리
- 경로 직접 접근 시
index.htmlfallback - Flutter 앱의 API 기본 URL
- NestJS CORS 허용 도메인
- 운영 도메인과 OAuth callback 주소
정적 웹 호스팅과 API 호스팅을 분리하면 각 서비스의 배포 책임이 뚜렷해진다. 대신 주소와 CORS처럼 두 환경 사이의 연결 설정은 직접 관리해야 한다.
Railway: NestJS API 실행
NestJS 서버는 Railway에서 실행하는 형태로 구성했다. 백엔드는 다음 역할을 담당한다.
- 인증과 사용자 정보 관리
- 게시글, 팔로우, 후원 데이터 처리
- 파일 업로드 권한 확인과 업로드 URL 발급
- Cloudflare API 호출
- 결제 및 웹훅 처리
API 서버가 이미지나 영상을 매번 직접 받아 외부 저장소로 전달하면 서버 메모리와 네트워크 부하가 커진다. Froppy에서는 일부 업로드에 Cloudflare의 direct upload 방식을 사용했다.
클라이언트 → NestJS에 업로드 URL 요청
NestJS → Cloudflare 업로드 URL 발급
클라이언트 → Cloudflare로 파일 업로드
클라이언트 → NestJS에 업로드 완료 알림
NestJS → 파일 메타데이터를 DB에 저장
백엔드는 권한 확인과 파일 메타데이터 관리를 맡고, 파일 바이트는 가능한 한 저장소로 직접 보내는 방식이다.
PostgreSQL과 Supabase의 실제 역할
Froppy의 관계형 데이터 접근은 NestJS의 TypeORM과 PostgreSQL이 중심이었다. 개발 환경은 로컬 PostgreSQL을 사용하도록 구성돼 있었다.
Supabase SDK도 백엔드에서 초기화하고 전역 provider로 주입할 수 있게 해뒀다. 다만 현재 코드에서 확인되는 주된 미디어 업로드는 Cloudflare Images, Cloudflare Stream, R2 쪽이다. Supabase Storage는 일부 기존 파일을 삭제하는 경로에 남아 있었다.
그래서 지금의 구조를 “Supabase가 Froppy의 모든 DB와 파일을 담당했다”고 요약하면 정확하지 않다.
더 정확하게 말하면:
- 관계형 DB 접근은 TypeORM/PostgreSQL이 중심이었다.
- 개발 환경에서는 로컬 PostgreSQL을 사용했다.
- Supabase client는 설정돼 있고, 기존
uploads파일 삭제 경로 등에 사용됐다. - 주요 신규 이미지·영상 업로드는 Cloudflare를 사용했다.
- 채팅 미디어는 Cloudflare R2를 사용했다.
Supabase를 Auth나 Realtime의 중심 서비스로 사용했다고 말하기도 어렵다. 블로그에 인프라 구성을 쓸 때는 제품에서 실제로 사용한 기능과 단순히 SDK를 설치하거나 설정한 기능을 나눠 적는 편이 좋다.
Cloudflare Images: 이미지 저장과 전달
Froppy에서는 이미지 업로드를 위해 백엔드가 Cloudflare Images의 direct upload URL을 발급하도록 구성했다.
- Flutter가 백엔드에 이미지 업로드 URL을 요청한다.
- 백엔드는 로그인 사용자와 파일 정보를 확인하고 Cloudflare 업로드 URL을 발급한다.
- 클라이언트가 이미지를 Cloudflare에 업로드한다.
- 업로드가 완료되면 클라이언트가 이미지 ID와 파일 메타데이터를 백엔드에 전달한다.
- 백엔드는 이미지 정보를 파일 테이블에 저장한다.
이미지를 먼저 Cloudflare에 올린 뒤 DB 메타데이터 저장이 실패하면, 업로드된 이미지를 삭제하도록 롤백을 시도하는 코드도 있었다.
Signed URL
일부 이미지 업로드에는 requireSignedURLs를 설정했고, 백엔드에는 만료 시간이 있는 이미지 URL을 서명해 생성하는 로직이 있다.
서명 URL은 이미지에 대한 접근을 제한하는 데 쓸 수 있지만, 모든 이미지 업로드 경로가 같은 정책인 것은 아니다. 서버에서 직접 업로드하는 프로필 이미지 경로에는 서명 필요 설정이 다르게 적용된 코드도 있었다.
따라서 “모든 이미지가 비공개로 보호된다”고 단정하기보다, 업로드 경로별 공개/서명 정책을 확인해야 한다는 점을 배웠다.
Cloudflare Stream: 영상 업로드와 처리
영상은 이미지와 저장·전달 방식이 다르다. Cloudflare Stream은 영상 업로드와 스트리밍 처리를 맡았다.
업로드 흐름은 이미지와 비슷하게 백엔드가 권한을 확인하고 업로드 URL을 발급한다. 큰 영상은 이어 올리기를 지원하는 TUS 업로드 경로도 사용하도록 구성돼 있었다.
Flutter
→ NestJS에 영상 업로드 URL 요청
→ Cloudflare Stream으로 업로드
→ NestJS에 업로드 완료 알림
→ 백엔드가 영상 상태와 메타데이터 조회
→ 파일 정보 DB 저장
영상은 업로드 직후 바로 재생 가능한 상태가 아닐 수 있다. 그래서 업로드 완료 처리에서 Cloudflare에 영상 정보를 다시 조회하고, 처리 시간을 고려해 재시도하도록 구현했다.
또한 업로드 시 requireSignedURLs를 사용해 서명 없는 공개 재생을 막는 방향을 적용했다. 실제 재생 권한과 URL 발급 정책은 서비스 요구에 맞춰 별도로 점검해야 한다.
Cloudflare R2: 채팅 미디어
채팅 이미지와 영상은 Cloudflare R2에 저장했다. R2는 S3 호환 API를 제공하므로, AWS SDK의 S3 client를 사용해 업로드와 삭제를 처리할 수 있었다.
const s3Client = new S3Client({
region: 'auto',
endpoint: `https://${accountId}.r2.cloudflarestorage.com`,
credentials: {
accessKeyId,
secretAccessKey,
},
});
채팅 미디어는 방 ID, 날짜, UUID를 조합해 객체 경로를 만들었다. 업로드 시 암호화된 바이너리 데이터를 저장하도록 작성돼 있고, 다운로드 시에는 일정 시간 유효한 presigned URL을 생성하는 코드가 있다.
채팅 파일
→ R2에 객체 저장
→ 파일 URL/경로를 채팅 데이터와 연결
→ 권한 확인 후 presigned URL 생성
→ 클라이언트에서 제한 시간 동안 다운로드
여기서 presigned URL은 소유권이나 채팅 참여 권한을 대신 확인해주지 않는다. URL을 발급하기 전에 백엔드가 접근 권한을 확인해야 한다. URL이 유효한 동안 전달받은 사람도 접근할 수 있으므로 만료 시간과 로그 노출을 관리해야 한다.
왜 저장소를 나눴을까
서비스별로 저장소를 나누면 각 기능에 맞는 도구를 쓸 수 있다.
- 이미지: 변환과 전달에 특화된 Images
- 영상: 인코딩과 스트리밍에 특화된 Stream
- 채팅 첨부 파일: 객체 저장소인 R2
- 관계형 데이터: PostgreSQL
반면 저장소가 여러 개면 관리해야 하는 항목도 늘어난다.
- 인증 키와 권한 범위
- 업로드 실패 시 임시 파일 정리
- DB 메타데이터와 실제 객체의 정합성
- 삭제 요청이 각 저장소에 반영되는지
- 개발/운영 환경별 endpoint와 도메인
- 비용과 사용량 모니터링
서비스를 나누는 것이 자동으로 더 좋은 아키텍처를 의미하지는 않는다. 운영 복잡도를 감당할 수 있는지, 각 저장소가 실제 문제를 해결하는지 함께 판단해야 한다.
비용을 볼 때 배운 점
“무료 티어를 썼다”는 말만으로 운영비를 예측할 수는 없다. 저장 용량뿐 아니라 업로드·다운로드 트래픽, 영상 처리, 요청 수, 로그 보관, 운영 서비스의 최소 사용량을 함께 봐야 한다.
Froppy는 Cloudflare, Supabase, Railway의 사용량을 확인하고 저장하는 관리 기능도 추가했다. 매일 사용량을 스냅샷으로 기록하고, 관리자 화면에서 월별 비용 정보를 살펴보는 구조였다.
이 기능을 만들며 알게 된 것은 사용량 확인을 서비스 종료 직전에 하면 늦다는 점이다. 작은 서비스라도 다음을 주기적으로 볼 필요가 있다.
- 저장된 파일 크기와 개수
- 영상 업로드와 재생량
- DB 용량과 연결 수
- 백엔드 실행 시간과 트래픽
- 사용하지 않는 객체와 오래된 테스트 데이터
서비스 가격과 무료 제공 범위는 바뀔 수 있으므로, 글을 게시할 때 특정 무료 한도나 가격을 고정된 사실처럼 적지 않는 것이 좋다.
돌아보며
잘 맞았던 선택
- 정적 Flutter Web과 NestJS API를 별도 서비스로 배포해 책임을 나눴다.
- 영상과 이미지를 전용 서비스에 맡겨 백엔드가 미디어 전달을 전부 처리하지 않게 했다.
- R2의 S3 호환 API를 이용해 익숙한 AWS SDK로 객체를 다룰 수 있었다.
- 업로드 완료 후 파일 메타데이터를 DB에 저장해 앱 기능과 연결했다.
아쉬웠던 점
- Supabase client처럼 설정은 돼 있지만 실제 역할이 제한적인 의존성이 남았다.
- 로컬 업로드, Supabase Storage, Cloudflare Images/Stream, R2를 거치는 경로가 공존해 파일 삭제와 이관 정책이 복잡해졌다.
- 저장소마다 파일 URL과 접근 제어 방식이 달라 일관된 파일 추상화가 필요했다.
- direct upload URL을 발급한 뒤 업로드가 취소되거나 완료 통지가 오지 않는 경우의 정리 정책을 더 일찍 설계했어야 했다.
- 비용을 줄이려면 서비스 가격뿐 아니라 트래픽과 미사용 리소스를 함께 추적해야 했다.
마치며
Froppy 인프라를 만들며 배운 것은 “어떤 클라우드가 제일 좋은가”가 아니었다.
이미지는 이미지에 맞는 방식으로, 영상은 영상 스트리밍에 맞는 방식으로, 채팅 파일은 객체 저장소에 두고, 관계형 데이터는 PostgreSQL에서 관리했다. 각 서비스를 연결하는 백엔드는 권한과 메타데이터, 상태를 책임졌다.
다만 서비스가 늘수록 설정과 운영 책임도 함께 늘어났다. Supabase를 사용한다고 썼다면 실제 어떤 기능을 사용했는지, Cloudflare를 썼다면 Images·Stream·R2 중 무엇을 맡겼는지 구체적으로 기록해야 했다.
인프라 선택은 서비스 이름의 목록이 아니라, 데이터가 어디서 만들어지고 어떤 경로로 저장되고 삭제되는지 설명할 수 있을 때 비로소 설계가 된다고 느꼈다.
이 시리즈는 총 8편으로 구성됩니다.
- [1편] 기획 & 아키텍처 — Flutter + NestJS + Cloudflare를 선택한 이유
- [2편] Flutter로 Web과 Mobile 동시 개발하기
- [3편] NestJS로 스타트업 백엔드 설계하기
- [4편] 소셜 로그인 3종 세트 — Google / Kakao / Naver OAuth 연동 실전
- [5편] 결제 시스템 구축 — PortOne 연동과 PG 심사에서 배운 것
- [6편] Supabase + Cloudflare로 인프라 구성하기 ← 현재 글
- [7편] 실시간 채팅 — WebSocket Gateway + Cloudflare R2
- [8편] 피벗 — Froppy를 접기로 한 결정

