R2 S3 인증 키
Access Key ID + Secret Access Key
버킷의 파일을 읽고 업로드할 때 사용합니다.
사용 튜토리얼 · v1.7.34
클라우드 플레어 파일관리
R2 버킷에 예시 파일을 올리고 공개 URL에서 결과를 확인합니다.
따라 하기
R2 인증 키 등록부터 버킷에서 이미지 확인하기
자신의 R2 연결과 버킷을 선택하세요. 캡처는 항구 자료실 연결에 표정 PNG가 있는 예시 응답입니다. 캡처의 주황색 번호는 해당 단계에서 누르거나 결과를 확인할 위치입니다.
계정과 R2 키 연결 1–4단계
01 Account ID와 R2 주소 확인
Cloudflare 대시보드의 R2 Overview에서 계정 ID와 S3 API 엔드포인트를 확인하세요. 툴박스 설정 → 클라우드 플레어에 Account ID를 입력합니다.
확인 기본 관할 S3 주소가 채워집니다. 실제 버킷의 관할과 주소가 맞는지 확인하세요. 캡처 값은 예시입니다.
02 R2 Access Key ID 입력
R2 Overview → API Tokens → Manage에서 R2용 토큰을 만듭니다. 업로드할 버킷을 지정하고 Object Read & Write 권한을 선택한 뒤 발급된 Access Key ID를 같은 이름의 칸에 넣으세요.
확인 Account ID는 계정을, Access Key ID는 요청에 쓸 인증 키를 가리킵니다.
03 Secret Access Key 입력
같은 발급 화면의 Secret Access Key를 붙여 넣고 입력칸 밖을 눌러 저장 상태를 확인하세요. 이 값은 발급 창을 떠나면 다시 볼 수 없습니다.
확인 키 두 개가 한 쌍으로 저장됩니다. 캐시 삭제를 사용하지 않는다면 선택 항목은 비워 두세요.
04 R2 연결 선택
파일관리에서 자신의 연결을 누릅니다. 예시 화면은 로컬 예시 응답을 사용하는 항구 자료실입니다.
확인 연결에 접근할 수 있는 버킷이 목록에 나타납니다.
버킷과 파일 확인 5–8단계
05 버킷 열기
왼쪽 버킷 목록에서 harbor를 누릅니다. 실제 사용자는 본인의 버킷을 선택하세요.
확인 해당 버킷의 객체가 중앙에 나타납니다.
06 예시 객체 선택
중앙의 미소.png를 누릅니다. 실제 빈 버킷에서는 업로드 버튼으로 표정 연습/미소.png를 먼저 올리고 완료를 기다리세요.
확인 선택된 파일을 대상으로 상세 정보와 작업 버튼을 확인할 수 있습니다.
07 목록 보기로 전환
상단 목록 보기 버튼을 누릅니다.
확인 같은 파일이 이름과 속성을 비교하기 쉬운 행으로 표시됩니다.
08 버킷과 파일명 대조
목록에서 현재 버킷과 미소.png 이름을 확인하세요. 실제 연결에 공개 URL이 설정됐다면 파일을 선택해 공개 URL 복사를 사용할 수 있습니다.
확인 보기 방식만 바뀌고 버킷과 객체 경로는 유지됩니다. 예시 버킷에는 실제 외부 업로드를 하지 않았습니다.
기능별 사용법
01 계정과 버킷 연결
공통 설정의 클라우드 플레어에서 Account ID, R2 S3 엔드포인트, Access Key ID와 Secret Access Key를 입력합니다. 파일관리에서 권한이 있는 버킷을 선택하고 목록이 열리는지 확인하세요. 키 발급과 입력값은 아래 04단계에서 확인하세요.
02 파일 전송
대상 폴더로 이동하고 파일을 업로드합니다. 전송 진행률과 완료 목록을 확인한 뒤 검색 또는 미리보기로 객체를 찾으세요. 같은 경로에 같은 이름을 올리면 기존 객체가 교체될 수 있으므로 파일명을 먼저 확인합니다.
03 공개 주소 확인
연결에 버킷의 공개 URL을 설정한 뒤 공개 URL 복사로 주소를 확인합니다. 교체 후 이전 파일이 보이면 해당 연결의 공개 주소와 캐시 초기화 설정을 확인하세요. 다운로드 결과도 열어 로컬 파일과 대조합니다.
04 R2 키 발급부터 캐시 설정까지
공통 설정에 입력할 값, 버킷별 권한, 공개 URL과 S3 엔드포인트의 차이를 순서대로 확인하세요.
API 키는 개발자에게 전달되지 않습니다
툴박스는 입력한 R2 인증 정보와 LLM API 키를 개발자 서버로 전송하거나 수집하지 않습니다. 개발자가 사용자의 키를 원격으로 조회하는 기능도 없습니다.
클라우드 기능은 사용자 PC에서 Cloudflare 또는 선택한 AI 제공사의 공식 API에 직접 연결합니다. 인증 정보는 해당 서비스의 요청 인증에 사용되며, 개발자 서버를 경유하지 않습니다.
내 PC에 암호화하여 보관합니다
저장한 인증 정보는 현재 Windows 계정에 연결된 암호화(DPAPI)로 보호됩니다. 개발자가 보관하는 공용 복호화 키는 없으며, 앱이 해당 Windows 계정에서 필요한 정보를 복호화해 사용합니다.
이 보호는 PC에 저장된 인증 정보에 적용됩니다. 같은 Windows 계정에서 실행되는 프로그램까지 접근을 차단하는 방식은 아닙니다.
캐시 초기화용 API 토큰
Cache Purge 권한이 있는 토큰
같은 URL의 파일을 교체한 뒤 캐시를 비울 때 사용합니다.
Cloudflare에서 R2 버킷 준비하기
Cloudflare 대시보드 ↗에 로그인하고 Storage & databases → R2 → Overview를 엽니다. R2를 처음 사용한다면 활성화를 마친 뒤 Create bucket으로 파일을 담을 버킷을 만드세요. 이미 있는 버킷도 사용할 수 있습니다.
R2 전용 키 발급하기
R2 Overview의 Account Details → API Tokens → Manage로 들어갑니다. 본인 계정에서 가능한 Create Account API token 또는 Create User API token을 선택하세요.
권한은 Object Read & Write, 대상은 Apply to specific buckets only로 설정하고 사용할 버킷을 지정합니다. 만든 뒤 표시되는 Access Key ID와 Secret Access Key를 보관하세요. Secret Access Key는 이 화면을 떠나면 다시 볼 수 없습니다.
툴박스의 공통 설정에 입력하기
앱에서 설정 → 클라우드 플레어을 열고, 발급 화면에서 복사한 값을 같은 이름의 칸에 넣습니다.
- Account ID
- Cloudflare 계정 ID. 앱에서 엔드포인트와 자동 연동됩니다.
- R2 S3 API 엔드포인트
- R2 화면에서 복사한 S3 API 주소.
https://<ACCOUNT_ID>.r2.cloudflarestorage.com기본 관할 예시입니다. 버킷 관할에 맞는 주소를 사용하고, 주소 끝에 버킷 이름을 붙이지 마세요. - Access Key ID
- R2 키 발급 결과의 Access Key ID.
- Secret Access Key
- 같은 발급 결과의 Secret Access Key. 일반 API Token 값과 혼동하지 마세요.
두 키를 입력한 뒤 칸 밖을 누르고 공통 설정을 자동 저장했습니다 표시를 확인합니다. 설정은 현재 Windows 계정으로 암호화하여 PC에 저장되며, 앱을 다시 실행해도 복원됩니다. 설정 저장만으로 업로드가 시작되지는 않습니다.
버킷을 연결하고 파일 목록 확인하기
클라우드 플레어 파일관리에서 연결에 사용할 버킷 이름을 입력하세요. 인증 키 발급 때 허용한 버킷과 정확히 같아야 합니다. 파일 목록이 열리는지 먼저 확인한 뒤 업로드하세요.
파일을 업로드할 때는 선택한 버킷과 현재 저장 경로를 확인하세요. 공개 URL이 필요하면 버킷에 공개 도메인을 연결하고 해당 주소를 설정하세요. S3 엔드포인트와 공개 다운로드 주소는 용도가 다릅니다.
선택 설정 · 업로드 후 캐시도 자동으로 비우려면
Cloudflare에 연결한 공개 도메인의 캐시를 초기화할 때 설정합니다. R2 파일 업로드만 사용한다면 이 부분은 비워 두어도 됩니다.
- Cloudflare의 프로필 → API Tokens → Create Token → Custom token에서 토큰을 만듭니다.
- 권한은 Zone → Cache Purge → Purge, Zone Resources는 Include → Specific zone으로 설정하고 공개 도메인의 영역을 선택하세요.
- 발급된 값을 앱의 캐시 초기화용 API 토큰에 입력합니다.
- 공개 URL 베이스에는
https://cdn.example.com처럼 실제 파일을 제공하는 주소를, Zone ID에는 해당 도메인의 Overview에서 확인한 영역 ID를 입력합니다. Account ID와 Zone ID는 다릅니다. - 업로드 후 해당 파일 캐시 자동 초기화를 켜고 적용하세요. 파일 관리의 연결별 공개 URL·Zone ID도 사용하는 버킷에 맞춰 확인하세요.
연결이 안 되면 무엇부터 확인하나요?
- 인증 실패 / AccessDenied: 키 2개가 같은 발급 결과인지, 읽기·쓰기 권한과 허용 버킷이 맞는지 확인하세요.
- 엔드포인트 오류: 공개 URL이 아닌 R2 S3 주소를 입력했는지 확인하세요. 기본·EU·FedRAMP의 공식 R2 주소 형식을 지원합니다. 버킷 관할에 맞는 엔드포인트를 입력하세요.
- 업로드는 되는데 이전 파일이 보임: 공개 URL 베이스, Zone ID, 별도 Cache Purge 토큰을 확인하세요.
- Secret Access Key를 잃어버림: 새 R2 키를 발급해 앱 설정을 교체하세요. 키를 공유 게시물이나 문의 스크린샷에 노출하지 마세요.
05 같은 경로에 다시 올렸을 때
같은 버킷과 객체 경로에 업로드하면 기존 객체가 교체될 수 있습니다. 전송을 취소해도 이미 완료된 파일은 남습니다. 공개 주소에 이전 이미지가 보이면 업로드한 대상 버킷과 객체 경로를 먼저 확인한 뒤 연결별 공개 URL·캐시 초기화 설정을 확인하세요.