شعار أوراباسي
aurabaseمستندات
مستندات›أدلة›جهاز توجيه التطبيق Next.js وSSR

Next.js App Router ودليل SSR

دليل معماري خطوة بخطوة لدمج Aurabase في تطبيق Next.js 14/15 App Router مع مكونات الخادم وإجراءات الخادم والبرامج الوسيطة والجلسات الآمنة.

10 د قراءة·المستوى وسيطة·تمت المراجعة في 19‏/08‏/2026
تم إنشاء هذا النص الإنجليزي تلقائيًا من النص الأصلي الفرنسي ولم تتم مراجعته بعد.
تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.
#
الهندسة المعمارية

نموذج Aurabase SSR

في التطبيقات الحديثة المقدمة من جانب الخادم، لا يمكن تخزين حالة مصادقة المستخدم في localStorage الخاص بالمتصفح (لا يمكن الوصول إليها بواسطة الخادم). يقوم Aurabase تلقائيًا بمزامنة الجلسة في ملفات تعريف الارتباط الآمنة HTTP.

عزل الاستعلام الكامل

createServerClient بدون حالة مشتركة في الذاكرة. يقوم كل طلب خادم بإنشاء مثيل لعميل معزول متصل برؤوس HTTP الخاصة بالطلب، مما يضمن الترابط المطلق بين المستخدمين (صفر خطر تسرب الجلسة).

#
التنفيذ

جهاز توجيه التطبيقات ذو الركائز الثلاث

src/middleware.tstypescript
import { createServerClient } from '@aurabase/aurabase-js/ssr'
import { NextResponse, type NextRequest } from 'next/server'

export async function middleware(request: NextRequest) {
  let response = NextResponse.next({ request })
  const aura = createServerClient(
    process.env.NEXT_PUBLIC_AURA_URL!,
    process.env.NEXT_PUBLIC_AURA_ANON_KEY!,
    {
      cookies: {
        getAll() { return request.cookies.getAll() },
        setAll(cookies) {
          cookies.forEach(({ name, value, options }) => {
            request.cookies.set(name, value)
            response.cookies.set(name, value, options)
          })
        },
      },
    })

  const { user } = await aura.auth.getUser()
  if (!user && request.nextUrl.pathname.startsWith('/dashboard')) {
    return NextResponse.redirect(new URL('/login', request.url))
  }
  return response
}
#
ملفات تعريف الارتباط

الإدارة التلقائية للقطع المتعددة

تحدد متصفحات الويب حجم ملف تعريف الارتباط بحوالي 4 كيلو بايت. عندما يتجاوز رمز JWT أو بيانات تعريف المستخدم هذا الحد، تقوم الوحدة @aurabase/aurabase-js/ssr تلقائيًا بتقسيم التحميل إلى عدة ملفات تعريف ارتباط مرقمة:

  • aura-[project_id]-auth.0 (أول 3600 بايت)
  • aura-[project_id]-auth.1 (بقية الجلسة)

عند القراءة، يقوم الخادم بإعادة تجميع القطع بأمانة من أجل استعادة الحالة دون أي فقدان للبيانات أو انقطاع الجلسة.

#
الأمن

القواعد الذهبية في الإنتاج

سمات HttpOnly وSameSite

لا ينبغي أبدًا عرض ملفات تعريف الارتباط المميزة لجافا سكريبت للعميل لمنع هجمات XSS.

خدمة مفتاح الدور بدقة الخادم

لا تقم أبدًا بتمرير SERVICE_ROLE_KEY الخاص بك إلى createBrowserClient أو المكونات باستخدام توجيه "استخدام العميل".

تحديث في الوسيطة

اتصل دائمًا بـ getSession() أو getUser() في البرنامج الوسيط لتجديد الرموز المميزة قبل انتهاء صلاحيتها.