클라우드플레어 R2(Cloudflare R2)는 사이트 전용 창고 같은 것 — 이미지·전자책 같은 파일을 클라우드에 보관하고 꺼내 쓰는 클라우드플레어의 저장소 서비스이며, 그 안의 칸 하나를 버킷이라고 불러요.
사이트를 가게라고 하면 R2는 가게 뒤편의 창고예요. 상품 사진, 판매용 전자책 파일, 영상 썸네일처럼 덩치 큰 파일을 창고에 넣어 두고 필요할 때만 꺼내 손님에게 보여 주는 식이에요. 창고 안을 용도별로 나눈 칸이 '버킷(Bucket)'이에요. 예를 들어 '상품 이미지' 버킷과 '전자책' 버킷을 따로 만들어 관리할 수 있어요.
강의에서는 내 사이트의 이미지와 파일 저장소로 R2를 써요. 대시보드의 R2 메뉴에서 저장소를 활성화하는데, 무료 범위 안에서 쓰더라도 결제 수단을 먼저 등록해야 켜져요. 버킷을 만든 뒤에는 Object Read and Write 권한의 API 토큰을 발급하고, 그때 나오는 Access Key와 Secret Key를 에이전트에게 넘겨야 에이전트가 버킷에 파일을 올리고 지울 수 있어요. 에이전트가 직접 버킷을 만들고 토큰 권한을 특정 버킷에만 주는 장면도 나오고, 새 서비스의 사진 저장도 'Supabase Storage 대신 R2를 써 줘'라고 말하면 그대로 바꿔 준다고 설명해요.
초보가 헷갈리는 점은 토큰 권한이에요. 모든 버킷에 쓰기 권한을 주는 것보다 필요한 버킷 하나에만 주는 편이 안전해요. Access Key와 Secret Key는 비밀번호와 같으니 코드에 직접 적지 말고 환경 변수로 보관하세요. 또 버킷을 공개로 열면 주소만 알면 누구나 파일을 받을 수 있으니, 유료 전자책처럼 막아야 할 파일은 공개 설정 여부를 꼭 확인해야 해요. 무료 한도와 요금은 바뀔 수 있으니 공식 안내를 확인하세요.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.