S3 Compatible¶
S3 API를 구현한 서비스라면 무엇이든 Windows 드라이브로 마운트할 수 있습니다. 연결 항목은 항상 같습니다 — 엔드포인트 URL, 액세스 키 ID, 비밀 액세스 키, 버킷 — 그래서 이 가이드 하나가 S3 계열 전체를 다룹니다.
이들 서비스 상당수는 RaiDrive Enterprise 탭에 전용 항목(Amazon S3, Cloudflare R2, Wasabi, Backblaze B2 등)이 있습니다. 전용 항목이 있으면 그것을 씁니다 — RaiDrive가 엔드포인트 형식과 리전 목록을 알고 있습니다. 그 외 서비스와 자체 구축 서버는 범용 S3 Compatible 항목을 사용합니다.
시작하기 전에¶
다음을 미리 준비하세요:
- 서비스가 발급한 액세스 키 ID와 비밀 액세스 키 — 모든 S3 호환 서비스는 자체 콘솔에 키 관리 페이지가 있으며, 전용 항목이 있는 서비스는 이 섹션의 해당 페이지에 정확한 위치가 안내되어 있습니다.
- 서비스의 S3 엔드포인트 URL (아래 표 참고).
- 일부 서비스는 식별자가 하나 더 필요합니다 — 예: Cloudflare R2는 계정 ID, Oracle은 오브젝트 스토리지 네임스페이스.
연결¶
- 툴바에서 추가를 클릭합니다.
- Enterprise → 전용 항목, 또는 목록에 없으면 S3 Compatible을 선택합니다.
- 범용 항목이면 엔드포인트 URL(서비스가 요구하면 리전도)을 입력합니다.
- 액세스 키 ID와 비밀 액세스 키를 입력하고 버킷 입력란 옆 새로 고침 버튼을 클릭합니다.
- 버킷을 선택하고 연결을 클릭합니다.
버킷 직접 입력
키에 버킷 나열 권한이 없으면, 버킷 입력란 왼쪽 체크박스를 켜고 버킷 이름을 직접 입력합니다.
엔드포인트 레퍼런스¶
| 서비스 | 엔드포인트 형식 | 리전 |
|---|---|---|
| Akamai Linode | https://<region>.linodeobjects.com |
Use URLs for access |
| Alibaba Cloud | https://oss-<region>.aliyuncs.com |
Regions and endpoints |
| Amazon S3 | https://s3.<region>.amazonaws.com |
Amazon Simple Storage Service 엔드포인트 및 할당량 |
| Backblaze B2 | https://s3.<region>.backblazeb2.com |
Where are the Backblaze Cloud Storage Data Centers |
| Ceph (자체 구축) | 내 RADOS Gateway URL | — |
| Cloudflare R2 | https://<account-id>.r2.cloudflarestorage.com |
Data location |
| Cloudian (자체 구축) | 내 서버 URL | — |
| DigitalOcean Spaces | https://<region>.digitaloceanspaces.com |
Spaces Availability |
| DreamHost | https://objects-us-east-1.dream.io 또는 https://s3.us-east-005.dream.io (클러스터별) |
What DreamObjects hostname should I use to connect? |
| Garage (자체 구축) | 내 서버 URL | — |
| IBM Cloud | https://s3.<region>.cloud-object-storage.appdomain.cloud |
엔드포인트 및 스토리지 위치 |
| IDrive e2 | https://<host>.<region>.idrivee2-XX.com (e2 콘솔에 표시) |
리전 엔드포인트 |
| IONOS | https://s3.<region>.ionoscloud.com |
Endpoints |
| Leviia | https://s3.<region>.leviia.com |
— |
| MEGA S4 | https://s3.<region>.megas4.com |
MEGA S4 endpoint URLs |
| MinIO (자체 구축) | 내 서버 URL | — |
| Naver Cloud Platform | https://<region>.object.ncloudstorage.com — 리전: kr, us, sg, de; jp: https://jp.object.ncpstorage.com |
Object Storage 개요 |
| Oracle Cloud | https://<namespace>.compat.objectstorage.<region>.oraclecloud.com |
Regions and Availability Domains |
| Storj | https://gateway.storjshare.io (전역 단일 엔드포인트) |
Storj-hosted S3 Compatible Gateway |
| Synology C2 | https://<region>.s3.synologyc2.net |
C2 Object Storage에서 개발 도구를 사용하는 방법 |
| Tencent Cloud | https://cos.<region>.myqcloud.com |
리전 및 액세스 도메인 |
| Wasabi | https://s3.<region>.wasabisys.com |
Service URLs for Wasabi's Storage Regions |
| Scaleway 등 | https://s3.<region>.scw.cloud — 범용 S3 Compatible 항목으로 |
Object Storage - Concepts |
설정¶
| 설정 | 설명 | 기본값 |
|---|---|---|
| 엔드포인트 | 서비스의 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 사용 |