NOWYPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Zobacz dziennik zmian →

Inżynieria · 6 min odczytu

Przeprowadź migrację Supabase do Aurabase, zachowaj RLS

Affane Daylami · Fondateur · 20 września 2026

Powrót do bloga

Jeśli jesteś na Supabase i patrzysz na Aurabase (zobacz nasze szczegółowe porównanie), dobra wiadomość jest taka, że ​​najtrudniejszą częścią jest wybór. Poniższa tabela dokładnie wymienia zmiany podczas migracji — jest krótka: schemat, zasady RLS, pakiet SDK, uwierzytelnianie i pamięć pozostają takie same.

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

W Aurabase narzuciliśmy sobie silne ograniczenia już na etapie projektowania: powierzchnia SDK i konwencje RLS musiały być kompatybilne z z Supabase. Te same zasady createClient(), te same .from().select().eq(), te same zasady SQL Postgres. Pomysł: jeśli chcesz odejść, odejdź – my sprawiamy, że jest to trywialne. Oto pełna instrukcja gry.

#
Audyt wstępny

Co się rusza, co zostaje

Zanim zaczniesz, wypisz, co się zmieni, a co pozostanie. Spoiler: większość pozostaje.

Postgres SchematTO SAMOpg_dump → pg_restore. Rozszerzenia, wyzwalacze, funkcje, indeksy — wszystko jest dozwolone.
RLS ZasadyTO SAMOTa sama składnia. auth.uid(), auth.role(), auth.jwt() działają bez zmian.
SDK JavaScriptu95% IDENTYCZNEZamień @supabase/supabase-js na @aurabase/aurabase-js. Ten sam łańcuchowy interfejs API.
Przepływy uwierzytelnianiaTO SAMOsignUp,signInWithPassword,signInWithOAuth,mfa — te same nazwy, te same podpisy.
Interfejs API pamięci masowejTO SAMOaura.storage.from(bucket).upload(...) · kompatybilność S3 · zasady zbywalne RLS.
W czasie rzeczywistymTO SAMOkanał().on("postgres_changes", ...) bez zmian. Obecność + transmisja tak samo.
Edge FunctionsTO SAMODeno.serve() wklejono w niezmienionej postaci do edytora Studio. W interfejsie CLI funkcje zostaną wdrożone w osobnej ścieżce (Rust skompilowany do WASM).
PanelRÓŻNYStudio Aurabase · pomagamy Ci odnaleźć orientację.
#
Krok 1

Utwórz docelowy projekt Aurabase

Utwórz nowy projekt Aurabase za pomocą oficjalnego interfejsu CLI, a następnie połącz ten folder z projektem, aby automatycznie zastosować się do niego następujące polecenia.

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

# Utwórz projekt (silnik Postgres)
aura projects create my-app --engine postgres

# Połącz ten folder z utworzonym projektem
aura link --project-id <uuid-du-projet>

# Pobierz klucze API połączonego projektu
aura projects api-keys
#
Krok 2

Zrzuć Supabase, przywróć Aurabase

Standardowy pg_dump / pg_restore: Aurabase udostępnia bezpośredni ciąg połączenia Postgres dla każdego projektu (Studio → Ustawienia → Połączenie), bez potrzeby pośredniej transformacji.

terminalbash
# Pobierz parametry połączenia Supabase z ich pulpitu nawigacyjnego
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"

# Zrzut schematu publicznego (bez schematów systemowych Supabase)
pg_dump "$SUPABASE_DB_URL" \
  --schema=public \
  --no-owner --no-acl \
  --format=custom \
  -f supabase-dump.pgdump

# Pobierz parametry połączenia Aurabase (Studio → Ustawienia → Połączenie)
# Parametr ?search_path= jest OBOWIĄZKOWY: kieruje do schematu Twojego projektu
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"

# Przywróć za pomocą standardowego pg_restore
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump

# Wygeneruj ponownie typy TypeScript
aura db generate > src/aurabase.types.ts
#
Krok 3

Przeprowadź migrację użytkowników

Należy poprawić w porównaniu z tym, co powiedzieliśmy wcześniej: Aurabase miesza hasła za pomocą Argon2id, ale Supabase (GoTrue) domyślnie miesza hasła za pomocą bcrypt — te dwa formaty nie są zamienne. Dlatego Twoi użytkownicy będą musieli jednorazowo zresetować hasło, jak w przypadku większości migracji.

Aurabase nie oferuje obecnie narzędzia do masowego importu z Supabase. Dwie opcje: pozwól użytkownikom ponownie się zarejestrować (signUp z tym samym adresem e-mail) lub utwórz ich jeden po drugim po stronie administratora za pomocą aura auth users create --email <email> przed uruchomieniem resetowania hasła.

Informacje

Aktywne sesje po stronie Supabase nie są przenoszone (technicznie niemożliwe — każda platforma podpisuje swoje JWT własnym kluczem). Użytkownicy będą musieli zalogować się ponownie, podając nowe hasło.

#
Krok 4

Dostosuj kod klienta

W 95% przypadków wystarczy wyszukiwanie/zamiana.

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

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

// Pozostała część kodu nie ulega zmianie:
await aura.from('posts').select('*').eq('author_id', userId)
#
Krok 5

Wdróż Edge Functions

Aurabase oferuje dwie ścieżki dla Edge Functions: edytor kodu Studio ( środowisko wykonawcze Deno, takie samo jak Supabase — wklej swoją funkcję w niezmienionej postaci) i interfejs CLI aura functions deploy, którego celem jest osobna ścieżka dla funkcji napisanych w Rust i skompilowanych w WASM. Aby przeprowadzić migrację istniejącego kodu Deno bez przepisywania, użyj pliku Studio.

functions/hello/index.tstypescript
// Działa tak samo, wklejony do edytora Studio
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(JSON.stringify({ hello: name }))
})
#
Przecięcie

Przełączenie DNS i uruchomienie produkcji

Dwie możliwe strategie. Pierwszy jest zalecany w 99% przypadków.

  1. Bezpośrednie przejście — zmień NEXT_PUBLIC_AURABASE_URL i NEXT_PUBLIC_AURABASE_ANON_KEY w zmiennych środowiskowych, wdróż ponownie. Użytkownicy łączą się ponownie, wszystko działa. Zalecany do większości projektów.
  2. Tymczasowy podwójny zapis — zapisz Supabase + Aurabase jednocześnie przez 48 godzin, ręcznie sprawdź spójność krytycznych tabel (liczenie wierszy, sumy kontrolne), a następnie zamknij Supabase. Preferowany w przypadku krytycznych aplikacji.
#
Pomoc

Jesteśmy tu, jeśli coś utknie

W przypadku dużych projektów lub przy rygorystycznych ograniczeniach związanych ze zgodnością nasz zespół może pomóc Ci w migracji. Skontaktuj się z nami, aby uzyskać ofertę dostosowaną do Twojego projektu.

Poproś o wsparcie →

GOTOWY DO WDROŻENIA?

Twój backend w pięć minut.

Karta kredytowa nie jest wymagana · 500 MB za darmo · 50 000 MAU