Cloudflare R2¶
Cloudflare R2 버킷을 Windows 드라이브로 마운트합니다.
시작하기 전에¶
Cloudflare 대시보드에서 계정 ID와 R2 API 토큰의 엑세스 키 ID / 비밀 엑세스 키가 필요합니다.
발급 위치 — Cloudflare 대시보드에서:
- R2를 열면 개요 페이지에 계정 ID가 표시됩니다.
- Manage R2 API Tokens → Create API Token을 클릭합니다.
- Object Read & Write 권한을 주고(원하면 버킷 범위 제한) Create를 클릭합니다.
- 엑세스 키 ID와 비밀 엑세스 키를 복사합니다 — 한 번만 표시됩니다.
연결¶
- 툴바에서 추가를 클릭합니다.
- Enterprise → Cloudflare R2를 선택합니다.
- 계정 ID, 엑세스 키 ID, 비밀 엑세스 키를 입력하고 버킷 입력란 옆 새로 고침 버튼을 클릭합니다.
- 버킷을 선택하고 연결을 클릭합니다.
버킷 직접 입력
키에 버킷 나열 권한이 없으면, 버킷 입력란 왼쪽 체크박스를 켜고 버킷 이름을 직접 입력합니다.
설정¶
| 설정 | 설명 | 기본값 |
|---|---|---|
| 계정 ID | R2 엔드포인트 식별자 (<account-id>.r2.cloudflarestorage.com) |
— |
| 엑세스 키 ID / 비밀 엑세스 키 | R2 API 토큰에서 발급 | — |
| 버킷 | 마운트할 버킷 (목록 또는 직접 입력) | — |
| 읽기전용 | 드라이브 쓰기 차단 | 꺼짐 |
동작과 제한¶
- R2에는 버킷별 리전이 없습니다 — 모든 버킷이 계정 엔드포인트로 접근되며 위치는 자동 결정됩니다(위치 힌트 선택 가능) — Cloudflare: R2 데이터 위치 참고합니다.
- S3 특성: 큰 폴더 트리의 이름 변경은 접두사 아래 오브젝트 전체의 복사+삭제입니다.
문제 해결¶
| 증상 | 원인 | 조치 |
|---|---|---|
| 인증 실패 | 토큰에 Object Read & Write 없음, 또는 계정 ID 오류 | R2 API 토큰 재생성; 계정 ID 정확히 복사 |
| 버킷 목록이 비어 있음 | 토큰이 특정 버킷으로 제한됨 | 버킷 이름 직접 입력 |