جديد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() تعمل كما هي.
جافا سكريبت SDK95% متطابقةاستبدل @supabase/supabase-js بـ @aurabase/aurabase-js. نفس واجهة برمجة التطبيقات القابلة للتسلسل.
تدفقات المصادقةنفسهSignUp، وsignInWithPassword، وsignInWithOAuth، وmfa - نفس الأسماء، ونفس التوقيعات.
واجهة برمجة تطبيقات التخزيننفسهaura.storage.from(bucket).upload(...) · متوافق مع S3 · سياسات RLS قابلة للتحويل.
الوقت الحقيقينفسهالقناة ().on ("postgres_changes"، ...) لم تتغير. حضور + بث نفس الشيء .
Edge FunctionsنفسهDeno.serve() تم لصقه كما هو في محرر الاستوديو. سيكون لواجهة سطر الأوامر (CLI) وظائف منتشرة تستهدف مسارًا منفصلاً (Rust تم تجميعها إلى WASM).
لوحة القيادةمختلفةستوديو Aurabase · نساعدك في العثور على اتجاهاتك.
#
الخطوة 1

قم بإنشاء المشروع Aurabase الهدف

أنشئ مشروع Aurabase جديد باستخدام واجهة سطر الأوامر الرسمية، ثم اربط هذا المجلد بالمشروع بحيث تنطبق عليه الأوامر التالية تلقائيًا.

terminalbash
# Aurabase حساب + واجهة سطر الأوامر
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 لكل مشروع (Studio → الإعدادات → Connection)، دون الحاجة إلى تحويل وسيط.

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 (مستحيل تقنيًا - تقوم كل منصة بتوقيع JWTs الخاصة بها بمفتاحها الخاص). سيحتاج المستخدمون إلى تسجيل الدخول مرة أخرى باستخدام كلمة المرور الجديدة.

#
الخطوة 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: محرر كود الاستوديو (وقت تشغيل Deno، مثل Supabase - الصق وظيفتك كما هي) وaura functions deployCLI، الذي يهدف إلى إنشاء مسار منفصل للوظائف المكتوبة في Rust والمجمعة في WASM. لترحيل كود Deno الموجود دون إعادة كتابته، استخدم Studio.

functions/hello/index.tstypescript
// يعمل بنفس الطريقة، ويتم لصقه كما هو في محرر الاستوديو
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 في env vars، وأعد النشر. إعادة الاتصال للمستخدمين، ويعمل كل شيء. الموصى بها لغالبية المشاريع.
  2. الكتابة المزدوجة المؤقتة - اكتب Supabase + Aurabase في وقت واحد لمدة 48 ساعة، وتحقق من تناسق الجداول المهمة يدويًا (عد الصفوف، المجاميع الاختبارية)، ثم قم بإيقاف تشغيل Supabase. المفضل للتطبيقات الهامة.
#
مساعدة

نحن هنا إذا تعطلت الأمور

بالنسبة للمشاريع الكبيرة أو ذات قيود الامتثال الصارمة، يمكن لفريقنا تقديم الدعم لك في عملية الترحيل. اتصل بنا للحصول على عرض مخصص لمشروعك.

طلب الدعم →

هل أنت جاهز للنشر؟

الواجهة الخلفية الخاصة بك في خمس دقائق.

لا حاجة لبطاقة ائتمان · 500 ميجابايت مجانًا · 50000 MAU