DATABASE

Supabase 실전 가이드 — RLS·새 API 키·요금 한도 (2026)

junetapa 업데이트 2026. 10. 29 11 min read

Supabase는 PostgreSQL을 그대로 쓰는 오픈소스 BaaS다. 테이블을 만들면 API가 생기고, 인증·스토리지·실시간·서버 함수가 한 프로젝트에 붙는다. 편한 만큼 실수도 한곳에 모인다. RLS를 켜지 않은 테이블, 브라우저 코드에 들어간 비밀 키, 일주일 만에 멈춘 무료 프로젝트가 대표적이다. 이 글은 이 세 가지를 피하는 데 초점을 맞춰 핵심 기능, RLS 정책, 2026년 말까지 바뀌는 API 키, 요금 한도, 로컬 개발 흐름을 2026년 10월 29일 공식 문서와 요금 페이지 기준으로 정리했다.

Supabase란 무엇인가?

PostgreSQL 위에 백엔드 기능을 얹은 구조

Supabase는 흔히 «오픈소스 Firebase 대안»으로 불리지만, 구조는 다르다. 중심에 문서형 데이터베이스가 아니라 PostgreSQL이 있다. 데이터는 표준 SQL로 다루고, 조인·뷰·트리거·함수 같은 관계형 데이터베이스 기능을 그대로 쓴다. 그 위에 API, 인증, 파일 저장, 실시간 전달, 서버 함수가 붙어 있다. 데이터를 덤프로 내보내거나, 도커로 같은 구성을 내 컴퓨터에 띄울 수 있다는 점도 이 구조에서 나온다.

BaaS가 덜어 주는 것과 남기는 것

BaaS(Backend as a Service)의 가치는 «백엔드 서버를 직접 짜지 않아도 된다»는 데 있다. 로그인, 데이터 저장, 파일 업로드, 실시간 알림처럼 매번 다시 만드는 기능을 플랫폼이 제공한다. 다만 서버를 직접 짜지 않는다는 것은, 권한 검사를 서버 코드 대신 데이터베이스 정책으로 해야 한다는 뜻이기도 하다. Supabase에서는 그 역할을 RLS(Row Level Security)가 맡는다. 이 글의 절반을 키와 RLS에 쓰는 이유다.

핵심 기능 — API·인증·실시간·스토리지·벡터

테이블을 만들면 생기는 API

Supabase에서 테이블을 만들면 그 테이블을 다루는 REST API를 바로 쓸 수 있다. 별도 API 서버를 짜지 않고 클라이언트 라이브러리로 조회·추가·수정을 한다. 이때 누가 무엇을 볼 수 있는지는 아래 RLS 정책이 정한다. 클라이언트 코드에는 새 키 체계의 publishable 키(예전 이름 anon 키)를 넣는다.

JavaScript — supabase-js 클라이언트
import { createClient } from '@supabase/supabase-js'

// 브라우저에 두는 키는 publishable 키(sb_publishable_…)만
const supabase = createClient(
  'https://your-project.supabase.co',
  '<SUPABASE_PUBLISHABLE_KEY>'
)

// RLS 정책이 허락한 행만 돌아온다
const { data, error } = await supabase
  .from('posts')
  .select('id, title, author:profiles(name)')
  .eq('published', true)
  .order('created_at', { ascending: false })
  .limit(10)

인증(Auth)

Supabase Auth는 이메일·비밀번호, 매직 링크, 소셜 로그인(OAuth) 같은 방식을 제공한다. 로그인한 사용자는 데이터베이스 안에서 auth.uid()로 자기 ID를 가리킬 수 있어서, 사용자별 데이터 정책을 SQL로 적을 수 있다. 소셜 로그인 공급자 목록과 설정 방법은 바뀔 수 있으니 쓰려는 공급자가 있으면 공식 Auth 문서에서 먼저 확인한다.

실시간과 스토리지

Realtime은 데이터베이스 변경이나 메시지를 WebSocket으로 전달한다. 채팅, 실시간 대시보드, 함께 편집하는 화면을 따로 서버 없이 만들 수 있다. Storage는 파일 저장소로, 업로드한 파일에도 RLS와 같은 방식의 접근 정책을 건다. 실시간 메시지 수와 동시 접속 수, 파일 용량은 요금제마다 한도가 있다(아래 요금 절).

Edge Functions와 벡터 검색

Edge Functions는 서버에서 도는 TypeScript 함수다. 결제 웹훅 처리, 외부 API 호출, 비밀 키가 필요한 작업처럼 브라우저에 두면 안 되는 로직을 여기에 둔다. AI 쪽에서는 PostgreSQL의 pgvector 확장으로 임베딩을 저장하고 유사도 검색을 할 수 있다. Supabase 문서는 벡터 인덱스로 HNSW를 기본 선택으로 권하고, pgvector 0.7.0 이상 기준 인덱스 차원 한도를 vector 2,000 · halfvec 4,000 · bit 64,000으로 적는다. 2,000차원이 넘는 임베딩은 halfvec으로 바꿔 인덱스를 거는 예를 든다.

데이터베이스와 인증, 스토리지, 실시간, 엣지 펑션 등 수파베이스 구성 요소를 정리한 도해
PostgreSQL 위에 필요한 것들을 얹어 놓은 구조다.

API 키 — anon·service_role에서 publishable·secret으로

Supabase 키 체계가 바뀌고 있다. 공식 API 키 문서 기준으로 정리하면 이렇다.

새 키예전 키권한둘 곳
sb_publishable_…anon(JWT)낮음 · RLS가 막음(로그인 전 anon 역할, 로그인 뒤 authenticated 역할)브라우저·모바일 앱
sb_secret_…service_role(JWT)높음 · BYPASSRLS라 RLS를 건너뜀서버·Edge Functions만

문서는 새 키와 예전 키가 동시에 동작하고, 새 키를 만들어도 예전 키는 따로 꺼야 꺼진다고 설명한다. 또 «2026년 말까지 anon·service_role 키를 지원 중단한다»고 적는다. 예전 키를 쓰는 프로젝트라면 올해 안에 새 키로 바꾸고, 다 바꾼 뒤 설정 화면에서 예전 키를 끄는 순서가 안전하다. 긴 키가 eyJ로 시작하면 예전 JWT 키다. 비밀 키를 브라우저에서 보내면 401로 거절된다는 점도 문서에 적혀 있다. 그렇다고 비밀 키를 프런트엔드 코드나 저장소에 두어도 된다는 뜻은 아니다. 서버 환경 변수에만 둔다.

RLS — 처음부터 켜고 정책을 붙인다

Supabase에서 가장 흔한 사고는 RLS를 끈 채로 개발하다 그대로 배포하는 것이다. publishable 키는 브라우저에 나가는 공개 키이므로, RLS가 꺼진 테이블은 사실상 밖에 열려 있다. 공식 문서는 RLS를 켜면 정책을 만들기 전까지 publishable 키로는 어떤 데이터도 API로 보이지 않는다고 설명한다. 그러니 순서는 «켠다 → 필요한 만큼 정책으로 연다»다.

SQL — 본인 데이터만 읽고 고치게 하는 정책
alter table profiles enable row level security;

create policy "본인 프로필만 조회"
  on profiles for select
  to authenticated
  using ( (select auth.uid()) = id );

create policy "본인 프로필만 수정"
  on profiles for update
  to authenticated
  using ( (select auth.uid()) = id )
  with check ( (select auth.uid()) = id );

예전 글의 예시에서 두 가지를 공식 문서 권고대로 고쳤다. 첫째, to authenticated로 정책이 적용될 역할을 적는다. 문서는 역할을 늘 명시하라고 하고, 그러면 로그인하지 않은 요청에는 이 검사가 아예 돌지 않는다. 둘째, auth.uid()를 (select auth.uid())로 감싼다. 이렇게 하면 행마다가 아니라 문장마다 한 번 계산되어 큰 테이블에서 빨라진다. 수정 정책에는 with check를 함께 두어, 고친 뒤의 행도 본인 것이어야 저장되게 한다.

권한(grant)도 따로 본다

RLS 정책보다 먼저 테이블 권한이 적용된다. 문서는 권한이 없으면 정책이 돌기 전에 오류 42501로 실패한다고 적는다. 정책을 맞게 썼는데 권한 오류가 나면, 그 역할에 테이블 권한이 있는지부터 본다. 새 테이블에 RLS가 자동으로 켜지는지는 프로젝트 설정에 따라 다를 수 있으니, 테이블마다 RLS 상태를 직접 확인하는 습관이 가장 확실하다.

알엘에스를 켜고 정책을 붙여야 데이터가 보호되는 순서를 나타낸 도해
RLS를 켜지 않으면 공개 키만으로 테이블 전체가 열린다.

요금 한도 — Free와 Pro

2026년 10월 29일 Supabase 요금 페이지 기준 두 요금제의 주요 한도는 다음과 같다.

항목FreePro(월 $25부터)
데이터베이스500MB프로젝트당 8GB 디스크, 초과 GB당 $0.125
월간 활성 사용자(MAU)50,000100,000, 초과 1명당 $0.00325
파일 저장1GB100GB, 초과 GB당 $0.0213
전송량(egress)5GB250GB, 초과 GB당 $0.09
Edge Functions 호출500,000200만, 초과 100만당 $2
Realtime 메시지월 200만월 500만, 초과 100만당 $2.50
Realtime 동시 접속200500, 초과 1,000당 $10
쉬면 멈춤1주일 활동 없으면 멈춤 · 활성 프로젝트 2개멈추지 않음 · 컴퓨트 크레딧 월 $10

무료 요금제에서 가장 자주 겪는 일은 «며칠 안 쓴 데모가 멈춰 있다»는 것이다. 요금 페이지는 무료 프로젝트가 1주일 동안 활동이 없으면 멈춘다고 적는다. 늘 떠 있어야 하는 서비스라면 Pro로 올리거나 다른 방식을 써야 한다. Pro는 «월 $25부터»라 사용량이 포함분을 넘으면 그만큼 더 나온다. 데이터베이스 크기·MAU·전송량 셋을 대시보드에서 때마다 챙겨 보는 것이 요금 관리의 대부분이다. 요금은 바뀔 수 있으니 계약 전에는 요금 페이지를 다시 연다.

로컬 개발과 배포 환경 나누기

Supabase를 처음 쓸 때는 웹 대시보드에서 테이블을 만들고 정책을 켜게 된다. 빠르지만, 이 방식은 운영 프로젝트 하나에 직접 손을 대는 구조라 곧 한계가 온다. 실수로 컬럼을 지우면 되돌릴 곳이 없고, 무엇이 언제 바뀌었는지도 남지 않는다.

해결은 Supabase CLI다. 공식 안내 기준으로 supabase init을 하면 버전 관리에 넣어도 되는 supabase 폴더가 생기고, supabase start를 하면 도커 컨테이너로 로컬에 같은 스택이 뜬다(컨테이너 런타임이 먼저 설치돼 있어야 한다). 로컬에서 바꾼 스키마는 supabase db diff -f 이름으로 마이그레이션 파일로 저장해 Git에 커밋하고, 원격 프로젝트에 적용하는 단계는 공식 «Pushing to a remote project» 안내를 따른다. 대시보드에서 손으로 하던 일이 코드 리뷰가 가능한 형태로 바뀐다.

환경도 나눠 둔다. 개발용과 운영용 프로젝트를 따로 두고 키를 각각 관리한다(무료 요금제는 활성 프로젝트 2개까지). 비밀 키는 RLS를 통째로 건너뛰는 열쇠라 서버 쪽에서만 쓰고, 브라우저로 나가는 코드에는 publishable 키만 둔다. 이 구분이 흐려지면 앞에서 공들여 켠 RLS가 아무 일도 하지 않게 된다. PostgreSQL 자체의 인덱스·쿼리 튜닝은 PostgreSQL 완전 가이드 — SQL 최적화 실전에서 이어 볼 수 있다.

Supabase와 Firebase, 무엇이 다른가

두 플랫폼은 하는 일이 비슷해 보이지만 출발점이 다르다. Supabase는 관계형 PostgreSQL, Firebase의 대표 데이터베이스인 Firestore는 문서형 NoSQL이다. 요금도 Supabase는 위 표처럼 데이터베이스 크기·MAU·전송량 같은 자원 기준이 중심이고, Firestore는 읽기·쓰기·삭제 같은 작업 횟수가 요금에 크게 반영된다. 어느 쪽이 싼지는 데이터 모양과 사용 패턴에 따라 달라서, 같은 서비스라도 직접 사용량을 넣어 셈해 봐야 한다. 이 글의 예전 판에 있던 «30~50% 저렴», «월 104달러 대 150~250달러» 같은 비교 수치는 근거를 다시 확인할 수 없어 뺐다.

항목SupabaseFirebase(Firestore)
데이터 모델PostgreSQL(관계형)문서형 NoSQL
질의표준 SQL, 조인·뷰·함수문서·컬렉션 단위 질의
권한 검사RLS 정책(SQL)보안 규칙(Security Rules)
빠져나오기오픈소스 · 셀프호스팅 · SQL 덤프구글 클라우드 중심
벡터 검색pgvector 확장별도 기능·연동
고르는 기준

데이터가 서로 얽혀 있고(주문·상품·회원) SQL로 다루고 싶다면 Supabase가 맞는다. 모바일 앱에서 구글 서비스(푸시 알림·분석 등)와 깊게 엮을 계획이라면 Firebase 쪽이 편할 수 있다. 문서형 데이터 설계가 익숙하지 않다면 NoSQL 데이터 모델링 패턴 가이드, Firebase를 모바일 앱에 붙이는 흐름은 Firebase 모바일 백엔드 연동 — 인증·Firestore·FCM (2026)를 함께 보면 비교가 쉽다.

수파베이스와 파이어베이스의 데이터 모델과 종속성을 나눠 비교한 도해
관계형이냐 문서형이냐, 그리고 «빼낼 수 있느냐»가 다르다.

자주 묻는 것

Supabase 무료 프로젝트가 멈췄어요. 왜 그런가요?

2026년 10월 29일 요금 페이지 기준으로 무료 프로젝트는 1주일 동안 활동이 없으면 멈춥니다. Pro 요금제는 활동이 없어도 멈추지 않습니다. 계속 떠 있어야 하는 서비스라면 Pro로 올리는 것을 검토합니다.

anon 키와 publishable 키는 뭐가 다른가요?

publishable 키(sb_publishable_…)는 예전 anon 키(JWT)를 대신하는 새 공개 키입니다. 둘 다 브라우저에 둘 수 있고 RLS가 접근을 막습니다. 공식 문서는 anon·service_role 키를 2026년 말까지 지원 중단한다고 적고 있어, 새 키로 바꾼 뒤 예전 키를 끄는 순서를 권합니다.

RLS를 켰더니 아무 데이터도 안 보입니다.

정상입니다. 공식 문서 기준으로 RLS를 켜면 정책을 만들기 전까지 publishable 키로는 어떤 데이터도 API로 보이지 않습니다. 필요한 만큼 select·insert·update 정책을 추가하고, 권한(grant) 오류 42501이 나면 테이블 권한도 확인합니다.

Supabase Pro 요금은 정확히 얼마인가요?

요금 페이지에는 월 25달러부터로 적혀 있고, 데이터베이스 8GB·MAU 10만·파일 100GB·전송량 250GB 등이 포함됩니다. 포함분을 넘으면 항목별로 추가 요금이 붙습니다.

정리

Supabase는 PostgreSQL을 그대로 쓰면서 백엔드의 반복 작업을 덜어 주는 플랫폼이다. 대신 권한 검사가 서버 코드에서 데이터베이스 정책으로 옮겨 온다. 테이블을 만들면 RLS부터 켜고, 브라우저에는 publishable 키만, 비밀 키는 서버에만 둔다. 예전 anon·service_role 키를 쓰고 있다면 2026년 말 전에 새 키로 바꾼다. 무료 프로젝트는 1주일 쉬면 멈추니 데모와 실서비스를 구분하고, 스키마 변경은 CLI 마이그레이션으로 남긴다. 이 다섯 가지만 지켜도 Supabase에서 생기는 사고 대부분을 피할 수 있다.

Supabase 실전 가이드 대표 그림 — 왼쪽에 «Supabase 실전 가이드 · RLS와 요금 한도» 제목이 있고, 오른쪽에 큰 데이터베이스 원통 위로 열쇠·번개·구름·폴더 모양 블록이 쌓이고 줄무늬 방패가 원통을 감싼 장면
Supabase 실전 가이드 — RLS·새 API 키·요금 한도 (2026).

참고 자료

  1. Supabase. Pricing — Free·Pro 한도(DB·MAU·파일·전송량·Edge Functions·Realtime), 무료 1주일 멈춤·활성 프로젝트 2개, Pro 월 $25부터·컴퓨트 크레딧 $10(2026-10-29 확인). supabase.com
  2. Supabase Docs. Row Level Security — RLS를 켜면 정책 전까지 publishable 키로 데이터 안 보임, 권한 오류 42501, service_role의 bypassrls, to authenticated·(select auth.uid()) 권고(2026-10-29 확인). supabase.com
  3. Supabase Docs. Understanding API keys — publishable·secret 키와 예전 anon·service_role, 동시 동작, 2026년 말까지 예전 키 지원 중단(2026-10-29 확인). supabase.com
  4. Supabase Docs. HNSW indexes — 기본 선택 HNSW, 연산자 클래스, pgvector 0.7.0+ 인덱스 차원 한도(2026-10-29 확인). supabase.com
  5. Supabase Docs. CLI getting started — supabase init·start(도커 필요)·db diff(2026-10-29 확인). supabase.com
  6. Firebase Docs. Cloud Firestore pricing — 문서 읽기·쓰기·삭제 횟수, 저장 용량, 네트워크 대역폭으로 청구(2026-10-29 확인). firebase.google.com
Supabase PostgreSQL BaaS RLS Supabase 요금 publishable key pgvector Firebase 비교
junetapa(박준철)
개발자가 아니라 쓰는 사람. IT 현장 27년의 기준으로 AI 도구를 고르고 기록한다.
Twitter Facebook URL 복사