Ir para o conteúdo
Aura Logo
aurabase

Migrar de Firebase

Guia passo a passo para mover dados do Firestore, usuários do Firebase Auth e buckets para a infraestrutura aberta e de alto desempenho do Aurabase.

Guia prático11 min lidoNível intermediárioRevisado em 19 de ago. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Tijolos Firebase correspondentes#

Aurabase substitui cada componente proprietário Firebase por tecnologia padrão, aberta e de auto-hospedagem, sem dependência de fornecedor:

FirebaseComparaçãoAurabase equivalente
Cloud FirestoreEquivalente superiorPostgreSQL (relacional e SQL) ou Aurabase NoSQL (estilo MongoDB)
Firebase AuthIgual, enriquecidoMesmo suporte OAuth, mais TOTP MFA, links mágicos e senhas
Firebase StorageIgual, enriquecidoAPI REST compatível com S3(SeaweedFS) com transformações de imagem dinâmicas
Cloud FunctionsIgualEdge Functions no padrão Deno (Deno.serve()) e WASM
Security RulesSuperiorPostgres RLS (segurança em nível de linha), avaliada no banco de dados
Firebase Realtime DBIgualAurabase Tempo real (alterar captura de dados, presença e transmissão por NATS e WebSockets)

Roteiro de 4 etapas#

  1. Esquema e Dados — Escolha do modelo (coleções PostgreSQL relacionais ou NoSQL) e importação (15 min)
  2. Autenticação — Exporte usuários Firebase Auth e importe hashes scrypt/bcrypt sem redefinir (10 min)
  3. Arquivos de armazenamento — Sincronização de buckets do Cloud Storage com o armazenamento Aurabase (variável dependendo do volume)
  4. Substituição do SDK — Substituindo firebase/* por @aurabase/aurabase-js

Do Firestore para Aurabase#

Você pode normalizar seus dados em PostgreSQL para aproveitar o poder do SQL e a digitação estrita ou importá-los diretamente para o mecanismo NoSQL Document Store de Aurabase:

Atenção

Roteiro — não disponível. Os comandos aura mostrados abaixo estão planejados e ainda não foram entregues: a CLI não os possui hoje.

import-firestore.shbash
# 1. Exporte o Firestore para arquivo JSONL
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl

# 2. Importe para o mecanismo NoSQL Aurabase
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>

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

Migração de usuários sem complicações#

Atenção

Roteiro — não disponível. O comando aura auth import e a importação de hashes de senha Firebase (scrypt) estão planejados e ainda não foram entregues: a CLI e o Aurabase Auth não os possuem hoje. Até então, crie os usuários com a API admin (aura.authAdmin.createUser) e faça com que definam uma nova senha ou façam login com um link mágico.

O plano: manter os hashes de senha de Firebase para que os usuários mantenham suas credenciais sem redefinir a senha.

migrate-auth.shbash
# Exportando usuários da CLI Firebase
firebase auth:export users.json --format=JSON --project my-firebase-app

# Importe para Aurabase Auth (preserva hashes e tokens)
aura auth import users.json --provider firebase --env prod

Sincronizando intervalos S3#

Aurabase O armazenamento usa uma API S3 padrão. Você pode sincronizar seus arquivos continuamente do Google Cloud Storage com o utilitário rclone ou aws-cli:

sync-buckets.shbash
# Transferência direta do GCS para o armazenamento 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

Substituindo o SDK do cliente#

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

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

Para ir mais longe#