Supabase Storage 공개 버킷 확인하는 법 — 고객 서류가 링크만 알면 열리는지
고객이 올린 사업자등록증이나 신분증 사본이 공개 버킷에 있으면 주소를 아는 사람은 로그인 없이 열 수 있습니다. 로그아웃하고 주소를 다시 열어 보는 확인법과, 비공개 버킷으로 옮기는 순서.
Supabase Storage 의 공개(public) 버킷에 올라간 파일은 주소를 아는 사람이면 누구나 로그인 없이 열 수 있습니다. 고객이 올린 서류(사업자등록증, 신분증 사본, 계약서)가 공개 버킷에 있다면, 카톡으로 한 번 전달된 링크만으로도 다른 사람이 볼 수 있습니다. 확인은 파일 하나 올려 보고 로그아웃한 다음 그 주소를 다시 열어 보면 됩니다.
공개 버킷과 비공개 버킷
Supabase Storage 는 파일을 버킷이라는 폴더 단위로 나눠 담습니다. 버킷마다 공개·비공개를 정합니다.
| 공개 버킷 | 비공개 버킷 | |
|---|---|---|
| 파일 열기 | 주소만 알면 누구나 | 권한 있는 사람만 (로그인 + 정책) |
| 올리기·지우기 | 정책(RLS)으로 막음 | 정책(RLS)으로 막음 |
| 주소 모양 | /storage/v1/object/public/... | /storage/v1/object/sign/...?token=... (만료되는 링크) |
| 어울리는 파일 | 상품 사진, 로고, 블로그 이미지 | 고객 서류, 영수증, 개인 사진 |
Supabase 문서에는 공개 버킷의 파일은 “주소를 가진 사람은 누구나 열 수 있다”고 적혀 있습니다. 올리기·지우기는 공개 버킷이어도 정책으로 막히지만, 열어 보는 건 막히지 않습니다.
버킷은 처음 만들 때 비공개가 기본입니다. 그런데 만들면서 공개로 켜 두거나, AI 에게 “업로드한 이미지가 안 보여요” 하고 고쳐 달라고 했을 때 버킷을 공개로 바꾸는 쪽으로 해결할 수 있습니다. 상품 사진이면 괜찮지만, 같은 버킷에 고객 서류까지 담기면 문제가 됩니다.
확인하는 법 (2분)
- 내 사이트에서 파일을 하나 올립니다 (아무 이미지나)
- 올린 파일을 열고, 주소창의 주소를 복사해 둡니다. 화면 안에서 열린다면 이미지를 오른쪽 클릭해서 “이미지 주소 복사”
- 로그아웃하거나 시크릿 창을 엽니다
- 복사한 주소를 붙여 넣습니다
결과는 셋 중 하나입니다.
- 로그인하라고 나오거나 안 열린다 → 괜찮습니다
- 열리는데 주소에
token=이 있다 → 만료되는 링크(서명 URL)입니다. 시간이 지나면 안 열리는지 다음 날 한 번 더 열어 봅니다 - 그대로 열리고 주소에
/object/public/이 있다 → 공개 버킷입니다. 이 주소를 아는 사람은 누구나 볼 수 있습니다

Supabase 대시보드에서도 볼 수 있습니다. Storage 메뉴의 버킷 목록에서 버킷 이름 옆에 Public 표시가 있으면 공개 버킷입니다.
고객 서류가 공개 버킷에 있다면
- 비공개 버킷을 새로 만듭니다 (예:
documents) - 그 버킷에 정책을 겁니다. 보통은 “로그인한 사용자가 자기 폴더의 파일만 읽고 올릴 수 있게” 입니다
- 업로드 코드를 새 버킷으로 바꾸고, 화면에 보여 줄 때는 만료되는 링크(
createSignedUrl)를 쓰게 바꿉니다 - 이미 올라간 서류를 새 버킷으로 옮기고, 공개 버킷에서는 지웁니다
- 1번 확인을 다시 합니다
기존 공개 버킷을 비공개로 바로 바꾸면, 상품 사진처럼 공개여야 하는 파일까지 같이 안 보이게 됩니다. 그래서 서류만 새 버킷으로 나누는 쪽이 안전합니다.
AI 에게 맡길 때는 이렇게 붙여 넣으면 됩니다.
고객 서류를 담을 비공개 Supabase Storage 버킷을 만들어 주세요. 로그인한 사용자가 자기 폴더(user id)의 파일만 읽고 올릴 수 있게 storage.objects 에 RLS 정책을 걸고, 화면에 보여 줄 때는 createSignedUrl 로 짧게 만료되는 링크를 쓰게 해 주세요. 상품 사진 버킷은 공개 그대로 둡니다.
같이 보면 좋은 것
- 데이터베이스 표에도 같은 일이 있습니다. 정책(RLS)이 꺼진 표는 공개 키만으로 다 읽힙니다. Supabase 무료 플랜에서 생기는 다른 일은 Supabase 무료 플랜 한도에 정리해 두었습니다
- 오픈 전에 확인할 다른 것들은 오픈 전에 확인할 12가지에 모아 두었습니다
2026년 10월 Supabase Storage 버킷 문서 기준입니다.