НОВЫЙPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Посмотреть список изменений →

Инженерное дело · 6 минута чтения

Перенесите Supabase на Aurabase, сохраните свой RLS.

Affane Daylami · Fondateur · 20 сентября 2026 г.

Вернуться в блог

Если вы находитесь на Supabase и присматриваетесь к Aurabase (см. наше подробное сравнение), хорошая новость заключается в том, что самое сложное — это выбор. В таблице ниже точно перечислены изменения при миграции — и она короткая: схема, политики RLS, SDK, аутентификация и хранилище остаются прежними.

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

В Aurabase мы наложили на себя жесткое ограничение на этапе проектирования: поверхность SDK и соглашения RLS должны были быть совместимыми с и Supabase. Те же createClient(), те же .from().select().eq(), те же политики SQL Postgres. Идея: хочешь уйти — уходи — мы делаем это тривиально. Вот полная книга.

#
Предварительный аудит

Что движется, что остается

Прежде чем начать, составьте список того, что изменится, а что останется. Спойлер: большинство осталось.

Postgres СхемаТАКОЙ ЖЕpg_dump → pg_restore. Расширения, триггеры, функции, индексы — всё подходит.
RLS ПолитикиТАКОЙ ЖЕТот же синтаксис. auth.uid(), auth.role(), auth.jwt() работают как есть.
JavaScript SDK95% ИДЕНТИЧНОСТЬЗамените @supabase/supabase-js на @aurabase/aurabase-js. Тот же цепной API.
Потоки аутентификацииТАКОЙ ЖЕSignUp, SignInWithPassword, SignInWithOAuth, mfa — те же имена, те же подписи.
API хранилищаТАКОЙ ЖЕaura.storage.from(bucket).upload(...) · совместимые S3 · передаваемые политики RLS.
В реальном времениТАКОЙ ЖЕChannel().on("postgres_changes", ...) без изменений. Присутствие + трансляция то же самое.
Edge FunctionsТАКОЙ ЖЕDeno.serve() вставлен в редактор Studio как есть. В CLI будут развертываться функции, предназначенные для отдельного пути (Rust скомпилирован в WASM).
Панель управленияДРУГОЙСтудия Aurabase · мы поможем вам сориентироваться.
#
Шаг 1

Создайте целевой проект Aurabase.

Создайте новый проект Aurabase с помощью официального интерфейса командной строки, затем свяжите эту папку с проектом, чтобы следующие команды применялись к нему автоматически.

terminalbash
# учетная запись Aurabase + CLI
npm i -g @aurabase/cli
aura login

# Создайте проект (движок Postgres)
aura projects create my-app --engine postgres

# Свяжите эту папку с созданным проектом
aura link --project-id <uuid-du-projet>

# Получить ключи API связанного проекта
aura projects api-keys
#
Шаг 2

Дамп Supabase, восстановление Aurabase

Стандартный pg_dump / pg_restore: Aurabase предоставляет прямую строку подключения Postgres для каждого проекта (Студия → Настройки → Соединение), нет необходимости в промежуточном преобразовании.

terminalbash
# Получите строку подключения Supabase со своей панели управления.
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"

# Дамп общедоступной схемы (без системных схем Supabase)
pg_dump "$SUPABASE_DB_URL" \
  --schema=public \
  --no-owner --no-acl \
  --format=custom \
  -f supabase-dump.pgdump

# Получить строку подключения Aurabase (Студия → Настройки → Соединение).
# Параметр ?search_path= ОБЯЗАТЕЛЬНЫЙ: он направляет к схеме вашего проекта.
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"

# Восстановить стандартным pg_restore
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump

# Восстановить типы TypeScript
aura db generate > src/aurabase.types.ts
#
Шаг 3

Миграция пользователей

Следует исправить по сравнению с тем, что мы говорили здесь ранее: Aurabase хеширует пароли с Argon2id, но Supabase (GoTrue) по умолчанию хеширует свои собственные с bcrypt — эти два формата не являются взаимозаменяемыми. Поэтому вашим пользователям придется один раз сбросить свой пароль, как и в большинстве случаев миграции.

Aurabase в настоящее время не предлагает инструмент массового импорта из Supabase. Два варианта: позволить вашим пользователям перерегистрироваться (signUp с тем же адресом электронной почты) или заново создать их по одному на стороне администратора с помощью aura auth users create --email <email> перед запуском сброса пароля.

Информация

Активные сессии на стороне Supabase не портируются (технически невозможно — каждая платформа подписывает свои JWT своим ключом). Пользователям необходимо будет снова войти в систему с новым паролем.

#
Шаг 4

Адаптируйте клиентский код

Поиска/замены достаточно в 95% случаев.

lib/supabase.ts → lib/aurabase.tstypescript
// ДО (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)

// ПОСЛЕ (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)

// Остальная часть кода не меняется:
await aura.from('posts').select('*').eq('author_id', userId)
#
Шаг 5

Развертывание Edge Functions

Aurabase предлагает два пути для Edge Functions: редактор кода Studio (среда выполнения Deno, такая же, как Supabase — вставьте свою функцию как есть) и aura functions deployCLI, который предназначен для отдельного пути для функций, написанных на Rust и скомпилированных в WASM. Чтобы перенести существующий код Deno без переписывания, используйте Studio.

functions/hello/index.tstypescript
// Работает так же, вставлено в редактор Studio как есть.
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(JSON.stringify({ hello: name }))
})
#
переключение

Переключение DNS и запуск производства

Две возможные стратегии. Первое рекомендуется в 99% случаев.

  1. Прямое переключение — измените NEXT_PUBLIC_AURABASE_URL и NEXT_PUBLIC_AURABASE_ANON_KEY в переменных окружения, повторно разверните. Пользователи переподключаются, все работает. Рекомендуется для большинства проектов.
  2. Временная двойная запись — записывайте Supabase + Aurabase одновременно в течение 48 часов, проверьте согласованность критических таблиц вручную (подсчет строк, контрольные суммы), затем выключите Supabase. Предпочтительно для критически важных приложений.
#
Помощь

Мы здесь, если что-то застрянет

Для крупных проектов или со строгими ограничениями соответствия наша команда может помочь вам с миграцией. Свяжитесь с нами для получения предложения, адаптированного к вашему проекту.

Запросить поддержку →

ГОТОВЫ К РАЗВЕРТЫВАНИЮ?

Ваш бэкэнд за пять минут.

Кредитная карта не требуется · 500 МБ бесплатно · 50 000 MAU