약 5분
모든 S3 호환 스토리지에 파일을 업로드하는 방법
Aktar는 Amazon S3 API를 구현한 모든 제공업체와 함께 쓸 수 있습니다. 기타 S3 호환 서비스를 고르고 제공업체의 엔드포인트, 리전, 키를 입력하세요. 대표적인 예:
- Wasabi:
https://s3.<region>.wasabisys.com, 예:s3.eu-central-1.wasabisys.com - Hetzner Object Storage:
https://<location>.your-objectstorage.com, 예:fsn1.your-objectstorage.com - Scaleway:
https://s3.<region>.scw.cloud, 예:s3.fr-par.scw.cloud - Akamai(Linode):
https://<region>.linodeobjects.com
준비물
- S3 호환 제공업체 계정
- Mac에 설치된 Aktar
단계별 안내
- 1
버킷 만들기
제공업체 콘솔에서 버킷을 만들고 리전이나 위치(예:
eu-central-1,fsn1,fr-par)를 적어 둡니다. - 2
공개 읽기 허용하기
제공업체의 버킷 공개 설정이나
s3:GetObject를 허용하는 버킷 정책으로 버킷의 객체를 공개적으로 읽을 수 있게 합니다. Aktar는 파일별 권한을 설정하지 않으므로 버킷에서 설정해야 합니다. - 3
액세스 키 만들기
버킷에 대한 읽기 및 쓰기 권한이 있는 S3 액세스 키와 비밀 키를 만듭니다.
- 4
Aktar에 대상 추가하기
설정 → 대상 → 대상 추가에서 기타 S3 호환 서비스를 고르고 아래 값을 입력합니다. 이 프리셋은 가상 호스팅 스타일 URL(
bucket.endpoint)을 씁니다. 서버가 경로 스타일 URL만 지원한다면 대신 MinIO 프리셋을 고르세요. - 5
테스트하고 저장하기
연결 테스트를 클릭한 다음 저장을 클릭합니다.
Aktar 설정 값
설정 → 대상 → 대상 추가에서 다음 값을 입력하세요. 항목 이름은 앱과 같습니다.
| 항목 | 예시 값 |
|---|---|
| 제공업체 | 기타 S3 호환 서비스 |
| 엔드포인트 | https://fsn1.your-objectstorage.com제공업체의 S3 엔드포인트. |
| 리전 | fsn1버킷의 리전 또는 위치. |
| 액세스 키 ID | … |
| 비밀 액세스 키 | •••••••• |
| 버킷 | your-bucket |
| 공개 기본 URL | your-bucket.fsn1.your-objectstorage.com또는 버킷 앞에 둔 CDN이나 사용자 도메인. |
팁
- 고른 리전의 정확한 엔드포인트는 제공업체 문서에서 확인하세요.
- 제공업체가 CDN이나 사용자 도메인을 지원한다면 그 주소를 공개 기본 URL로 쓰세요.
문제 해결
연결 테스트가 버킷에 접근하지 못해요
엔드포인트와 리전을 다시 확인하세요. 제공업체가 경로 스타일 URL만 지원한다면 프리셋을 MinIO로 바꾸세요.
링크를 열면 403이 나와요
버킷이 아직 공개 읽기를 허용하지 않습니다. Access Denied 오류를 참고하세요.
아직 해결되지 않았나요?FAQ를 살펴보거나 GitHub에서 물어보세요.