S3 Compatible¶
Любой сервис, реализующий S3 API, можно смонтировать как диск Windows. Поля подключения всегда одинаковы — URL конечной точки, ID ключа (Access Key ID), Ключ доступа (Secret Access Key) и контейнер (bucket), — поэтому эта инструкция охватывает всё семейство S3.
Многие из этих сервисов представлены на вкладке Enterprise в RaiDrive отдельным вариантом со своим названием (Wasabi, Backblaze B2, Cloudflare R2, …). Если такой вариант есть, выбирайте его — тогда 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), затем нажмите кнопку Обновить рядом с полем контейнера.
- Выберите контейнер и нажмите Подключить.
Ввод контейнера вручную
Если ключу не разрешено получать список контейнеров, отметьте флажок слева от поля контейнера и введите имя контейнера вручную.
Справочник конечных точек¶
| Сервис | Шаблон конечной точки |
|---|---|
| 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 (собственный сервер) | URL вашего шлюза RADOS Gateway |
| Garage (собственный сервер) | URL вашего сервера |
| Scaleway и другие | https://s3.<region>.scw.cloud — через универсальный вариант S3 Compatible |
Параметры¶
| Параметр | Описание | По умолчанию |
|---|---|---|
| Конечная точка | 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 |