Saltar al contenido
Logotipo de Aurabase
aurabase

Migrar desde Firebase

Guía paso a paso para mover los datos de Firestore, los usuarios de autenticación de Firebase y los depósitos a la infraestructura abierta y de alto rendimiento de Aurabase.

Guía práctica11 min leerNivel intermedioRevisado el 19 ago 2026

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

Combinando ladrillos Firebase#

Aurabase reemplaza cada componente propietario Firebase con tecnología estándar, abierta y de autohospedaje sin dependencia del proveedor:

FirebaseComparaciónAurabase equivalente
Cloud FirestoreEquivalente superiorPostgreSQL (relacional y SQL) o Aurabase NoSQL (estilo MongoDB)
Firebase AuthIgual, enriquecidoMismo soporte OAuth, más TOTP MFA, enlaces mágicos y contraseñas
Firebase StorageIgual, enriquecidoAPI REST compatible con S3(SeaweedFS) con transformaciones de imágenes sobre la marcha
Cloud FunctionsLo mismoEdge Functions en estándar Deno (Deno.serve()) y WASM
Security RulessuperioresPostgres RLS (seguridad a nivel de fila), evaluada en la base de datos
Firebase Realtime DBLo mismoAurabase Tiempo real (captura, presencia y transmisión de datos de cambios a través de NATS y WebSockets)

Hoja de ruta de 4 pasos#

  1. Esquema y datos: elección del modelo (PostgreSQL colecciones relacionales o NoSQL) e importación (15 min)
  2. Autenticación — Exportar Firebase Autenticar usuarios e importar hashes scrypt/bcrypt sin restablecer (10 min)
  3. Archivos de almacenamiento: sincronización de depósitos de Cloud Storage con el almacenamiento Aurabase (variable según el volumen)
  4. Reemplazo de SDK — Reemplazo de firebase/* con @aurabase/aurabase-js

De Firestore a Aurabase#

Puede normalizar sus datos en PostgreSQL para aprovechar el poder de SQL y la escritura estricta, o importarlos directamente al motor NoSQL Document Store de Aurabase:

Atención

Hoja de ruta: no disponible. Los comandos aura que se muestran a continuación están planificados y aún no se han entregado: la CLI no los tiene en la actualidad.

import-firestore.shbash
# 1. Exportar Firestore a un archivo JSONL
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl

# 2. Importar al motor NoSQL Aurabase
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>

# 3. Generando tipos TypeScript completos
npx @aurabase/gen --out src/aurabase.types.ts

Migración de usuarios sin fricciones#

Atención

Hoja de ruta: no disponible. El comando aura auth import y la importación de hash de contraseña Firebase (scrypt) están planificados y aún no se entregan: la CLI y la autenticación Aurabase no los tienen hoy. Hasta entonces, cree los usuarios con la API de administración (aura.authAdmin.createUser) y pídales que establezcan una nueva contraseña o inicien sesión con un enlace mágico.

El plan: mantener los hashes de contraseña de Firebase para que los usuarios conserven sus credenciales sin restablecer la contraseña.

migrate-auth.shbash
# Exportar usuarios desde Firebase CLI
firebase auth:export users.json --format=JSON --project my-firebase-app

# Importar a Aurabase Auth (conserva hashes y tokens)
aura auth import users.json --provider firebase --env prod

Sincronizando depósitos S3#

Aurabase Storage utiliza una API S3 estándar. Puedes sincronizar tus archivos continuamente desde Google Cloud Storage con la utilidad rclone o aws-cli:

sync-buckets.shbash
# Transferencia directa desde GCS al almacenamiento Aurabase
rclone sync gcs:my-firebase-bucket s3:aurabase-storage-bucket \
  --s3-endpoint https://api.aurabase.cloud/v1/storage/$PROJECT_ID \
  --s3-access-key-id $AURABASE_SERVICE_ROLE_KEY \
  --progress

Reemplazo del SDK del cliente#

comparison.tstypescript
// ANTES (Firebase)
import { getFirestore, doc, getDoc } from 'firebase/firestore'
const snap = await getDoc(doc(db, 'users', 'u1'))
const user = snap.data()

// DESPUÉS (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
const { data: user } = await aura.from('users').select('*').eq('id', 'u1').single()

para ir más lejos#