NUOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Vedi il registro delle modifiche →

Ingegneria · 6 lettura minima

Migra Supabase a Aurabase, mantieni il tuo RLS

Affane Daylami · Fondateur · 20 settembre 2026

Torniamo al blog

Se sei su Supabase e stai guardando Aurabase (guarda il nostro confronto dettagliato), la buona notizia è che la parte più difficile è scegliere. La tabella seguente elenca esattamente cosa cambia in una migrazione ed è breve: schema, policy RLS, SDK, autenticazione e archiviazione rimangono gli stessi.

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

In Aurabase, ci siamo posti un forte vincolo sin dalla fase di progettazione: la superficie dell'SDK e le convenzioni RLS dovevano essere compatibili drop-in con Supabase. Stessi createClient(), stessi .from().select().eq(), stesse policy SQL Postgres. L'idea: se vuoi andartene, vattene: la rendiamo banale. Ecco il playbook completo.

#
Audit preventivo

Ciò che si muove, ciò che resta

Prima di iniziare, elenca cosa cambierà e cosa rimarrà. Spoiler: la maggioranza resta.

Postgres SchemaSTESSOpg_dump → pg_restore. Estensioni, trigger, funzioni, indici: tutto va bene.
RLS PoliticheSTESSOStessa sintassi. auth.uid(), auth.role(), auth.jwt() funzionano così come sono.
SDK JavaScript95% IDENTICOSostituisci @supabase/supabase-js con @aurabase/aurabase-js. Stessa API concatenabile.
Flussi di autenticazioneSTESSOsignUp, signInWithPassword, signInWithOAuth, mfa: stessi nomi, stesse firme.
API di archiviazioneSTESSOaura.storage.from(bucket).upload(...) · compatibilità S3 · politiche trasferibili RLS.
In tempo realeSTESSOchannel().on("postgres_changes", ...) invariato. Presenza + trasmissione uguale.
Edge FunctionsSTESSODeno.serve() incollato così com'è nell'editor di Studio. La CLI avrà funzioni di distribuzione mirate a un percorso separato (Rust compilato in WASM).
CruscottoDIVERSOStudio Aurabase · ti aiutiamo a orientarti.
#
Passaggio 1

Crea il progetto di destinazione Aurabase

Crea un nuovo progetto Aurabase con la CLI ufficiale, quindi collega questa cartella al progetto in modo che i seguenti comandi si applichino automaticamente ad esso.

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

# Crea il progetto (motore Postgres)
aura projects create my-app --engine postgres

# Collega questa cartella al progetto creato
aura link --project-id <uuid-du-projet>

# Recupera le chiavi API del progetto collegato
aura projects api-keys
#
Passaggio 2

Scarica Supabase, ripristina Aurabase

Uno standard pg_dump / pg_restore: Aurabase espone una stringa di connessione diretta Postgres per ciascun progetto (Studio → Impostazioni → Connessione), senza necessità di trasformazione intermedia.

terminalbash
# Recupera la stringa di connessione Supabase dalla dashboard
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"

# Dump dello schema pubblico (senza schemi di sistema Supabase)
pg_dump "$SUPABASE_DB_URL" \
  --schema=public \
  --no-owner --no-acl \
  --format=custom \
  -f supabase-dump.pgdump

# Recupera la stringa di connessione Aurabase (Studio → Impostazioni → Connessione)
# Il parametro ?search_path= è OBBLIGATORIO: indirizza allo schema del tuo progetto
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"

# Ripristina con pg_restore standard
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump

# Rigenera i tipi TypeScript
aura db generate > src/aurabase.types.ts
#
Passaggio 3

Migrare gli utenti

Un punto da correggere rispetto a quanto affermato qui in precedenza: Aurabase esegue l'hashing delle password con Argon2id, ma Supabase (GoTrue) esegue l'hashing delle proprie password per impostazione predefinita con bcrypt — i due formati non sono intercambiabili. I tuoi utenti dovranno quindi reimpostare la propria password una volta, come con la maggior parte delle migrazioni.

Aurabase attualmente non offre uno strumento di importazione di massa da Supabase. Due opzioni: consentire ai tuoi utenti di registrarsi nuovamente (signUp con lo stesso indirizzo email) o ricrearli uno per uno sul lato amministratore con aura auth users create --email <email> prima di attivare la reimpostazione della password.

Informazioni

Le sessioni attive sul lato Supabase non vengono trasferite (tecnicamente impossibile: ciascuna piattaforma firma i propri JWT con la propria chiave). Gli utenti dovranno effettuare nuovamente l'accesso, con la nuova password.

#
Passaggio 4

Adattare il codice cliente

Una ricerca/sostituzione è sufficiente nel 95% dei casi.

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

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

// Il resto del codice non cambia:
await aura.from('posts').select('*').eq('author_id', userId)
#
Passaggio 5

Distribuisci Edge Functions

Aurabase offre due percorsi per Edge Functions: l'editor di codice di Studio (Deno runtime, uguale a Supabase — incolla la funzione così com'è) e aura functions deployCLI, che mira a un percorso separato per le funzioni scritte in Rust e compilate in WASM. Per eseguire la migrazione del codice Deno esistente senza riscriverlo, utilizzare Studio.

functions/hello/index.tstypescript
// Funziona allo stesso modo, incollato così com'è nell'editor di Studio
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(JSON.stringify({ hello: name }))
})
#
Taglio

Switchover DNS e avvio della produzione

Due possibili strategie. Il primo è consigliato nel 99% dei casi.

  1. Cutover diretto — cambia NEXT_PUBLIC_AURABASE_URL e NEXT_PUBLIC_AURABASE_ANON_KEY nelle tue variabili di ambiente, ridistribuisci. Gli utenti si riconnettono, tutto funziona. Consigliato per la maggior parte dei progetti.
  2. Doppia scrittura temporanea: scrivi Supabase + Aurabase simultaneamente per 48 ore, controlla manualmente la coerenza delle tabelle critiche (conteggio delle righe, checksum), quindi spegni Supabase. Preferito per le app critiche.
#
Aiuto

Siamo qui se le cose si bloccano

Per progetti di grandi dimensioni o con rigidi vincoli di conformità, il nostro team può supportarti nella migrazione. Contattaci per un'offerta su misura per il tuo progetto.

Richiedi supporto →

PRONTO PER L'IMPLEMENTAZIONE?

Il tuo backend in cinque minuti.

Nessuna carta di credito richiesta · 500 MB gratuiti · 50.000 MAU