저장
S3 스토리지(SeaweedFS S3)의 프로젝트별 REST API, 파생 캐시를 사용한 즉각적인 이미지 변환, HMAC 서명된 URL, 공개 또는 비공개 버킷, 휴지통 및 복원.
하나의 버킷, 하나의 오리진, 하나의 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 → 원본#
읽는 동안 서비스는 요청된 경로에 대한 액세스를 확인한 다음 스토리지에서 바이트를 제공합니다. 쿼리에 변환 매개변수가 있는 경우 해당 파생 항목이 이미 존재하면 재사용되고, 그렇지 않으면 계산된 후 캐시됩니다. 업로드에서는 제어 및 버킷 제한을 작성한 후 클라이언트 → 서비스 → 스토리지 흐름이 반대입니다.
┌──── 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 유형 목록을 전달합니다.
네 가지 기본 작업#
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() 함수는 없습니다. 정책은 열에 기록됩니다.
-- 읽기: 자신의 객체 또는 공용 버킷의 객체
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());