← 목록으로
웹 개발

Supabase로 데이터베이스 연결하기 — 무료로 백엔드 만들기

👁 150

Supabase를 선택한 이유

블로그를 직접 만들기로 했을 때, 가장 큰 고민은 "글 데이터를 어디에 저장하지?"였습니다. 파일로 저장하는 방법도 있지만, 댓글이나 조회수 같은 동적인 데이터를 다루려면 데이터베이스가 필요했습니다.

여러 선택지를 비교했습니다:

  • Firebase — 구글 제품이라 안정적이지만, NoSQL 방식이 저에게는 낯설었습니다.
  • PlanetScale — MySQL 기반이라 익숙하지만, 무료 플랜이 축소되었습니다.
  • Supabase — PostgreSQL 기반, 무료 티어가 넉넉하고, 관리 대시보드가 직관적입니다.

결국 Supabase를 선택했습니다. 무료로 시작할 수 있고, PostgreSQL이라 SQL을 바로 쓸 수 있어서 학습 가치도 높았습니다.

Supabase 시작하기: 가입과 프로젝트 생성

시작은 정말 간단합니다:

  • 1단계: supabase.com에 접속하여 GitHub 계정으로 로그인합니다.
  • 2단계: "New Project" 버튼을 클릭합니다.
  • 3단계: 프로젝트 이름, 데이터베이스 비밀번호, 리전(저는 Northeast Asia를 선택)을 설정합니다.
  • 4단계: 약 2분 후 프로젝트가 생성됩니다.

생성 후 대시보드에서 API URL과 anon key를 확인합니다. 이 두 값을 Next.js 프로젝트의 환경 변수 파일(.env.local)에 넣으면 연동 준비 완료입니다.

테이블 설계: 블로그에 필요한 데이터 구조

블로그에 필요한 테이블을 설계하면서 데이터베이스의 기초를 배웠습니다. 제가 만든 테이블은 다음과 같습니다:

  • posts — 글 제목, 내용, 슬러그, 상태, 조회수 등
  • categories — 카테고리 이름, 슬러그, 색상
  • tags — 태그 이름, 슬러그
  • post_tags — 글과 태그의 다대다 관계를 연결
  • comments — 댓글 (닉네임, 내용, 비밀번호)
  • series — 시리즈 (여러 글을 묶는 기능)

Supabase의 SQL Editor에서 직접 CREATE TABLE 문을 실행해서 테이블을 만들었습니다. 처음에는 SQL 문법이 낯설었지만, ChatGPT에게 물어보며 하나씩 만들었습니다.

Next.js와 연동하기

Supabase에서 제공하는 JavaScript 클라이언트 라이브러리를 설치하면 됩니다:

npm install @supabase/supabase-js @supabase/ssr

그 다음, 클라이언트를 생성하는 유틸리티 파일을 만듭니다. 서버 컴포넌트용과 클라이언트 컴포넌트용 두 가지를 만드는 것이 포인트입니다. Next.js의 서버 컴포넌트에서는 쿠키를 통해 인증 상태를 관리할 수 있습니다.

RLS(Row Level Security) — 보안 설정

Supabase에서 가장 중요한 개념 중 하나가 RLS입니다. 이것은 "누가 어떤 데이터에 접근할 수 있는지"를 테이블 단위로 설정하는 보안 기능입니다.

예를 들어:

  • 발행된 글은 누구나 읽을 수 있음 (SELECT 허용)
  • 글 작성/수정/삭제는 관리자만 가능 (INSERT/UPDATE/DELETE 제한)
  • 댓글은 누구나 작성 가능하지만, 삭제는 비밀번호 확인 후에만 가능

처음에는 RLS 설정을 빼먹어서 API 호출 시 빈 배열만 돌아온 적이 있습니다. Supabase에서 RLS가 활성화되면 정책이 없는 테이블은 기본적으로 모든 접근을 차단합니다. 이 점을 꼭 기억하세요!

마치며

Supabase 덕분에 무료로 안정적인 백엔드를 구축할 수 있었습니다. 개인 블로그 정도의 트래픽이라면 무료 티어로 충분합니다. SQL을 배우면서 데이터베이스의 기초를 이해하게 된 것도 큰 소득이었습니다.

다음 글에서는 완성된 블로그를 Vercel에 배포하는 과정을 공유할게요. 10분이면 내 블로그를 전 세계에 공개할 수 있습니다!

전통적인 백엔드 구축 vs Supabase(BaaS) 아키텍처 비교

과거에 블로그나 웹 서비스를 만들려면 AWS EC2 서버를 빌리고, Linux 환경에서 PostgreSQL이나 MySQL을 설치한 뒤, Node.js(Express)나 Spring Boot로 CRUD API 서버를 따로 개발해야 했습니다. 반면 Supabase는 오픈소스 PostgreSQL 데이터베이스를 기반으로 인증(Auth), 실시간 구독(Realtime), 파일 스토리지(Storage), 그리고 자동 생성되는 REST/GraphQL API를 하나로 묶어 제공하는 대표적인 BaaS(Backend-as-a-Service)입니다.

구분 항목 전통적 자체 백엔드 (AWS EC2 + Express + RDS) Supabase 기반 서버리스 백엔드
초기 구축 소요 시간 최소 3~7일 (서버 세팅, DB 연결, API 라우트 작성) 15분 이내 (프로젝트 생성 즉시 PostgreSQL 및 API 발급)
보안 및 권한 제어 미들웨어에서 JWT 검증 및 권한 분기 코드 직접 구현 PostgreSQL 표준 RLS (Row Level Security) 정책으로 DB 레벨 방어
타입 안정성 (TypeScript) 인터페이스나 DTO를 수동으로 정의·동기화 CLI 명령어 한 줄(supabase gen types)로 DB 스키마 타입 자동 추출
초기 운영 비용 RDS 프리티어 종료 시 월 $15~$30 이상 발생 무료 티어 영구 제공 (500MB DB, 1GB 스토리지, 월 5만 MAU)

가장 중요한 보안 핵심: RLS(Row Level Security)와 테이블 설계 SQL 예제

Supabase는 프론트엔드나 서버 컴포넌트에서 `ANON_KEY`(공개 키)를 사용해 데이터베이스와 직접 통신할 수 있는 구조입니다. 따라서 "누구에게나 글 읽기(SELECT)는 허용하되, 임시저장(draft) 글은 숨기고, 글 수정·삭제(UPDATE/DELETE)는 관리자만 가능하도록" 데이터베이스 테이블 자체에 자물쇠를 걸어두는 RLS(행 수준 보안) 설정이 필수입니다.

-- 1. 블로그 게시글(posts) 테이블 생성 및 성능 최적화 인덱스 설정
CREATE TABLE IF NOT EXISTS public.posts (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  title TEXT NOT NULL,
  slug TEXT NOT NULL UNIQUE,
  excerpt TEXT,
  content TEXT NOT NULL,
  status TEXT NOT NULL DEFAULT 'draft' CHECK (status IN ('draft', 'published')),
  locale TEXT NOT NULL DEFAULT 'ko',
  view_count INTEGER NOT NULL DEFAULT 0,
  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
  published_at TIMESTAMPTZ,
  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

-- 슬러그 및 발행 상태 기준 고속 조회를 위한 복합 인덱스
CREATE INDEX IF NOT EXISTS idx_posts_slug_locale ON public.posts (slug, locale);
CREATE INDEX IF NOT EXISTS idx_posts_status_published_at ON public.posts (status, published_at DESC);

-- 2. RLS (Row Level Security) 활성화
ALTER TABLE public.posts ENABLE ROW LEVEL SECURITY;

-- 3. 읽기 정책: 일반 방문자(anon)는 'published' 상태인 글만 조회 가능
CREATE POLICY "Public can view published posts"
  ON public.posts
  FOR SELECT
  USING (status = 'published');

무료 플랜(Free Tier) 운영 시 반드시 알아야 할 실무 팁 2가지

  • 7일 미활동 시 프로젝트 일시 중지(Pause) 방지: Supabase 무료 플랜은 7일 동안 데이터베이스에 아무런 쿼리 요청이 없으면 리소스 절약을 위해 프로젝트가 일시 중지됩니다. 블로그에 방문자가 하루에 한 명이라도 오거나, 구글 서치콘솔 봇이 사이트맵(`sitemap.xml`)을 크롤링하면 자동으로 쿼리가 발생하여 중지되지 않으며, GitHub Actions 스케줄러(Cron)로 주 2회 간단한 헬스체크 핑을 보내도록 설정하면 365일 내내 안정적으로 유지됩니다.
  • `ANON_KEY`와 `SERVICE_ROLE_KEY`의 엄격한 분리: `NEXT_PUBLIC_SUPABASE_ANON_KEY`는 브라우저에 노출되어도 RLS 정책에 의해 안전하게 보호되지만, 모든 보안 정책을 우회하는 마스터 키인 `SUPABASE_SERVICE_ROLE_KEY`는 절대 `NEXT_PUBLIC_` 접두사를 붙이거나 클라이언트 컴포넌트에서 불러오면 안 됩니다. 관리자 API 라우트(`src/app/api/admin/...`)나 서버 전용 환경변수로만 격리해 사용하세요.

댓글 (0)

첫 번째 댓글을 작성해보세요!