S3 Compatible¶
Любой сервис, реализующий S3 API, можно смонтировать как диск Windows. Поля подключения всегда одинаковы — URL конечной точки, ID ключа (Access Key ID), Секретный ключ доступа (Secret Access Key) и контейнер (bucket), — поэтому эта инструкция охватывает всё семейство S3.
Многие из этих сервисов представлены на вкладке Enterprise в RaiDrive отдельным вариантом со своим названием (Amazon S3, Cloudflare R2, Wasabi, Backblaze B2, …). Если такой вариант есть, выбирайте его — тогда RaiDrive сам знает шаблон конечной точки и список регионов. Для всего остального, включая собственные серверы, используйте универсальный вариант S3 Compatible.
Перед началом работы¶
Заранее подготовьте следующее:
- Access Key ID и Secret Access Key, выданные сервисом, — у каждого S3-совместимого сервиса есть страница управления ключами в собственной консоли; на страницах отдельных провайдеров в этом разделе точно указано, где она находится для каждого сервиса.
- URL конечной точки S3 сервиса (см. таблицу ниже).
- Некоторым сервисам нужен ещё один идентификатор — например, для Cloudflare R2 нужен Account ID, а для Oracle — пространство имён объектного хранилища.
Подключение¶
- Нажмите Добавить на панели инструментов.
- Выберите Enterprise → нужный сервис или S3 Compatible, если его нет в списке.
- Для универсального варианта введите URL конечной точки (и, если сервис этого требует, регион в поле Регион).
- Введите ID ключа (Access Key ID) и Секретный ключ доступа (Secret Access Key), затем нажмите кнопку Обновить рядом с полем контейнера.
- Выберите контейнер и нажмите Подключить.
Ввод контейнера вручную
Если ключу не разрешено получать список контейнеров, отметьте флажок слева от поля контейнера и введите имя контейнера вручную.
Справочник конечных точек¶
| Сервис | Шаблон конечной точки | Регионы |
|---|---|---|
| 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 endpoints and quotas |
| Backblaze B2 | https://s3.<region>.backblazeb2.com |
Where are the Backblaze Cloud Storage Data Centers |
| Ceph (собственный сервер) | URL вашего шлюза RADOS Gateway | — |
| 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 |
Endpoints and storage locations |
| 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 |
URL-адреса конечных точек MEGA S4 |
| MinIO (собственный сервер) | URL вашего сервера | — |
| Naver Cloud Platform | https://<region>.object.ncloudstorage.com — регион: kr, us, sg, de; jp: https://jp.object.ncpstorage.com |
Object Storage overview |
| 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 |
Regions and Access Endpoints |
| Wasabi | https://s3.<region>.wasabisys.com |
Service URLs for Wasabi's Storage Regions |
| Scaleway и другие | https://s3.<region>.scw.cloud — через универсальный вариант S3 Compatible |
Object Storage - Concepts |
Параметры¶
| Параметр | Описание | По умолчанию |
|---|---|---|
| Конечная точка | URL S3 API сервиса | — |
| Регион | Регион аутентификации; требуется некоторым сервисам (например, 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 |
| Список контейнеров пуст | Ключ не может получать список контейнеров | Ввести контейнер вручную |
| Ошибки подписи / авторизации | Сервису нужен явно указанный регион | Указать в поле "Регион" значение из консоли сервиса |
| Ошибки TLS на сервере в локальной сети | Самоподписанный сертификат при выборе варианта публичного сервиса | Использовать варианты для собственных серверов (MinIO/Cloudian/Ceph/Garage) или S3 Compatible |