Vai al contenuto
Logo Aurabase
aurabase

Migra da Firebase

Guida passo passo per spostare i dati Firestore, gli utenti di autenticazione Firebase e i bucket nell'infrastruttura aperta e ad alte prestazioni di Aurabase.

Guida pratica11 min lettoLivello intermedioRevisionato il 19 ago 2026

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

Mattoncini Firebase corrispondenti#

Aurabase sostituisce ciascun componente proprietario Firebase con una tecnologia standard, aperta e di self-hosting senza vincoli di fornitore:

FirebaseConfrontoAurabase equivalente
Cloud FirestoreEquivalente più altoPostgreSQL (relazionale e SQL) o Aurabase NoSQL (stile MongoDB)
Firebase AuthUguale, arricchitoStesso supporto OAuth, oltre a TOTP MFA, collegamenti magici e password
Firebase StorageUguale, arricchitoS3-API REST compatibile (SeaweedFS) con trasformazioni di immagini al volo
Cloud FunctionsLo stessoEdge Functions su standard Deno (Deno.serve()) e WASM
Security RulesSuperiorePostgres RLS (sicurezza a livello di riga), valutato nel database
Firebase Realtime DBLo stessoAurabase Realtime (modifica acquisizione dati, presenza e trasmissione su NATS e WebSocket)

Tabella di marcia in 4 fasi#

  1. Schema e dati — Scelta del modello (raccolte PostgreSQL relazionali o NoSQL) e importazione (15 min)
  2. Autenticazione — Esporta Firebase Autentica gli utenti e importa hash scrypt/bcrypt senza reimpostazione (10 min)
  3. File di archiviazione — Sincronizzazione dei bucket Cloud Storage con Aurabase Storage (variabile in base al volume)
  4. Sostituzione SDK — Sostituzione di firebase/* con @aurabase/aurabase-js

Da Firestore a Aurabase#

Puoi normalizzare i tuoi dati in PostgreSQL per sfruttare la potenza di SQL e la digitazione rigorosa oppure importarli direttamente nel motore NoSQL Document Store di Aurabase:

Attenzione

Roadmap: non disponibile. I comandi aura mostrati di seguito sono pianificati e non ancora consegnati: la CLI ad oggi non li dispone.

import-firestore.shbash
# 1. Esporta Firestore nel file JSONL
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl

# 2. Importa nel motore NoSQL Aurabase
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>

# 3. Generazione di tipi TypeScript completi
npx @aurabase/gen --out src/aurabase.types.ts

Migrazione degli utenti senza intoppi#

Attenzione

Roadmap: non disponibile. Il comando aura auth import e l'importazione degli hash delle password Firebase (scrypt) sono pianificati e non ancora consegnati: la CLI e Aurabase Auth non li hanno ad oggi. Fino ad allora, crea gli utenti con l'API di amministrazione (aura.authAdmin.createUser) e chiedi loro di impostare una nuova password o di accedere con un collegamento magico.

Il piano: mantenere gli hash della password di Firebase in modo che gli utenti mantengano le proprie credenziali senza reimpostare la password.

migrate-auth.shbash
# Esportazione degli utenti dalla CLI Firebase
firebase auth:export users.json --format=JSON --project my-firebase-app

# Importa in Aurabase Auth (conserva hash e token)
aura auth import users.json --provider firebase --env prod

Sincronizzazione dei bucket S3 in corso#

Aurabase Lo spazio di archiviazione utilizza un'API S3 standard. Puoi sincronizzare i tuoi file in modo continuo da Google Cloud Storage con l'utilità rclone o aws-cli:

sync-buckets.shbash
# Trasferimento diretto da GCS a Aurabase Storage
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

Sostituzione dell'SDK client#

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

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

Per andare oltre#