跳到内容
光环标志
光环基地

从 Firebase 迁移

将 Firestore 数据、 Firebase Auth 用户和存储桶移动到 Aurabase的开放、高性能基础设施的分步指南。

操作指南11分钟 读取级别 中间修改于 2026年8月19日

该页面已自动翻译。英文版具有权威性。

匹配 Firebase 砖块#

Aurabase 使用标准、开放、自托管技术替换每个专有的 Firebase 组件,无需供应商锁定:

Firebase比较Aurabase 等价物
Cloud Firestore更高等值PostgreSQL(关系型和 SQL)或 Aurabase NoSQL(MongoDB 样式)
Firebase Auth一样,丰富相同的 OAuth 支持,加上 TOTP MFA、魔术链接和密码
Firebase Storage一样,丰富S3- 兼容 REST API (SeaweedFS),具有动态图像转换功能
Cloud Functions一样标准 Deno (Deno.serve()) 和 WASM 上的 Edge Functions
Security Rules高级Postgres RLS(行级安全性),在数据库中评估
Firebase Realtime DB一样Aurabase 实时(通过 NATS 和 WebSocket 更改数据捕获、存在和广播)

4步路线图#

  1. 架构和数据 — 选择模型(PostgreSQL 关系或 NoSQL 集合)和导入(15 分钟)
  2. 身份验证 — 导出 Firebase 身份验证用户并导入 scrypt/bcrypt 哈希值,无需重置(10 分钟)
  3. 存储文件 — 将 Cloud Storage 存储桶同步到 Aurabase 存储(根据卷而变化)
  4. SDK 替换 — 将 firebase/* 替换为 @aurabase/aurabase-js

从 Firestore 到 Aurabase#

您可以规范化 PostgreSQL 中的数据以利用 SQL 和严格类型的强大功能,或者将其直接导入到 Aurabase的 NoSQL 文档存储 引擎中:

注意

路线图 — 不可用。 下面显示的 aura 命令已计划但尚未交付:CLI 目前还没有这些命令。

import-firestore.shbash
# 1.将Firestore导出为JSONL文件
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl

# 2.导入Aurabase NoSQL引擎
aura db nosql-import firestore-export.jsonl --collection users --project-id <id>

# 3. 生成完整的TypeScript类型
npx @aurabase/gen --out src/aurabase.types.ts

无摩擦的用户迁移#

注意

路线图 — 不可用。 aura auth import 命令和 Firebase 密码哈希 (scrypt) 的导入已计划但尚未交付:CLI 和 Aurabase Auth 目前还没有它们。在此之前,使用管理 API (aura.authAdmin.createUser) 创建用户并让他们设置新密码或使用魔术链接登录。

计划:保留 Firebase的密码哈希值,以便用户保留其凭据而无需重置密码。

migrate-auth.shbash
# 从 Firebase CLI 导出用户
firebase auth:export users.json --format=JSON --project my-firebase-app

# 导入 Aurabase Auth(保留哈希值和令牌)
aura auth import users.json --provider firebase --env prod

同步 S3 存储桶#

Aurabase 存储使用标准 S3 API。您可以使用 rclone 或 aws-cli 实用程序从 Google Cloud Storage 持续同步文件:

sync-buckets.shbash
# 从 GCS 直接传输到 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

更换客户端SDK#

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

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

为了走得更远#