약 5분
Cloudflare R2에 파일을 업로드하고 링크를 공유하는 방법
Cloudflare R2는 Aktar와 궁합이 아주 좋습니다. 송신(egress) 요금이 없고, 무료 제공량이 10GB이며, 사용자 도메인이 Cloudflare 네트워크를 통해 제공됩니다. 대시보드에서 계정 ID, 버킷 이름, 키 두 개를 복사할 필요가 없습니다. Cloudflare R2 설정…에는 권한이 미리 채워진 링크로 만드는 API 토큰 하나만 있으면 되고, 나머지는 Aktar가 처리합니다. 모든 것을 직접 설정하고 싶다면 마지막 단계를 보세요.
준비물
- Cloudflare 계정(R2 무료 제공량은 10GB)
- 내 도메인으로 링크를 만들고 싶다면 Cloudflare에 등록된 도메인(선택 사항)
- Mac, Windows, iPhone, iPad 또는 Android용 Aktar
단계별 안내
- 1
Cloudflare R2 설정 열기
Aktar 설정에서 대상을 열고 Cloudflare R2 설정…을 선택하세요. 아직 대상이 없다면 이것이 기본 버튼입니다. 그런 다음 Cloudflare 열기를 클릭하세요.
- 2
API 토큰 만들기
이름 Aktar와 두 가지 권한이 이미 선택된 Cloudflare 토큰 페이지가 열립니다. 버킷을 만들고 업로드하기 위한 R2 Storage: Edit, 그리고 공개 링크에 쓸 도메인 목록을 가져오기 위한 Zone: Read입니다. Continue to summary, Create Token을 차례로 선택하고 토큰을 복사하세요.
- 3
붙여 넣고 선택하기
토큰을 Aktar에 붙여 넣으세요. 계정이 여러 개라면 계정을 고른 다음 버킷을 선택합니다. 새 버킷(Aktar는
aktar를 제안합니다) 또는 이미 있는 버킷입니다. 마지막으로 공개 링크가 가리킬 곳을 정합니다.- 버킷의 r2.dev 주소는 바로 쓸 수 있습니다. Cloudflare가 요청 속도를 제한하므로 시험해 볼 때 가장 적합합니다.
- Cloudflare 계정에 있는 도메인의 서브도메인(예:
files.example.com)은 실제로 쓸 때 고르는 옵션입니다. Cloudflare가 DNS 레코드와 인증서를 추가하며, 몇 분 정도 걸립니다.
- 4
설정
설정을 클릭하세요. Aktar가 버킷을 만들고, 공개 링크를 켜고, 대상을 저장한 뒤 연결 테스트를 자동으로 실행합니다. 내 도메인에서는
files.example.com/A7kdP2x.png처럼 깔끔한 경로의 링크가 만들어집니다(짧은 링크 참고). 완료를 선택하거나, 바꾸고 싶은 것이 있으면 편집을 선택한 뒤 첫 파일을 Aktar에 놓아 보세요. - 5
직접 설정하고 싶다면
버킷 하나로 제한된 R2 토큰을 쓰고 싶다면 Cloudflare 대시보드에서 R2 Object Storage를 열고 버킷을 만드세요. 버킷의 Settings에서 Custom Domains로 사용자 도메인을 연결하거나 Public Development URL을 활성화합니다. 그런 다음 Manage API tokens에서 해당 버킷에 대해 Object Read & Write 권한이 있는 토큰을 만들고 Access Key ID와 Secret Access Key를 복사하세요(시크릿은 한 번만 표시됩니다). Aktar에서 대상 추가, Cloudflare R2를 차례로 선택하고 아래 표의 값을 입력하세요.
Aktar 설정 값
설정 → 대상 → 대상 추가에서 다음 값을 입력하세요. 항목 이름은 앱과 같습니다.
| 항목 | 예시 값 |
|---|---|
| 제공업체 | Cloudflare R2 |
| 프로필 이름 | Personal원하는 이름을 쓰면 됩니다. |
| 계정 ID | 3f9a71c0e2b8…R2 개요 페이지에 있습니다. |
| 리전 | auto기본값 그대로 둡니다. |
| 액세스 키 ID | a1b2c3d4…R2 API 토큰에서 가져옵니다. |
| 비밀 액세스 키 | ••••••••키체인이나 자격 증명 관리자에 저장됩니다. |
| 버킷 | screenshots |
| 공개 기본 URL | files.example.com사용자 도메인 또는 r2.dev URL. |
| 객체 경로 | {short}.{ext}선택 사항. 파일 이름과 폴더 항목을 참고하세요. |
팁
- Aktar는 토큰을 보관하지 않습니다. 토큰을 S3 키로 바꾸고(토큰의 ID가 액세스 키, 토큰 값의 해시가 시크릿), 다른 대상의 키와 마찬가지로 보관한 뒤 토큰은 잊습니다. Aktar의 접근을 끊고 싶을 때는 언제든 Cloudflare에서 토큰을 삭제하세요.
- 사용자 도메인은 Cloudflare가 캐시하므로, 많이 열리는 링크도 추가 비용 없이 전 세계에서 빠르게 열립니다.
- 한 기기에서 설정한 다음 다른 기기로 전송으로 키까지 포함된 대상을 다른 컴퓨터와 휴대폰으로 옮기세요.
- 1일에서 30일 뒤 저절로 삭제되는 업로드를 원하나요? 키가 수명 주기 규칙을 관리할 수 있으면 Aktar가 버킷의 규칙을 대신 추가합니다. Cloudflare R2 설정으로 만든 키나 Admin Read & Write 토큰이 그렇습니다. Object Read & Write 토큰이라면 버킷 Settings의 Object Lifecycle Rules에서 직접 추가하세요. 만료 업로드를 참고하세요.
문제 해결
설정에서 공개 링크가 아직 작동하지 않는다고 나와요
내 도메인을 연결한 직후에는 Cloudflare가 아직 DNS 레코드와 인증서를 추가하는 중입니다. 몇 분 기다린 뒤 대상 메뉴에서 연결 테스트를 다시 실행하세요.
설정에서 토큰에 연결된 계정을 찾지 못해요
토큰이 계정 접근 권한 없이 만들어졌습니다. Cloudflare 열기에서 토큰을 다시 만들고, Account Resources에서는 제안된 계정(또는 All accounts)을 그대로 두세요.
링크를 열면 Access Denied나 403이 나와요
공개 기본 URL이 사용자 도메인이나 r2.dev URL인지 확인하세요. …r2.cloudflarestorage.com 엔드포인트는 API 전용이며 공개 파일을 제공하지 않습니다. 자세한 내용은 Access Denied 오류를 참고하세요.
연결 테스트에서 자격 증명이 유효하지 않다고 나와요
직접 설정했다면 일반 Cloudflare API 토큰이나 Global API Key가 아니라 R2 API 토큰의 Access Key ID와 Secret Access Key를 쓰세요. 계정 ID에 불필요한 공백이 없는지도 확인하세요.
업로드는 되는데 링크가 느리거나 속도 제한이 걸려요
r2.dev 개발용 URL을 쓰고 있을 가능성이 높습니다. 실제 서비스용으로는 사용자 도메인을 연결하세요.
아직 해결되지 않았나요?FAQ를 살펴보거나 GitHub에서 물어보세요.