🚀 R2 신규 계정 셋업 가이드

새 이메일로 Cloudflare R2 추가 계정 만들기 — 끝까지 따라하면 약 15-20분 소요

← 홈페이지 관리

📌 왜 새 계정?

기존 R2 (skycloverve@gmail.com) — 무료 10GB 한도 중 14GB 색칠공부로 사용 중 (이미 초과 → 유료 전환됐을 가능성)
새 계정 — 추가 10GB 무료 한도 + 회계 분리 + 사고 격리
이번 업로드 대상 — 월별수업 약 6GB + 아트샵 자료 약 2.5GB = 약 8.5GB (새 계정 무료 한도 안)

이메일 결정

새 Cloudflare 계정에 사용할 이메일을 정하세요. 기존 두 개와 달라야 합니다.

추천 작명 규칙: 기존 패턴(`skyclover<숫자>` / `skyclover<단어>`) 따라가기. 예시:

skycloverart@gmail.com — 아트샵 도안 전용
skycloverlessons@gmail.com — 월별수업 이미지 전용
luna.whale.r2@gmail.com — 통합 이미지 (가장 명확)

📝 결정 후 site-management.html의 계정 분리 정책 표에 추가하세요. 까먹지 않게.

Gmail 계정 생성 5분

🔗 accounts.google.com/signup

이름: Luna Whale Cloud (또는 본명)
이메일: 위에서 정한 이름 (예: luna.whale.r2)
비밀번호: 강력하게 설정 (저장 필수)
전화번호 인증: 기존 번호 그대로 가능 (Google은 한 번호로 여러 계정 OK)
복구 이메일: skyclover777@gmail.com 입력 (계정 잃어버림 방지)

✅ 가입 완료되면 새 Gmail에 로그인된 상태로 진행하세요. 다른 브라우저(시크릿 창) 또는 Chrome 프로필 분리 권장.

Cloudflare 가입 3분

🔗 dash.cloudflare.com/sign-up

방금 만든 새 Gmail 입력
비밀번호 설정 (Gmail 비밀번호와 달라야 함)
이메일 인증 — 새 Gmail 받은편지함에서 Cloudflare 인증 메일 클릭
가입 완료 → Dashboard 자동 진입

Plan 선택 화면 나오면: Free 선택. 도메인 등록 단계 나오면 건너뛰기 (R2는 도메인 불필요).

R2 활성화 + 결제 정보 등록 3분

왼쪽 사이드바에서 R2 Object Storage 클릭
"Purchase R2" 또는 "Enable R2" 버튼 클릭
결제 정보 등록 화면 — 카드 등록 필수 (무료 한도 안에서는 청구 안 됨)
- 카드: 기존 PayPal 사용 카드 또는 다른 카드
- 주소: 베트남 주소 OK (또는 한국 주소)
R2 활성화 완료 → 빈 R2 대시보드 표시

⚠️ 무료 한도 확인: 매월 10GB 저장 + 1M Class A 요청 + 10M Class B 요청 무료. 초과 시 자동 청구 → 대시보드에서 "Billing Alert" 설정 권장 ($5 정도로).

버킷 생성 1분

R2 대시보드에서 "Create bucket" 클릭
Bucket name: luna-assets 입력 (또는 원하는 이름)
luna-assets복사
Location: Asia-Pacific (APAC) 선택 (베트남·한국 사용자에게 가장 빠름)
"Create bucket" 클릭

Public Access 활성화 1분

웹사이트에서 이미지를 불러오려면 공개 URL이 필요합니다.

방금 만든 luna-assets 버킷 클릭
상단 탭 "Settings" 클릭
"Public Access" 섹션 → "Allow Access" 클릭 (r2.dev 도메인)
경고 모달에서 "Allow" 확인 → 공개 URL 생성됨
표시되는 URL 복사: https://pub-XXXXXXXXXXXX.r2.dev

✅ URL 복사한 뒤 site-management.html에 기록! 까먹기 쉬움. 또는 카톡 자기한테 보내기.

API Token 발급 2분

rclone 같은 도구로 업로드하려면 토큰 필요합니다.

R2 대시보드 좌측 메뉴 → "Manage R2 API Tokens" 클릭
"Create API token" 클릭
Token name: rclone-uploader 입력
Permissions: "Admin Read & Write" 선택 (또는 Object Read & Write)
Specify bucket(s): luna-assets만 선택 (다른 버킷 접근 제한)
TTL: Forever (또는 1년 — 보안상 짧을수록 좋지만 일단 Forever)
"Create API Token" 클릭

🚨 한 번만 표시됨: 다음 3가지를 즉시 복사 + 안전한 곳에 저장:

Access Key ID
Secret Access Key
Endpoint (https://<...>.r2.cloudflarestorage.com)

분실 시 토큰 재발급 필요. 맥 비밀번호 매니저(Keychain) 또는 1Password 추천.

rclone에 새 remote 추가 3분

기존 r2 remote(skycloverve 계정)는 그대로 두고, 새 r2new remote 추가.

터미널에서 실행:

rclone config복사

n 입력 — New remote
name: r2new (또는 원하는 이름, 단 r2와 달라야 함)
Storage: s3 입력 (Amazon S3 호환)
provider: Cloudflare 입력
env_auth: 1 (false)
access_key_id: Step 7에서 복사한 Access Key ID 붙여넣기
secret_access_key: Step 7에서 복사한 Secret 붙여넣기
region: auto
endpoint: Step 7에서 복사한 Endpoint URL 붙여넣기
형식: https://<account-id>.r2.cloudflarestorage.com
location_constraint: 비워두기 (Enter)
acl: n (Not set)
나머지 다 기본값 (Enter Enter Enter...)
마지막에 y — Yes this is OK
q — Quit config

✅ 확인: rclone listremotes 실행하면 r2: 와 r2new: 둘 다 보여야 함.

테스트 업로드 (1장) 1분

바로 큰 폴더 올리지 말고, 작은 테스트 파일 1장으로 권한 확인.

rclone copy /Users/sky7_mac/Documents/000_homepage/images/logo.png r2new:luna-assets/test/ --progress복사

완료 후 브라우저에서 확인:

https://pub-XXXXXXXXXX.r2.dev/test/logo.png (Step 6에서 받은 Public URL + /test/logo.png)

✅ 이미지 보이면 성공! 다음 단계로.

❌ 403 또는 404 나오면:
1) Public Access (Step 6) 활성화됐는지 확인
2) 파일이 실제 업로드됐는지 R2 콘솔에서 확인
3) URL 오타 확인

완료 시 저(claude)에게 알려주기 🎉

아래 3가지 정보만 알려주시면 나머지는 자동으로 진행됩니다 (대량 업로드 + HTML 경로 갱신 + 배포):

1️⃣ 새 Gmail 주소 (예: luna.whale.r2@gmail.com)
2️⃣ Public URL (예: https://pub-XXXXXXXX.r2.dev)
3️⃣ rclone remote 이름 (예: r2new)

⚠️ Access Key/Secret은 절대 채팅에 붙여넣지 마세요. rclone 설정 안에만 저장.

🤖 사용자 정보 받은 후 제가 자동 진행할 작업

1. 월별수업 images/lessons/ 5.8GB → r2new:luna-assets/lessons/ 업로드 (예상 8-12분)
2. 아트샵 도안 0_홈페이지미술수업202604추가작업/ 약 2.5GB → r2new:luna-assets/atelier/ 업로드
3. PNG → JPG 변환 결과물 (현재 진행 중) → R2 업로드
4. HTML 경로 일괄 치환: https://pub-5c6f81e15f364b5e9af286a8c8895682.r2.dev/lessons/ → https://pub-XXXXXXXX.r2.dev/lessons/
5. art-shop.html 도안 카탈로그 자동 생성
6. .firebaseignore 갱신 (Firebase에서 lesson 이미지 제외)
7. Firebase 배포 → 코드만 → 배포 시간 대폭 단축
8. 전체 검증 (이미지 200 OK, monthly-detail 카드 확인)
9. site-management.html 갱신 (새 계정 정보 추가)

🛠 자주 발생하는 문제

"R2 활성화 시 카드 등록이 거부됨"

베트남 카드가 거부되면 한국 카드 또는 PayPal 사용. 사용자가 PayPal 옵션 등록한 게 있다면 그거 사용.

"rclone config 도중 막힘"

rclone config file
# 표시되는 경로 (보통 ~/.config/rclone/rclone.conf) 직접 편집 가능
# 기존 [r2] 섹션 아래에 [r2new] 섹션 직접 추가:

[r2new]
type = s3
provider = Cloudflare
access_key_id = (Access Key ID)
secret_access_key = (Secret)
region = auto
endpoint = https://<account-id>.r2.cloudflarestorage.com

"테스트 업로드는 됐는데 URL 접속 시 401/403"

Step 6 Public Access를 다시 확인. Settings → Public Access → 반드시 "Allow Access" 상태여야 함. 또는 Custom Domain 사용 시 도메인 DNS 전파 대기 (최대 24시간).

"새 계정 비밀번호 잊어버릴까봐 걱정"

맥 키체인(Keychain Access) 또는 1Password에 저장. 복구 이메일을 skyclover777@gmail.com으로 설정해두면 비밀번호 잊어도 복구 가능.

가이드 작성: 2026-05-17 · ← 홈페이지 관리