맥 Cloudflare R2 업로드: 자신의 버킷 연결
업데이트:
맥 Cloudflare R2 업로드: 설정
맥 Cloudflare R2 업로드는 자신의 버킷을 만들거나 선택하고 자격 증명을 발급받아 Yuzu Drag의 Upload 설정에 연결 정보를 입력한 뒤 진행합니다. 파일을 드래그하고 Actions를 열어 UPLOAD에 놓으세요. Upload는 네트워크 연결이 필요하며 파일을 자신의 S3 호환 버킷으로 보냅니다. Yuzu는 호스팅 저장소를 제공하지 않습니다.
단축키 안내: 아래 단계는 기본 설정을 사용합니다. 파일을 드래그한 상태에서 ⌘를 짧게 눌렀다 놓으면 Tools, 다시 누르면 Actions가 열립니다. ⇧는 Convert를 엽니다. Yuzu에서 단축키를 바꿨다면 설정한 키를 사용하세요.
업로드 성공이 객체의 자동 공개를 뜻하지는 않습니다. 누가 파일을 가져올 수 있어야 하는지, 공개 URL이 필요한지 따로 결정하세요.
공급자의 브라우저 인터페이스부터 시작하기
macOS Finder에는 R2 버킷 연결 기능이 없습니다. 가끔 올린다면 Safari 등 브라우저에서 Cloudflare 대시보드를 열고 원하는 버킷의 업로드 인터페이스를 사용하세요. 데스크탑 클라이언트를 설치하거나 저장소 자격 증명을 제공하지 않아도 됩니다.
업로드 후 대시보드에서 객체를 살펴보세요. 이름, 대상 버킷, 의도한 접근 범위를 확인합니다. 일회성 관리나 버킷 정책 변경은 공급자 대시보드가 더 명확합니다. 그런 정책은 파일 드래그 유틸리티의 역할 밖이기 때문입니다.
버킷이 이미 설정돼 있고 대시보드를 반복해서 여는 일을 피하려면 데스크탑 업로더를 사용하세요. 객체, 접근 규칙, 자격 증명, 계정 사용량 확인을 위해 대시보드는 계속 활용하세요.
자신의 버킷과 자격 증명 준비하기
Yuzu를 설정하기 전에 공급자 계정에서 엔드포인트, 버킷 이름, 액세스 키 ID, 비밀 액세스 키를 준비하세요. Cloudflare R2의 리전은 auto입니다. 다른 사람의 예시 엔드포인트를 복사하지 말고 계정에 실제 제공된 값을 사용하세요.
의도한 버킷과 작업에 필요한 권한만 부여하세요. 자격 증명을 문서, 스크린샷, 셸 기록, 공유 메시지에 남기지 마세요. Yuzu는 비밀 값을 키체인에 저장하지만 공급자 계정에서 보호하고 폐기할 책임이 없어지는 것은 아닙니다.
작고 민감하지 않은 시험 파일을 고르세요. 첫 시험은 설정을 확인하기 전에 전체 작업 폴더를 보내는 것이 아니라 어느 버킷과 경로가 객체를 받는지 확인하는 단계여야 합니다.
Yuzu Drag에서 Upload 설정하기
다운로드 페이지에서 앱을 설치하세요. Upload 설정을 열고 양식의 필드를 입력합니다.
- Endpoint: S3 호환 서비스 엔드포인트.
- Bucket: 소유하거나 사용할 권한이 있는 기존 버킷.
- Access Key ID: 해당 자격 증명 식별자.
- Secret: 저장 시 키체인에 보관되는 비밀 액세스 키.
- Region: Cloudflare R2는 auto.
- Path prefix: 이 구성으로 올리는 객체에 붙일 선택적 접두 경로.
- Public URL: 링크 생성을 위한 선택적 공개 URL 기준 주소.
Test connection으로 작성 중인 구성을 확인하세요. 연결 시험은 버킷 검사를 수행하지만 편집한 값을 저장하지는 않습니다. 유지하려면 Save를 따로 누르세요. 연결 검사 성공은 연결성에 대한 유용한 증거지만 업로드와 다운로드 전체 시험은 아닙니다.
공개 URL 필드는 선택 사항입니다. 사용할 수 있는 공개 링크를 원하면 업로드된 객체를 실제로 제공하는 기준 주소를 입력하세요. URL을 입력한다고 버킷 접근 정책이 바뀌거나 공개 도메인이 생성되지는 않습니다.
업로드 후 결과 살펴보기
- Finder에서 시험 파일을 드래그합니다.
- ⌘로 Tools, 다시 ⌘로 Actions를 엽니다. 종류가 섞인 일부 선택은 바로 Actions가 열립니다.
- UPLOAD 영역에 놓습니다.
- 작업 결과를 기다립니다.
- 공급자 대시보드에서 업로드된 객체를 확인합니다.
- 복사된 결과를 비공개 메모에 붙여넣고 URL인지 객체 키인지 확인합니다.
휠의 ⇧는 별도 그룹인 Convert를 엽니다. UPLOAD는 Action이며 폴더가 아닌 파일을 받습니다.
공개 URL 기준 주소가 있으면 업로드 후 링크를 복사하고, 없으면 객체 키를 복사합니다. 일괄 작업의 결과는 줄바꿈으로 구분됩니다. 메시지에 붙여넣기 전에 확인하세요. 객체 키는 수신자가 바로 받을 수 있는 다운로드 링크가 아닙니다.
업로드는 원격 객체를 만들고 로컬 원본은 그대로 둡니다. 원격에 의도한 이름이 이미 있으면 Yuzu는 의도적으로 덮어쓰는 대신 번호가 붙은 이름을 시도합니다. 원래 파일명이 그대로 쓰였다고 생각하지 말고 최종 키를 확인하세요.
공개 접근, 비용, 실패
파일에 적절할 때만 공개 링크를 공유하세요. 로그인된 대시보드 세션에 의존하지 않고 링크를 시험합니다. 비공개여야 한다면 편리함만을 위해 공개 기준 주소를 넣지 말고 조직이 승인한 접근 방법을 사용하세요.
저장, 검색, 공급자 제한은 자신의 계정에 속합니다. Yuzu는 백업 서비스나 버킷 정책 편집기가 아니며 링크의 지속적 가용성을 약속하지 않습니다. 삭제와 보관은 공급자 대시보드에서 관리하세요.
묶음 일부만 성공하면 전체 재시도 전에 작업 결과를 확인하세요. 나중 항목이 실패하거나 나머지를 취소해도 완료된 객체는 남을 수 있습니다. 재시도로 번호가 붙은 객체가 추가될 수 있으므로 버킷 내용과 보내려던 파일을 대조하세요.
연결 오류에는 무관한 설정을 바꾸기 전에 엔드포인트, 버킷, 리전, 자격 증명 범위를 재확인하세요. Actions 도구 모음과 가이드 목록은 업로드와 로컬 파일 정리를 구분하는 데 도움이 됩니다.
관련 링크
자주 묻는 질문
Yuzu가 버킷을 제공하나요?
아니요. Upload는 사용자가 제공하는 자격 증명으로 자신의 S3 호환 버킷에 연결합니다. 저장 요금과 접근 정책은 공급자 계정에 속합니다.
링크 대신 객체 키가 복사된 이유는 무엇인가요?
공개 URL 기준 주소를 설정하지 않으면 Yuzu는 객체 키를 복사합니다. 키만으로는 공개 다운로드 URL이 되지 않습니다.







