바이브 코딩 →

클라우드플레어 R2(버킷)Cloudflare R2 Bucket

클라우드플레어 R2(Cloudflare R2)는 사이트 전용 창고 같은 것 — 이미지·전자책 같은 파일을 클라우드에 보관하고 꺼내 쓰는 클라우드플레어의 저장소 서비스이며, 그 안의 칸 하나를 버킷이라고 불러요.

사이트를 가게라고 하면 R2는 가게 뒤편의 창고예요. 상품 사진, 판매용 전자책 파일, 영상 썸네일처럼 덩치 큰 파일을 창고에 넣어 두고 필요할 때만 꺼내 손님에게 보여 주는 식이에요. 창고 안을 용도별로 나눈 칸이 '버킷(Bucket)'이에요. 예를 들어 '상품 이미지' 버킷과 '전자책' 버킷을 따로 만들어 관리할 수 있어요.

강의에서는 내 사이트의 이미지와 파일 저장소로 R2를 써요. 대시보드의 R2 메뉴에서 저장소를 활성화하는데, 무료 범위 안에서 쓰더라도 결제 수단을 먼저 등록해야 켜져요. 버킷을 만든 뒤에는 Object Read and Write 권한의 API 토큰을 발급하고, 그때 나오는 Access Key와 Secret Key를 에이전트에게 넘겨야 에이전트가 버킷에 파일을 올리고 지울 수 있어요. 에이전트가 직접 버킷을 만들고 토큰 권한을 특정 버킷에만 주는 장면도 나오고, 새 서비스의 사진 저장도 'Supabase Storage 대신 R2를 써 줘'라고 말하면 그대로 바꿔 준다고 설명해요.

초보가 헷갈리는 점은 토큰 권한이에요. 모든 버킷에 쓰기 권한을 주는 것보다 필요한 버킷 하나에만 주는 편이 안전해요. Access Key와 Secret Key는 비밀번호와 같으니 코드에 직접 적지 말고 환경 변수로 보관하세요. 또 버킷을 공개로 열면 주소만 알면 누구나 파일을 받을 수 있으니, 유료 전자책처럼 막아야 할 파일은 공개 설정 여부를 꼭 확인해야 해요. 무료 한도와 요금은 바뀔 수 있으니 공식 안내를 확인하세요.

💡 대표 예시

  • 이미지 저장소 — 상품 사진을 R2 버킷에 올리고 사이트에서 불러온다
  • 토큰 발급 — R2 메뉴에서 읽기·쓰기 권한 API 토큰을 만들어 넘긴다
  • 저장소 교체 — 새 서비스 사진 저장을 Supabase 대신 R2로 바꾸게 한다
  • 권한 최소화 — 토큰 권한을 전자책 버킷 하나에만 준다
  • 보안 점검 — 유료 파일 버킷이 공개로 열려 있지 않은지 확인한다

🔗 관련 용어

API 토큰 권한(스코프)

API 토큰 권한(스코프, Scope)은 출입증에 적힌 '들어갈 수 있는 층' 같은 것 — 발급한 토큰이 어떤 서비스에서 무엇을 읽고 바꿀 수 있는지 정해 둔 허용 범위예요.

클라우드플레어

클라우드플레어(Cloudflare)는 건물 앞 경비실 겸 안내 데스크 같은 것 — 도메인·DNS 관리, 악성 트래픽 차단, 파일 저장소(R2), 서버(Workers)를 한곳에서 제공하는 인터넷 인프라 서비스예요.

환경변수

환경변수는 금고 열쇠를 별도 서랍에 보관하는 것 — 비밀번호·API 키 같은 민감 정보를 코드 안에 직접 쓰지 않고 별도 파일에 분리해서 관리하는 방식.

시크릿(비밀키)

시크릿(Secrets)은 은행 금고에 맡겨 둔 열쇠 같은 것 — API 키·토큰·비밀번호처럼 노출되면 안 되는 값을 코드 밖의 안전한 보관소에 따로 저장해 두고 프로그램이 실행될 때만 꺼내 쓰게 하는 방식이에요.

스토리지

스토리지 (Storage)는 사진·영상을 쌓아 두는 창고 같은 것 — 이미지·영상·PDF 같은 파일을 인터넷 서버에 저장해 두고 필요할 때 주소로 꺼내 쓰는 공간이에요.

수파베이스

수파베이스(Supabase)는 엑셀 표와 출입 명부를 한데 묶은 창고 같은 것 — 사이트의 회원·주문·상품 데이터를 저장하는 데이터베이스와 로그인 기능을 함께 제공하는 클라우드 백엔드 서비스예요.

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.