انتقل إلى المحتوى
شعار أوراباسي
aurabase

Next.js App Router ودليل SSR

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

دليل عملي10 د قراءةالمستوى وسيطةتمت المراجعة في 19‏/08‏/2026

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

نموذج Aurabase SSR#

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

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

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

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

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

// Next.js 16: هذا الملف هو `proxy.ts` والدالة تسمى `proxy`.
// Next.js 15: قم بتسمية الملف "middleware.ts" والوظيفة "middleware".
export async function proxy(request: NextRequest) {
  const response = NextResponse.next({ request })
  const aura = createServerClient(
    process.env.NEXT_PUBLIC_AURABASE_URL!,
    process.env.NEXT_PUBLIC_AURABASE_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 { data: 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-<scope>-auth.0 (أول 3600 بايت)
  • aura-<scope>-auth.1 (بقية الجلسة)

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

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

سمات HttpOnly وSameSite

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

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

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

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

اتصل بـ getUser() في الوكيل (middleware.ts في Next.js 15): يقوم بتجديد الرموز المميزة قبل انتهاء صلاحيتها ويسأل الخادم عن هوية المستخدم. لا تسمح مطلقًا بطلب خادم باستخدام getSession(): على الخادم، يقرأ فقط ملف تعريف الارتباط، الذي يمكن للمتصفح تزويره.

للذهاب أبعد من ذلك#