С какими инструментами оно совместимо?

API S3-совместимый, поэтому работают привычные инструменты: aws-cli, s3cmd, rclone, MinIO Client и SDK для Python, Node.js, Go, PHP. Достаточно указать в конфигурации адрес эндпоинта платформы вместо адреса Amazon.

Как считается оплата?

По объёму: вы платите за реально занятое место и трафик, а не за фиксированный тариф диска. Пустой бакет не стоит ничего, а расход растёт вместе с реальными данными.

Где взять ключи доступа?

Access key и secret key выдаются в панели по запросу — они лежат в отдельном секрете подключения. Класть их в репозиторий не нужно: в приложение они попадают переменными окружения.

Можно ли раздавать файлы напрямую пользователям?

Да. Публичные объекты отдаются по прямой ссылке, приватные — по временной подписанной ссылке с ограниченным сроком жизни. Второй вариант используют для документов и всего, что не должно индексироваться поисковиками.

Подходит ли хранилище для бэкапов баз данных?

Да, это основной сценарий. Дампы управляемого PostgreSQL складываются в бакет, а скачать их можно по временной ссылке из панели. Хранение бэкапов отдельно от самой базы — правило, которое спасает при потере инстанса.

Где физически лежат данные?

На серверах в России. Если приложение хранит файлы пользователей-россиян, это тот же вопрос 152-ФЗ, что и с базой данных: про базу помнят все, про загруженные файлы — почти никто.

Есть ли ограничение на размер файла?

Крупные файлы загружаются составной загрузкой (multipart upload), которую поддерживают все совместимые клиенты, — так же, как в любом S3-хранилище. Для отдачи больших медиафайлов это штатный режим, а не обходной путь.

Можно ли смонтировать бакет как диск приложения?

Нет, и это осознанно. Хранилище работает по HTTP-протоколу S3: приложение обращается к нему клиентом, а не через файловую систему. Нужен именно диск, который виден как каталог, — для приложения подключается постоянный том, это отдельный ресурс.

Что происходит с файлами при пересборке приложения?

Ничего: объекты в бакете живут отдельно от контейнера. Именно поэтому загрузки пользователей и складывают в хранилище — локальный диск контейнера стирается при каждой сборке, и всё, что лежало рядом с кодом, исчезает вместе с ним.

Как перенести файлы из другого S3?

Через rclone или aws-cli: указываете два эндпоинта и синхронизируете бакеты напрямую, скачивать всё к себе на ноутбук не нужно. Протокол одинаковый, поэтому перенос — это одна команда и время на трафик.

Beta

Объектное хранилище S3

S3-совместимое хранилище для бэкапов, медиа и статики. Сейчас в статусе Beta — часть возможностей ещё дорабатывается.

Создать аккаунт Подробнее

Возможности хранилища

S3-совместимый API

Тот же протокол, что у Amazon S3: работают aws-cli, s3cmd, rclone, MinIO Client и любые SDK — boto3, aws-sdk-js, minio-go. В коде меняется только адрес эндпоинта и ключи, остальная логика загрузки и раздачи файлов остаётся как была.

Оплата за объём

Считается реально занятое место и трафик, а не размер купленного диска. Для проекта, у которого нагрузка растёт неравномерно, это дешевле фиксированного тарифа: вы не оплачиваете пустое место «на вырост».

Ключи доступа выдаются по запросу

Access key и secret key лежат в отдельном секрете и показываются в панели по требованию, а не хранятся в репозитории. Скомпрометированный ключ отзывается пересозданием секрета, без правок кода приложения.

Данные в России

Бакеты живут на серверах в РФ. Для проектов, которые хранят пользовательские файлы — документы, сканы, аватарки — это то же требование 152-ФЗ, что и для баз данных, только про файлы про него часто забывают.

Бэкапы приложений и баз

Хранилище — типовое место для дампов Postgres и архивов сборок. Резервные копии баз выгружаются в бакет и скачиваются по временной ссылке, отдельный файловый сервер под это поднимать не нужно.

Раздача статики и медиа

Картинки, видео и загруженные пользователями файлы отдаются напрямую из хранилища, не занимая диск и память самого приложения. Приложение остаётся stateless, и его можно перезапускать и масштабировать без риска потерять файлы.

Как начать хранить файлы в S3

Четыре шага до первого объекта в бакете.

Создайте бакет

Имя, проект и режим доступа: публичный для статики или приватный для документов. Бакет разворачивается на серверах в РФ.

Получите ключи

Access key и secret key показываются в панели по запросу — они лежат в отдельном секрете подключения, а не в репозитории. В приложение попадают переменными окружения.

Подставьте эндпоинт в клиент

В boto3, aws-sdk-js, minio-go, rclone или aws-cli меняется только адрес эндпоинта и ключи. Остальной код загрузки и раздачи файлов остаётся как был: протокол тот же, что у Amazon S3.

Отдавайте файлы напрямую

Публичные объекты доступны по прямой ссылке, приватные — по временной подписанной. Приложение перестаёт держать файлы на своём диске и остаётся stateless: его можно перезапускать и масштабировать без риска потерять загрузки.

Что обычно кладут в хранилище

Четыре типовых сценария, с которых начинают почти все проекты.

Загрузки пользователей

Аватарки, документы, сканы, вложения. Локальный диск контейнера стирается при каждой сборке, поэтому единственное надёжное место для пользовательских файлов — объектное хранилище.

Бэкапы баз данных

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

Статика и медиа

Картинки, видео и собранные ассеты отдаются из хранилища, не занимая память приложения. Трафик на тяжёлые файлы не упирается в лимиты одного контейнера.

Артефакты сборок и отчёты

Архивы релизов, экспорты и выгрузки для аналитики. Оплата идёт за реально занятое место, поэтому редко используемые архивы не тянут за собой фиксированный тариф диска.

Что учесть до переезда файлов

Хранилище в статусе Beta — вот честный список ограничений.

Beta означает Beta

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

CDN пока не встроен

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

Версионирования объектов нет

Перезапись объекта заменяет его. Если нужна история версий файла, храните её ключами с датой или отдельными бакетами — восстановить перезаписанный объект платформа не сможет.

Ключи дают доступ ко всему бакету

Гранулярные политики уровня Amazon IAM пока не поддерживаются. Разграничивать доступ проще отдельными бакетами под разные задачи: публичная статика, приватные документы, бэкапы.

Трафик считается

Оплата идёт за занятое место и трафик. Раздача тяжёлого видео напрямую пользователям — рабочий сценарий, но её стоит посчитать заранее, а не обнаружить в счёте.

Вопросы об объектном хранилище

В статусе Beta. Создание S3-совместимых бакетов работает, часть возможностей ещё дорабатывается. Не закладывайте его в критичные сценарии, пока хранилище не вышло из беты — для бэкапов и статики оно уже пригодно, для единственной копии важных данных пока нет.

Руководство: объектное хранилище S3 Управляемый PostgreSQL Свой сервер — под управлением. Или закажите новый Простые и прозрачные цены

Поднимите backend из GitHub сегодня

Подключение репозитория занимает минуту. Платите только за то, что реально потребляете.

Создать аккаунт