Перейти к содержимому
Логотип Аурабаза
аурабаза

Хранилище

REST API для каждого проекта в хранилище S3 (SeaweedFS S3), преобразование изображений «на лету» с производным кешем, подписанные URL-адреса HMAC, общедоступные или частные корзины, удаление и восстановление.

Пояснение6 мин читатьУровень среднийПересмотрено 15 апр. 2026 г.

Эта страница была переведена автоматически. Английская версия является авторитетной.

Одна корзина, один источник, один CDN#

Служба aura-storage управляет вашими двоичными файлами: загрузка, скачивание, преобразование изображений, подписанные URL-адреса, мусор. Он предоставляет свой собственный REST API под /v1/storage/{project_id} и использует внутреннее хранилище S3 (SeaweedFS S3) — инструменты S3 (rclone, boto3) не подключаются к нему напрямую.

Объекты организованы в сегменты . У каждого сегмента есть политика (публичная или частная), ограничения на размер, необязательный TTL и набор политик RLS, которые контролируют, кто может читать/записывать каждый путь.

Информация

Метаданные находятся в схеме проекта: storage_buckets, storage_objects, storage_derivatives, storage_project_settings, storage_audit_log. Байты находятся в хранилище S3.

Путь → RLS → CDN → источник#

Во время чтения служба проверяет доступ к запрошенному пути, а затем обслуживает байты из хранилища. Если запрос содержит параметры преобразования, соответствующая производная используется повторно, если она уже существует, в противном случае вычисляется и затем кэшируется. При загрузке поток обратный: клиент → сервис → хранилище, после записи контроля и ограничений сегмента.

schematext
                              ┌──── derivative cache ────┐
   GET /v1/storage/{pid}/… ─▶ │ derivative cached?       │
                              │ no  ⇢ origin             │
                              └──────────┬───────────────┘
                                         │
                              ┌──────────▼───────────────┐
                              │ aura-storage             │
                              │  ─ access control        │
                              │  ─ transforms            │
                              │  ─ derivative cache      │
                              └──────────┬───────────────┘
                                         │
                                  S3 storage (SeaweedFS S3)

Шесть врожденных способностей#

  • REST API для каждого проекта. Маршруты /v1/storage/{project_id}/… в хранилище S3 (SeaweedFS S3) — это не API S3: SDK S3 к нему не подключаются.
  • Преобразование на лету. ширина, высота, размер, формат (jpeg/png/webp/gif), качество, поворот, переворот. Каждая комбинация кэшируется как производная.
  • Подписанные URL-адреса. HMAC подпись метода + сегмент + ключ + срок действия. TTL 3600 с по умолчанию, секретная ротация для каждого проекта.
  • Многочастная загрузка. Простая загрузка в формате multipart/form-data или init/part/complete для больших файлов.
  • Корзина и восстановление. Мягкое удаление: /trash выводит список удаленных объектов, /restore/{key} восстанавливает их.
  • Публичные или частные сегменты. Корзина содержит политику доступа, ограничения на размер и список авторизованных типов MIME.

Четыре основные операции#

avatar.tstypescript
const { data, error } = await aura.storage.upload('avatars', `${user.id}/${file.name}`, file, {
    contentType: file.type,
    upsert: true,
})

// Без upsert уже занятый путь терпит неудачу в 409 (код КОНФЛИКТА).
Совет

URL-адреса преобразования являются неизменяемыми по параметрам. ?width=240&format=png и ?width=240&format=webp — это два разных URL-адреса, следовательно, две разные производные: каждая комбинация вычисляется только один раз, а затем пересчитывается из производного кэша.

RLS на путях объектов#

Метаданные объекта находятся в таблице storage_objects схемы проекта (столбцы bucket_name, key, owner_id, metadata, deleted_at), при этом RLS включен. Не существует ни схемы storage, ни функции storage.foldername(): политики записываются в столбцах.

политики предоставляются по умолчаниюsql
-- Чтение: собственный объект или любой объект из общедоступной корзины.
create policy storage_objects_select on storage_objects for select
  using (
    owner_id = auth.uid()
    or exists (select 1 from storage_buckets b
                  where b.name = storage_objects.bucket_name and b.public)
  );

-- Написание: только свои объекты
create policy storage_objects_insert on storage_objects for insert
  with check (owner_id = auth.uid());

Чтобы пойти дальше#