본문으로 건너뛰기

Cloudflare R2 업로드 오류 해결하기 — RcloneView로 문제 해결하는 방법

· 약 6분
Jay
Tech Writer

Cloudflare R2는 특정한 자격 증명 및 엔드포인트 요구 사항을 가지고 있어 잘못 설정하면 오류가 발생합니다. RcloneView에서 가장 흔한 R2 업로드 및 동기화 실패를 진단하고 해결하는 방법을 알아봅니다.

Cloudflare R2는 이그레스 비용이 없는 S3 호환 객체 스토리지 서비스로, 콘텐츠 배포 및 백업 작업에 매력적인 선택지입니다. 하지만 R2의 인증 모델은 표준 AWS S3와 약간 다릅니다 — 대부분의 S3 사용자에게 익숙한 IAM 방식의 키 쌍 대신 Account ID와 API 토큰을 함께 사용합니다. RcloneView에서 이러한 정보를 올바르게 설정하는 것이 대부분의 R2 오류를 해결하는 핵심입니다.

RcloneView 앱 미리보기

모든 클라우드를 한 곳에서 관리하고 동기화하세요

RcloneView는 rclone의 크로스플랫폼 GUI입니다. 폴더를 비교하고, 파일을 전송·동기화하고, 깔끔한 시각적 인터페이스로 멀티 클라우드 워크플로를 자동화하세요.

  • 원클릭 작업: 복사 · 동기화 · 비교
  • 안정적인 자동화를 위한 스케줄러와 작업 이력
  • Google Drive, OneDrive, Dropbox, S3, WebDAV, SFTP 등 지원
WindowsmacOSLinux
무료로 시작하기 →

핵심 기능은 무료. Plus로 자동화 기능 이용 가능.

오류: 403 Forbidden 또는 잘못된 자격 증명

가장 흔한 R2 오류는 403 Forbidden 응답으로, 대개 잘못된 API 토큰 설정이 원인입니다. Remote 탭 → New Remote에서 Cloudflare R2를 추가할 때는 세 가지 정보가 필요합니다: R2 API 토큰(해당 버킷에 대한 Object Read/Write 권한 포함), Account ID(Cloudflare 대시보드에서 확인 가능), 그리고 https://<ACCOUNT_ID>.r2.cloudflarestorage.com 형식의 R2 엔드포인트 URL입니다.

흔한 실수는 R2 전용 API 토큰 대신 Global API Key를 사용하는 것입니다. Cloudflare의 R2 섹션에서 Manage API Tokens를 통해 전용 API 토큰을 생성하고, 대상 버킷에 대해 최소한 "Object Read & Write" 권한이 부여되어 있는지 확인하세요. 개별 파일 접근은 되지만 버킷 목록 조회에서 403 오류가 발생한다면, 토큰에 버킷 수준의 list 권한이 없는 것일 수 있습니다 — "Account → R2 → Read/Write" 범위로 토큰을 재생성하세요.

Configuring Cloudflare R2 credentials in RcloneView

오류: 멀티파트 업로드 실패 또는 업로드 미완료

R2는 100MB를 초과하는 파일에 필요한 멀티파트 업로드를 지원하지만, 완료되지 않은 멀티파트 업로드는 버킷에 고아 파트(orphaned part)를 남겨 이후 동일한 파일명의 업로드가 실패하는 원인이 될 수 있습니다. RcloneView의 Log 탭에서 upload multipart failed 또는 NoSuchUpload와 같은 메시지를 확인하세요.

해결 방법은 먼저 Cloudflare 대시보드 또는 RcloneView 내부의 rclone 터미널을 사용해 R2 버킷에서 고아 멀티파트 업로드를 정리하는 것입니다. 그런 다음 작업의 Advanced Settings에서 동시 멀티파트 스트림 수를 줄여 업로드를 재시도하세요. Settings의 Global Rclone Flags 옵션을 통해 --s3-upload-concurrency 4를 설정하면 R2로의 대용량 업로드를 안정화할 수 있습니다.

Retrying a failed R2 upload job in RcloneView

엔드포인트 및 리전 오류

Cloudflare R2는 표준 AWS 리전 코드를 사용하지 않습니다. NoSuchBucket 또는 InvalidLocationConstraint 오류가 발생하면 리모트 설정의 엔드포인트 URL을 확인하세요. 올바른 형식은 https://<YOUR_ACCOUNT_ID>.r2.cloudflarestorage.com이며, Account ID는 Cloudflare 계정과 정확히 일치해야 합니다. R2의 경우 리전 필드는 비워 두거나 auto로 설정해야 합니다.

다른 S3 서비스에서 엔드포인트를 복사했다면, 그것이 s3.us-east-1.amazonaws.com과 같은 AWS 리전 URL이 아니라 Account ID 접두사로 시작하는지 다시 확인하세요.

Monitoring R2 upload after fixing configuration errors

시작하기

  1. rcloneview.com에서 RcloneView를 다운로드하세요.
  2. R2 API 토큰이 대상 버킷에 대한 Object Read/Write 권한을 가지고 있는지 확인하세요.
  3. 엔드포인트 URL이 https://<ACCOUNT_ID>.r2.cloudflarestorage.com 형식을 사용하는지 확인하세요.
  4. 대용량 파일의 경우 멀티파트 업로드 동시성을 줄이고 고아 업로드를 정리하세요.

올바르게 설정하면 RcloneView와 함께 사용하는 Cloudflare R2는 예측 가능한 비용으로 백업 및 아카이빙에 뛰어난 성능을 제공합니다.


관련 가이드:

지원 클라우드 제공업체

Local Files
WebDAV
FTP
SFTP
HTTP
SMB / CIFS
Google Drive
Google Photos
Google Cloud Storage
OneDrive
Dropbox
Box
MS Azure Blob
MS File Storage
S3 Compatible
Amazon S3
pCloud
Wasabi
Mega
Backblaze B2
Cloudflare R2
Alibaba OSS
Ceph
Swift (OpenStack)
IBM Cloud Object Storage
Oracle Cloud Object Storage
IDrive e2
MinIO
Storj
DigitalOcean Spaces