从 Firebase 迁移
将 Firestore 数据、 Firebase Auth 用户和存储桶移动到 Aurabase的开放、高性能基础设施的分步指南。
该页面已自动翻译。英文版具有权威性。
匹配 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步路线图#
- 架构和数据 — 选择模型(PostgreSQL 关系或 NoSQL 集合)和导入(15 分钟)
- 身份验证 — 导出 Firebase 身份验证用户并导入 scrypt/bcrypt 哈希值,无需重置(10 分钟)
- 存储文件 — 将 Cloud Storage 存储桶同步到 Aurabase 存储(根据卷而变化)
- SDK 替换 — 将
firebase/*替换为@aurabase/aurabase-js
从 Firestore 到 Aurabase#
您可以规范化 PostgreSQL 中的数据以利用 SQL 和严格类型的强大功能,或者将其直接导入到 Aurabase的 NoSQL 文档存储 引擎中:
注意
路线图 — 不可用。 下面显示的 aura 命令已计划但尚未交付:CLI 目前还没有这些命令。
bash
# 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的密码哈希值,以便用户保留其凭据而无需重置密码。
bash
# 从 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 持续同步文件:
bash
# 从 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#
typescript
// 之前(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()