Naar de inhoud springen
Aurabase-logo
aurabasis

Migreren van Firebase

Stapsgewijze handleiding voor het verplaatsen van uw Firestore-gegevens, Firebase Auth-gebruikers en buckets naar de open, krachtige infrastructuur van Aurabase.

Handleiding11 min lezenNiveau tussenproductHerzien op 19 aug 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Bijpassende Firebase stenen#

Aurabase vervangt elk eigen Firebase-component door standaard, open, self-hosting technologie zonder leverancierlock-in:

FirebaseVergelijkingAurabase equivalent
Cloud FirestoreHoger equivalentPostgreSQL (relationeel en SQL) of Aurabase NoSQL (MongoDB-stijl)
Firebase AuthHetzelfde, verrijktDezelfde OAuth-ondersteuning, plus TOTP MFA, magische links en wachtwoorden
Firebase StorageHetzelfde, verrijktS3-compatibele REST API (SeaweedFS) met on-the-fly beeldtransformaties
Cloud FunctionsHetzelfdeEdge Functions op standaard Deno (Deno.serve()) en WASM
Security RulesSuperieurPostgres RLS (beveiliging op rijniveau), geëvalueerd in de database
Firebase Realtime DBHetzelfdeAurabase Realtime (wijzig gegevensregistratie, aanwezigheid en uitzending via NATS en WebSockets)

4-stappen stappenplan#

  1. Schema en gegevens — Keuze van model (PostgreSQL relationele of NoSQL-verzamelingen) en import (15 min)
  2. Authenticatie — Exporteer Firebase Auth-gebruikers en importeer scrypt/bcrypt-hashes zonder reset (10 min)
  3. Opslagbestanden — Synchronisatie van Cloud Storage-buckets met Aurabase Opslag (variabel afhankelijk van volume)
  4. SDK-vervanging — Vervanging van firebase/* door @aurabase/aurabase-js

Van Firestore naar Aurabase#

U kunt uw gegevens normaliseren in PostgreSQL om te profiteren van de kracht van SQL en strikt typen, of deze rechtstreeks importeren in de NoSQL Document Store-engine van Aurabase:

Aandacht

Routekaart — niet beschikbaar. De onderstaande aura-opdrachten zijn gepland en nog niet afgeleverd: de CLI heeft ze vandaag niet.

import-firestore.shbash
# 1. Exporteer Firestore naar JSONL-bestand
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl

# 2. Importeer in de Aurabase NoSQL-engine
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>

# 3. Volledige TypeScript-typen genereren
npx @aurabase/gen --out src/aurabase.types.ts

Probleemloze gebruikersmigratie#

Aandacht

Routekaart — niet beschikbaar. De opdracht aura auth import en de import van Firebase wachtwoordhashes (scrypt) zijn gepland en nog niet afgeleverd: de CLI en Aurabase Auth hebben deze vandaag niet. Maak tot die tijd de gebruikers aan met de admin API (aura.authAdmin.createUser) en laat ze een nieuw wachtwoord instellen of inloggen met een magische link.

Het plan: bewaar de wachtwoordhashes van Firebase, zodat gebruikers hun inloggegevens behouden zonder dat hun wachtwoord opnieuw hoeft te worden ingesteld.

migrate-auth.shbash
# Gebruikers exporteren vanuit Firebase CLI
firebase auth:export users.json --format=JSON --project my-firebase-app

# Importeren in Aurabase Auth (behoudt hashes en tokens)
aura auth import users.json --provider firebase --env prod

Synchronisatie van S3-buckets#

Aurabase Opslag gebruikt een standaard S3 API. U kunt uw bestanden continu synchroniseren vanuit Google Cloud Storage met het hulpprogramma rclone of aws-cli:

sync-buckets.shbash
# Directe overdracht van GCS naar Aurabase Opslag
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

De client-SDK vervangen#

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

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

Om verder te gaan#