Как использовать S3-хранилище?

Вы можете хранить файлы в облачном хранилище S3. Для этого потребуется дополнительное программное обеспечение, так называемый S3-клиент. 

Для начала работы с хранилищем создайте в личном кабинете пользователя S3, либо реквизиты для подключения

Создание пользователя S3 и реквизитов для подключения

  • Пользователь создается в разделе S3 пользователи. Здесь нужно указать S3 ID и имя пользователя (можно указать любые). После добавления пользователя станут доступны access_key и secret_key.
  • Реквизиты для входа создаются в разделе Реквизиты для входа. Все поля будут заполнены автоматически, нажмите «Сохранить». Теперь вам доступны Access и Secret.

Для подключения и работы с хранилищем вы можете использовать любой удобный клиент S3, например — S3 Browser.

Настройка S3 Browser

  • Создайте нового пользователя в меню Accounts -> Add new account

Далее необходимо заполнить поля на странице нового пользователя

  • Display Name -> введите любое имя. Оно отображается локально.
  • Account Type -> S3 compatible storage.
  • Rest Endpoint -> https://api.immers.cloud:8080.
  • Access key ID -> access_key из пользователя или Access из реквизитов.
  • Secret Access Key -> secret_key из пользователя или Secret из реквизитов.
  • Advanced Settings -> Addressing Model -> Path Style -> Close.
  • Далее -> Add new account.
  • Готово. Можно создавать корзины (buckets) и загружать файлы.

Корзины отображаются на сайте в разделе Корзины.

Вы можете отслеживать ваши действия с корзинами в разделе Операции.

Настройка s3cmd для доступа к S3

На данном этапе у вас должны существовать Access key и Secret key.

  1. Запустите s3cmd --configure
  2. Введите значения ваших ключей:
  • Access key
  • Secret key
  • S3 Endpoint: api.immers.cloud:8080 
  • DNS-style bucket+hostname:port template for accessing a bucket: %.api.immers.cloud:8080 
  • Use HTTPS protocol [Yes]: Yes
  • Остальные параметры можно оставить по умолчанию, сохраните конфигурацию.

Список основных команд s3cmd:

  • Создание новой корзины test1: s3cmd mb s3://test (название должно состоять из строчных букв)
  • Просмотр существующих корзин: s3cmd ls
  • Загрузка произвольного файла в корзину: s3cmd put file.zip s3://test/file.zip
  • Просмотр информации о корзине или объекте: s3cmd info s3://test/file.zip
  • Узнать размер корзины или объекта: s3cmd du s3://test/file.zip
  • Удаление объекта (файла) из корзины: s3cmd rm s3://test/file.zip
  • Удаление корзины вместе с содержимым: s3cmd rb s3://test -r
Дата обновления 28.11.2025