S3 Compatible¶
S3 API를 구현한 서비스라면 무엇이든 Windows 드라이브로 마운트할 수 있습니다. 연결 항목은 항상 같습니다 — 엔드포인트 URL, 엑세스 키 ID, 비밀 엑세스 키, 버킷 — 그래서 이 가이드 하나가 S3 계열 전체를 다룹니다.
이들 서비스 상당수는 RaiDrive Enterprise 탭에 전용 항목(Wasabi, Backblaze B2, Cloudflare R2 등)이 있습니다. 전용 항목이 있으면 그것을 씁니다 — RaiDrive가 엔드포인트 형식과 리전 목록을 알고 있습니다. 그 외 서비스와 자체 구축 서버는 범용 S3 Compatible 항목을 사용합니다.
시작하기 전에¶
다음을 미리 준비하세요:
- 서비스가 발급한 엑세스 키 ID와 비밀 엑세스 키 — 모든 S3 호환 서비스는 자체 콘솔에 키 관리 페이지가 있으며, 전용 항목이 있는 서비스는 이 섹션의 해당 페이지에 정확한 위치가 안내되어 있습니다.
- 서비스의 S3 엔드포인트 URL (아래 표 참고).
- 일부 서비스는 식별자가 하나 더 필요합니다 — 예: Cloudflare R2는 Account ID, Oracle은 오브젝트 스토리지 네임스페이스.
연결¶
- 툴바에서 추가를 클릭합니다.
- Enterprise → 전용 항목, 또는 목록에 없으면 S3 Compatible을 선택합니다.
- 범용 항목이면 엔드포인트 URL(서비스가 요구하면 리전도)을 입력합니다.
- 엑세스 키 ID와 비밀 엑세스 키를 입력하고 버킷 입력란 옆 새로 고침 버튼을 클릭합니다.
- 버킷을 선택하고 연결을 클릭합니다.
버킷 직접 입력
키에 버킷 나열 권한이 없으면, 버킷 입력란 왼쪽 체크박스를 켜고 버킷 이름을 직접 입력합니다.
엔드포인트 레퍼런스¶
| 서비스 | 엔드포인트 형식 |
|---|---|
| Wasabi | https://s3.<region>.wasabisys.com |
| Backblaze B2 | https://s3.<region>.backblazeb2.com |
| Cloudflare R2 | https://<account-id>.r2.cloudflarestorage.com |
| Storj | https://gateway.storjshare.io (전역 단일 엔드포인트) |
| DigitalOcean Spaces | https://<region>.digitaloceanspaces.com |
| Oracle Cloud | https://<namespace>.compat.objectstorage.<region>.oraclecloud.com |
| IBM Cloud | https://s3.<region>.cloud-object-storage.appdomain.cloud |
| Alibaba Cloud | https://oss-<region>.aliyuncs.com |
| Tencent Cloud | https://cos.<region>.myqcloud.com |
| Naver Cloud Platform | https://<region>.object.ncloudstorage.com — 리전: kr, us, sg, jp, de |
| Synology C2 | https://object.<region>.c2.synology.com |
| IDrive e2 | https://<host>.<region>.idrivee2-XX.com (e2 콘솔에 표시) |
| Akamai Linode | https://<region>.linodeobjects.com |
| IONOS | https://s3.<region>.ionoscloud.com |
| DreamHost | https://objects-us-east-1.dream.io 또는 https://s3.us-east-005.dream.io (클러스터별) |
| Leviia | https://s3.<region>.leviia.com |
| MEGA S4 | https://s3.<region>.s4.mega.io |
| MinIO (자체 구축) | 내 서버 URL |
| Cloudian (자체 구축) | 내 서버 URL |
| Ceph (자체 구축) | 내 RADOS Gateway URL |
| Garage (자체 구축) | 내 서버 URL |
| Scaleway 등 | https://s3.<region>.scw.cloud — 범용 S3 Compatible 항목으로 |
설정¶
| 설정 | 설명 | 기본값 |
|---|---|---|
| 엔드포인트 | 서비스의 S3 API URL | — |
| 리전 | 인증 리전; 일부 서비스(예: Garage, Scaleway)에서 필수 | 비어 있음 |
| 엑세스 키 ID / 비밀 엑세스 키 | 서비스가 발급한 자격증명 | — |
| 버킷 | 마운트할 버킷 (목록 또는 직접 입력) | — |
| 읽기전용 | 드라이브 쓰기 차단 | 꺼짐 |
동작과 제한¶
- RaiDrive는 스스로를 식별하는 서버의 엔드포인트를 검증합니다: MinIO, Cloudian, Ceph, Garage는 서버 응답으로, IDrive e2, Akamai Linode, Synology C2는 호스트명 형식으로 확인합니다. 어긋난 엔드포인트는 "invalid endpoint"로 거부됩니다.
- 자체 구축 서버(MinIO, Cloudian, Ceph, Garage)는 path-style로 접근하며 사설·자체 서명 TLS 인증서를 허용합니다.
- S3 특성은 어디서나 같습니다: 실제 폴더가 없고 "폴더"는 키 접두사이므로, 큰 폴더 트리의 이름 변경은 접두사 아래 오브젝트 전체의 복사+삭제입니다 — AWS: 폴더로 오브젝트 정리 참고합니다.
문제 해결¶
| 증상 | 원인 | 조치 |
|---|---|---|
| "invalid endpoint" | 선택한 서비스와 엔드포인트 불일치 | 표의 형식 확인 또는 범용 S3 Compatible 항목 사용 |
| 버킷 목록이 비어 있음 | 키가 버킷 나열 불가 | 버킷 직접 입력 |
| 서명/인가 오류 | 서비스가 명시적 리전 요구 | 서비스 콘솔의 값으로 리전 입력 |
| LAN 서버에서 TLS 오류 | 전용 공개 서비스 항목에 자체 서명 인증서 | 자체 구축 항목(MinIO/Cloudian/Ceph/Garage) 또는 S3 Compatible 사용 |