supabase-storage-guide
Installation
SKILL.md
Supabase Storage Guide
이미지 업로드, Storage 버킷 관리, Signed URL 패턴을 위한 가이드.
핵심 원칙
- 지연 업로드 패턴: DB 저장 성공 후 이미지 업로드 (데이터 무결성 보장)
- 메모리 기반 처리: 업로드 전 Buffer로 처리하여 불필요한 Storage 사용 방지
- 에러 격리: 이미지 업로드 실패가 핵심 데이터 저장을 막지 않음
- 버킷 분리: 용도별 Storage 버킷 구분 (public/private)
- 보안: Private 파일은 Signed URL로 시간 제한 접근
Storage 버킷 설계
| 버킷 유형 | 접근 권한 | 용도 | 접근 방법 |
|---|---|---|---|
| Public | 공개 | 공개 이미지, 썸네일 | getPublicUrl() |
| Private | 비공개 | 개인 문서, 민감 파일 | createSignedUrl() |