NUEVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Ver el registro de cambios →

Ingeniería · 6 lectura mínima

Migre Supabase a Aurabase, conserve su RLS

Affane Daylami · Fondateur · 20 de septiembre de 2026

volver al blog

Si está en Supabase y está considerando Aurabase (consulte nuestra comparación detallada), la buena noticia es que la parte más difícil es elegir. La siguiente tabla enumera con precisión los cambios en una migración, y es breve: el esquema, las políticas RLS, el SDK, la autenticación y el almacenamiento siguen siendo los mismos.

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

En Aurabase, nos impusimos una fuerte restricción desde la etapa de diseño: la superficie del SDK y las convenciones RLS tenían que ser compatibles directamente con con Supabase. Mismas createClient(), mismas .from().select().eq(), mismas políticas SQL Postgres. La idea: si quieres irte, vete; lo hacemos trivial. Aquí está el libro de jugadas completo.

#
Auditoría previa

Lo que se mueve, lo que se queda

Antes de comenzar, enumere lo que cambiará y lo que permanecerá. Spoiler: la mayoría permanece.

Postgres EsquemaMISMOpg_dump → pg_restore. Extensiones, activadores, funciones, índices: todo vale.
RLS PolíticasMISMOMisma sintaxis. auth.uid(), auth.role(), auth.jwt() funcionan como están.
SDK de JavaScript95% IDÉNTICOReemplace @supabase/supabase-js con @aurabase/aurabase-js. Misma API encadenable.
Flujos de autenticaciónMISMOsignUp, signInWithPassword, signInWithOAuth, mfa: mismos nombres, mismas firmas.
API de almacenamientoMISMOaura.storage.from(bucket).upload(...) · compatible S3 · políticas transferibles RLS.
En tiempo realMISMOcanal().on("postgres_changes", ...) sin cambios. Presencia + retransmisión igual.
Edge FunctionsMISMODeno.serve() pegado tal cual en el editor de Studio. La CLI tendrá funciones implementadas dirigidas a una ruta separada (Rust compilada en WASM).
Panel de controlDIFERENTEEstudio Aurabase · te ayudamos a orientarte.
#
Paso 1

Cree el proyecto de destino Aurabase

Cree un nuevo proyecto Aurabase con la CLI oficial, luego vincule esta carpeta al proyecto para que los siguientes comandos se apliquen automáticamente.

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

# Crear el proyecto (motor Postgres)
aura projects create my-app --engine postgres

# Vincular esta carpeta al proyecto creado
aura link --project-id <uuid-du-projet>

# Recuperar las claves API del proyecto vinculado
aura projects api-keys
#
Paso 2

Volcar Supabase, restaurar Aurabase

Un pg_dump / pg_restore: Aurabase estándar expone una cadena de conexión Postgres directa para cada proyecto (Estudio → Configuración → Conexión), sin necesidad de transformación intermedia.

terminalbash
# Recupere la cadena de conexión Supabase de su panel
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"

# Volcado de esquema público (sin esquemas del sistema Supabase)
pg_dump "$SUPABASE_DB_URL" \
  --schema=public \
  --no-owner --no-acl \
  --format=custom \
  -f supabase-dump.pgdump

# Recuperar la cadena de conexión Aurabase (Estudio → Configuración → Conexión)
# El parámetro ?search_path= es OBLIGATORIO: dirige al esquema de su proyecto
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"

# Restaurar con pg_restore estándar
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump

# Regenerar tipos TypeScript
aura db generate > src/aurabase.types.ts
#
Paso 3

Migrar usuarios

Un punto a corregir en comparación con lo que indicamos aquí anteriormente: Aurabase codifica contraseñas con Argon2id, pero Supabase (GoTrue) codifica las suyas de forma predeterminada con bcrypt: los dos formatos no son intercambiables. Por lo tanto, sus usuarios tendrán que restablecer su contraseña una vez, como ocurre con la mayoría de las migraciones.

Aurabase actualmente no ofrece una herramienta de importación masiva desde Supabase. Dos opciones: permitir que sus usuarios se vuelvan a registrar (signUp con la misma dirección de correo electrónico) o volver a crearlos uno por uno en el lado del administrador con aura auth users create --email <email> antes de activar un restablecimiento de contraseña.

Información

Las sesiones activas en el lado Supabase no se transfieren (técnicamente imposible: cada plataforma firma sus JWT con su propia clave). Los usuarios deberán iniciar sesión nuevamente con su nueva contraseña.

#
Paso 4

Adaptar el código del cliente

Una búsqueda/reemplazo es suficiente en el 95% de los casos.

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

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

// El resto del código no cambia:
await aura.from('posts').select('*').eq('author_id', userId)
#
Paso 5

Implementar Edge Functions

Aurabase ofrece dos rutas para Edge Functions: el editor de código Studio (tiempo de ejecución Deno, igual que Supabase: pegue su función tal como está) y la CLI aura functions deploy, que apunta a una ruta separada para funciones escritas en Rust y compiladas en WASM. Para migrar el código Deno existente sin reescribirlo, utilice Studio.

functions/hello/index.tstypescript
// Funciona igual, pegado tal cual en el editor de Studio.
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(JSON.stringify({ hello: name }))
})
#
transición

Cambio de DNS y lanzamiento de producción

Dos posibles estrategias. La primera se recomienda para el 99% de los casos.

  1. Transferencia directa: cambie NEXT_PUBLIC_AURABASE_URL y NEXT_PUBLIC_AURABASE_ANON_KEY en sus variables de entorno, vuelva a implementar. Los usuarios se vuelven a conectar, todo funciona. Recomendado para la mayoría de proyectos.
  2. Escritura dual temporal: escriba Supabase + Aurabase simultáneamente durante 48 horas, verifique la coherencia de las tablas críticas manualmente (recuento de filas, sumas de verificación) y luego apague Supabase. Preferido para aplicaciones críticas.
#
Ayuda

Estamos aquí si las cosas se atascan

Para proyectos grandes o con estrictas restricciones de cumplimiento, nuestro equipo puede ayudarlo con la migración. Contáctenos para una oferta adaptada a su proyecto.

Solicitar soporte →

¿LISTO PARA IMPLEMENTAR?

Su backend en cinco minutos.

No se requiere tarjeta de crédito · 500 MB gratis · 50,000 MAU