가이드 /
R2 저장소와 Cloudflare 토큰 만들기
곡이 저장되는 곳, 관리 화면용 읽기 전용 사용량 토큰, 꼭 알아야 할 무료 한도.
개인사이트는 곡을 Cloudflare R2에 보관합니다. R2는 내 Cloudflare 계정 안의 저장 공간입니다. meshmelo도 aimusiclist도 내 파일을 가지고 있지 않습니다.
Cloudflare 화면은 가끔 바뀝니다. 버튼 이름이 조금 다르면 가장 비슷한 것을 찾으세요.
1. R2 켜기
- Cloudflare에 로그인합니다.
- 왼쪽 메뉴에서 R2 Object Storage를 엽니다.
- 결제 수단 등록을 요구하면 등록합니다. 무료 한도 안에서는 요금이 나오지 않습니다.
2. 버킷 (곡 폴더)
Deploy to Cloudflare 버튼으로 설치했다면 버킷 aml-music이 이미 만들어져 있습니다. 할 일이 없습니다.
직접 만들려면:
- R2 Object Storage → Create bucket.
- 이름:
aml-music. 위치(Location)는 자동 그대로. - Create bucket을 누릅니다.
- 비공개로 둡니다. 공개 주소
r2.dev는 켜지 마세요. 곡은 내 사이트 주소를 거쳐 재생됩니다.
3. 사용량 토큰 (관리자 만들 때 필요)
관리 화면 맨 위에 무료 한도를 얼마나 썼는지 보여 줍니다. 이를 위해 읽기 전용 토큰이 필요합니다.
가장 쉬운 방법: 내 사이트의 관리자 만들기 화면에서 토큰 링크를 누릅니다. 필요한 권한이 이미 골라진 Cloudflare 화면이 열립니다. Continue to summary → Create Token을 누르고, 토큰을 복사해 붙여넣습니다.
직접 만들기:
- Cloudflare → 오른쪽 위 프로필 아이콘 → My Profile → API Tokens → Create Token.
- Create Custom Token → Get started.
- 토큰 이름:
aml-usage(아무 이름이나 괜찮습니다). - 권한(Permissions): Account · Account Analytics · Read.
- Account Resources: Include · 내 계정.
- Continue to summary → Create Token.
- 토큰을 바로 복사합니다. Cloudflare는 한 번만 보여 줍니다.
이 토큰은 사용량 숫자를 읽기만 합니다. 아무것도 바꾸거나 지울 수 없습니다.
4. 무료 한도
| 항목 | 무료 한도 | 넘으면 |
|---|---|---|
| R2 저장 용량 | 10 GB | 요금 발생 |
| R2 쓰기 (업로드·수정) | 월 100만 회 | 요금 발생 |
| R2 읽기 (재생·이미지) | 월 1,000만 회 | 요금 발생 |
| Workers 요청 (사이트 방문) | 하루 10만 회 | 그날은 사이트 멈춤 (요금 없음) |
2026-10-27에 확인한 한도입니다. 관리 화면 맨 위 막대에서 지금 얼마나 썼는지 볼 수 있습니다.
5. meshmelo 무료 호스팅용 (준비 중)
meshmelo 무료 호스팅이 열리면, 그 버킷 하나만 다룰 수 있는 R2 API 토큰으로 연결합니다:
- R2 → Manage R2 API Tokens → Create API token
- 권한: Object Read & Write
- Specify bucket: 내 버킷만
지금은 필요 없습니다. Global API Key는 누구에게도 알려 주지 마세요.