약 5분
Backblaze B2에 파일을 업로드하고 링크를 공유하는 방법
Backblaze B2는 저렴한 S3 호환 객체 스토리지입니다. Aktar의 Backblaze B2 프리셋은 애플리케이션 키를 사용해 B2의 S3 호환 API로 연결합니다.
준비물
- B2 Cloud Storage를 쓰는 Backblaze 계정
- Mac에 설치된 Aktar
단계별 안내
- 1
공개 버킷 만들기
Backblaze 웹 앱에서 Buckets → Create a Bucket으로 이동해 고유한 이름을 고르고, Files in Bucket are를 Public으로 설정합니다.
버킷 목록에 표시되는 버킷의 Endpoint(예:
s3.us-west-004.backblazeb2.com)를 적어 두세요.s3.뒷부분(us-west-004)이 리전입니다. - 2
애플리케이션 키 만들기
Application Keys → Add a New Application Key를 열고, 해당 버킷에만 Read and Write 접근을 허용합니다. keyID와 applicationKey를 복사하세요. 키는 한 번만 표시됩니다.
- 3
공개 URL 찾기
웹 앱에서 아무 파일이나 업로드하고 세부 정보를 엽니다. Friendly URL은
https://f004.backblazeb2.com/file/your-bucket/test.png같은 형태입니다. 파일 이름 앞부분 전체, 즉https://f004.backblazeb2.com/file/your-bucket이 공개 기본 URL입니다.B2 앞에 CDN이나 사용자 도메인을 두었다면 그 주소를 쓰세요.
- 4
Aktar에 대상 추가하기
설정 → 대상 → 대상 추가에서 Backblaze B2를 고르고 아래 값을 입력합니다.
- 5
테스트하고 저장하기
연결 테스트를 클릭한 다음 저장을 클릭합니다.
Aktar 설정 값
설정 → 대상 → 대상 추가에서 다음 값을 입력하세요. 항목 이름은 앱과 같습니다.
| 항목 | 예시 값 |
|---|---|
| 제공업체 | Backblaze B2 |
| 엔드포인트 | https://s3.us-west-004.backblazeb2.com버킷 목록에서 확인합니다. |
| 리전 | us-west-004엔드포인트의 가운데 부분. |
| 액세스 키 ID | 004a1b2c3d…keyID. |
| 비밀 액세스 키 | ••••••••applicationKey. |
| 버킷 | your-bucket |
| 공개 기본 URL | https://f004.backblazeb2.com/file/your-bucket버킷 이름을 포함합니다. |
팁
- 애플리케이션 키는 버킷 하나로만 제한하세요.
- B2 앞에 사용자 도메인을 붙인 CDN을 두면 링크가 짧아지고 캐싱도 됩니다.
문제 해결
링크를 열면 401이나 403이 나와요
버킷이 비공개 상태입니다. Files in Bucket are를 Public으로 설정하고, 공개 기본 URL에 /file/your-bucket이 들어 있는지 확인하세요. Access Denied 오류를 참고하세요.
연결 테스트에서 자격 증명이 유효하지 않다고 나와요
keyID는 액세스 키 ID에, applicationKey는 비밀 액세스 키에 넣고, 엔드포인트의 리전이 버킷과 일치하는지 확인하세요.
아직 해결되지 않았나요?FAQ를 살펴보거나 GitHub에서 물어보세요.