Перейти к содержимому
Логотип Аурабаза
аурабаза

Миграция с Firebase

Пошаговое руководство по перемещению данных Firestore, пользователей Firebase Auth и сегментов в открытую высокопроизводительную инфраструктуру Aurabase.

Практическое руководство11 мин читатьУровень среднийПересмотрено 19 авг. 2026 г.

Эта страница была переведена автоматически. Английская версия является авторитетной.

Соответствующие кирпичи 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Такой жеEdge Functions на стандартных Deno (Deno.serve()) и WASM
Security RulesНачальствоPostgres RLS (безопасность на уровне строк), оценивается в базе данных
Firebase Realtime DBТакой жеAurabase Realtime (сбор данных, присутствие и трансляция изменений через NATS и WebSockets)

4-шаговая дорожная карта#

  1. Схема и данные — Выбор модели (реляционная коллекция PostgreSQL или коллекции NoSQL) и импорт (15 минут)
  2. Аутентификация — экспорт Firebase аутентификации пользователей и импорт хэшей scrypt/bcrypt без сброса (10 минут)
  3. Файлы хранилища — Синхронизация сегментов облачного хранилища с хранилищем Aurabase (зависит от объема)
  4. Замена SDK — Замена firebase/* на @aurabase/aurabase-js

Из Firestore в Aurabase#

Вы можете либо нормализовать свои данные в PostgreSQL, чтобы воспользоваться преимуществами SQL и строгой типизации, либо импортировать их непосредственно в механизм NoSQL Document Store Aurabase:

Внимание

Дорожная карта — недоступна. Команды aura, показанные ниже, запланированы и еще не доставлены: в CLI их сегодня нет.

import-firestore.shbash
# 1. Экспортируйте Firestore в файл JSONL.
npx firestore-export --serviceAccount credentials.json --output firestore-export.jsonl

# 2. Импортируйте в NoSQL-движок Aurabase.
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 Storage использует стандартный API S3. Вы можете постоянно синхронизировать файлы из Google Cloud Storage с помощью утилиты rclone или aws-cli:

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()

Чтобы пойти дальше#