새로운Publication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2변경 내역 보기 →

공학 · 6분 읽음

Supabase을(를) Aurabase(으)로 마이그레이션하고 RLS(을)를 유지하세요

Affane Daylami · Fondateur · 2026년 9월 20일

블로그로 돌아가기

Supabase에 있고 Aurabase을 주목하고 있다면(자세한 비교 참조) 가장 어려운 부분은 선택이라는 것입니다. 아래 표에는 마이그레이션의 변경 사항이 정확하게 나열되어 있습니다. 즉, 스키마, RLS 정책, SDK, 인증 및 저장소는 동일하게 유지됩니다.

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

Aurabase에서는 설계 단계부터 강력한 제약을 두었습니다. SDK 표면과 RLS 규칙은 Supabase와 드롭인 호환되어야 했습니다. 동일한 createClient(), 동일한 .from().select().eq(), 동일한 SQL Postgres 정책. 아이디어: 떠나고 싶으면 떠나세요. 우리는 그것을 사소한 일로 만듭니다. 전체 플레이북은 다음과 같습니다.

#
사전감사

움직이는 것, 남는 것

시작하기 전에 무엇이 바뀌고 무엇이 남을지 나열해 보세요. 스포일러: 대다수가 남아있습니다.

Postgres 스키마동일pg_dump → pg_restore. 확장, 트리거, 함수, 인덱스 등 모든 것이 가능합니다.
RLS 정책동일동일한 구문. auth.uid(), auth.role(), auth.jwt()는 그대로 작동합니다.
자바스크립트 SDK95% 동일@supabase/supabase-js를 @aurabase/aurabase-js로 바꿉니다. 동일한 체인 가능 API.
인증 흐름동일signUp, signInWithPassword, signInWithOAuth, mfa — 동일한 이름, 동일한 서명.
스토리지 API동일aura.storage.from(bucket).upload(...) · S3 호환 · 전송 가능한 RLS 정책.
실시간동일채널().on("postgres_changes", ...)은 변경되지 않았습니다. 존재 + 방송 동일합니다.
Edge Functions동일Deno.serve()를 그대로 Studio 편집기에 붙여넣었습니다. CLI에는 별도의 경로(Rust 로 컴파일된 WASM)를 겨냥한 함수 배포가 있습니다.
대시보드다른Studio Aurabase · 귀하의 방향을 찾는 데 도움을 드립니다.
#
1단계

대상 Aurabase 프로젝트 생성

공식 CLI를 사용하여 새 Aurabase 프로젝트를 생성한 후 이 폴더를 프로젝트에 연결하면 다음 명령이 자동으로 적용됩니다.

terminalbash
# Aurabase 계정 + CLI
npm i -g @aurabase/cli
aura login

# 프로젝트 생성(Postgres 엔진)
aura projects create my-app --engine postgres

# 이 폴더를 생성된 프로젝트에 연결
aura link --project-id <uuid-du-projet>

# 연결된 프로젝트의 API 키를 검색하세요.
aura projects api-keys
#
2단계

Supabase덤프, Aurabase 복원

표준 pg_dump / pg_restore: Aurabase는 각 프로젝트(Studio → 설정 → 연결)에 대해 직접 Postgres 연결 문자열을 노출하므로 중간 변환이 필요하지 않습니다.

terminalbash
# 대시보드에서 Supabase 연결 문자열을 검색합니다.
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"

# 공개 스키마 덤프(Supabase 시스템 스키마 없음)
pg_dump "$SUPABASE_DB_URL" \
  --schema=public \
  --no-owner --no-acl \
  --format=custom \
  -f supabase-dump.pgdump

# Aurabase 연결 문자열 검색(Studio → 설정 → 연결)
# ?search_path= 매개변수는 필수입니다. 프로젝트의 스키마로 라우팅됩니다.
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"

# 표준 pg_restore를 사용하여 복원
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump

# TypeScript 유형 재생성
aura db generate > src/aurabase.types.ts
#
3단계

사용자 마이그레이션

이전에 여기에 언급한 내용과 비교하여 수정해야 할 점: Aurabase는 Argon2id로 비밀번호를 해시하지만 Supabase(GoTrue)는 기본적으로 bcrypt를 사용하여 자체적으로 해시합니다. 두 형식은 서로 바꿔 사용할 수 없습니다. 따라서 사용자는 대부분의 마이그레이션과 마찬가지로 비밀번호를 한 번 재설정해야 합니다.

Aurabase는 현재 Supabase에서 대량 가져오기 도구를 제공하지 않습니다. 두 가지 옵션: 사용자가 스스로 재등록하도록 하거나(동일한 이메일 주소로signUp), 비밀번호 재설정을 실행하기 전에 관리자 측에서 aura auth users create --email <email>를 사용하여 사용자를 하나씩 다시 생성하세요.

정보

Supabase 측의 활성 세션은 포팅되지 않습니다(기술적으로 불가능합니다. 각 플랫폼은 자체 키로 JWT에 서명합니다). 사용자는 새 비밀번호를 사용하여 다시 로그인해야 합니다.

#
4단계

클라이언트 코드 조정

검색/바꾸기는 95%의 경우에 충분합니다.

lib/supabase.ts → lib/aurabase.tstypescript
// 이전(Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)

// 이후(Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)

// 나머지 코드는 변경되지 않습니다.
await aura.from('posts').select('*').eq('author_id', userId)
#
5단계

Edge Functions 배포

Aurabase는 Edge Functions에 대한 두 가지 경로를 제공합니다. Studio 코드 편집기(Deno 런타임, Supabase와 동일 — 함수를 있는 그대로 붙여넣기)와 Rust에서 작성되고 WASM에서 컴파일된 함수에 대한 별도의 경로를 목표로 하는 aura functions deployCLI입니다. 다시 작성하지 않고 기존 Deno 코드를 마이그레이션하려면 Studio를 사용하세요.

functions/hello/index.tstypescript
// 동일하게 작동하며 Studio 편집기에 그대로 붙여넣습니다.
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(JSON.stringify({ hello: name }))
})
#
컷오버

DNS 전환 및 생산 개시

두 가지 가능한 전략. 첫 번째 방법은 99%의 경우에 권장됩니다.

  1. 직접 컷오버 — 환경 변수에서 NEXT_PUBLIC_AURABASE_URL 및 NEXT_PUBLIC_AURABASE_ANON_KEY를 변경하고 재배포합니다. 사용자가 다시 연결하면 모든 것이 작동합니다. 대부분의 프로젝트에 권장됩니다.
  2. 임시 이중 쓰기 — 48시간 동안 Supabase + Aurabase에 동시에 쓰고 중요한 테이블의 일관성을 수동으로 확인한 다음(행 계산, 체크섬) Supabase을 종료합니다. 중요한 앱에 선호됩니다.
#
도움말

일이 막히면 우리가 여기 있어요

대규모 프로젝트 또는 엄격한 규정 준수 제약이 있는 경우 당사 팀이 마이그레이션을 지원할 수 있습니다. 귀하의 프로젝트에 맞는 제안을 원하시면 당사에 문의하십시오.

지원 요청 →

배포할 준비가 되셨나요?

5분 만에 백엔드를 완성하세요.

신용카드 불필요 · 500MB 무료 · 50,000 MAU