본문으로 건너뛰기
아우라베이스 로고
아우라베이스

저장

S3 스토리지(SeaweedFS S3)의 프로젝트별 REST API, 파생 캐시를 사용한 즉각적인 이미지 변환, HMAC 서명된 URL, 공개 또는 비공개 버킷, 휴지통 및 복원.

설명6분 읽기레벨 중급2026. 4. 15.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

하나의 버킷, 하나의 오리진, 하나의 CDN#

aura-storage 서비스는 업로드, 다운로드, 이미지 변환, 서명된 URL, 휴지통 등 바이너리 파일을 관리합니다. /v1/storage/{project_id} 아래에 자체 REST API를 노출하고 내부적으로 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)

6가지 기본 능력#

  • 프로젝트당 REST API. 라우팅 /v1/storage/{project_id}/… S3 스토리지(SeaweedFS S3) — 이는 S3 API가 아닙니다. S3 SDK는 여기에 연결되지 않습니다.
  • 즉시 변환됩니다. 너비, 높이, 맞춤, 형식(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(CONFLICT 코드)에서 실패합니다.
팁

변환 URL은 매개변수에 따라 변경할 수 없습니다. ?width=240&format=png 및 ?width=240&format=webp은 두 개의 서로 다른 URL이므로 두 개의 서로 다른 파생물입니다. 각 조합은 한 번만 계산된 다음 파생 캐시에서 다시 읽혀집니다.

개체 경로의 RLS#

개체 메타데이터는 RLS가 활성화된 프로젝트 스키마의 storage_objects 테이블(열 bucket_name, key, owner_id, metadata, deleted_at)에 있습니다. 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());

더 나아가려면#