Przejdź do treści
Logo Aurabase
aurabaza

Przewodnik po routerze aplikacji Next.js i SSR

Przewodnik architektoniczny krok po kroku dotyczący integracji Aurabase z aplikacją routera aplikacji Next.js 15/16 ze składnikami serwera, akcjami serwera, oprogramowaniem pośredniczącym i bezpiecznymi sesjami.

Przewodnik krok po kroku10 min przeczytanePoziom mediatorZmieniono 19 sie 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

Model Aurabase SSR#

W nowoczesnych aplikacjach renderowanych po stronie serwera stan uwierzytelnienia użytkownika nie może być przechowywany w localStorage przeglądarki (niedostępny dla serwera). Aurabase automatycznie synchronizuje sesję w bezpiecznych plikach cookie HTTP.

Pełna izolacja zapytań

createServerClient nie ma w pamięci stanu współdzielonego. Każde żądanie serwera tworzy instancję izolowanego klienta podłączonego do nagłówków HTTP żądania, gwarantując absolutną szczelność między użytkownikami (zero ryzyka wycieków sesji).

Router aplikacji z trzema filarami#

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

// Next.js 16: ten plik to `proxy.ts`, a funkcja nosi nazwę `proxy`.
// Next.js 15: nazwij plik `middleware.ts` i funkcję `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
}

Automatyczne zarządzanie Multi-Chunkingiem#

Przeglądarki internetowe ograniczają rozmiar pliku cookie do około 4 KB. Kiedy token JWT lub metadane użytkownika przekraczają ten limit, moduł @aurabase/aurabase-js/ssr automatycznie dzieli obciążenie na kilka ponumerowanych plików cookie:

  • aura-<scope>-auth.0 (pierwsze 3600 bajtów)
  • aura-<scope>-auth.1 (reszta sesji)

Po odczycie serwer wiernie ponownie składa fragmenty, aby przywrócić stan bez utraty danych lub przerwania sesji.

Złote zasady w produkcji#

Atrybuty HttpOnly i SameSite

Pliki cookie tokenu odświeżania nigdy nie powinny być udostępniane JavaScriptowi klienta, aby zapobiec atakom XSS.

Usługa Role Key ściśle serwerowa

NIGDY nie przekazuj swojego AURABASE_SERVICE_ROLE_KEY do createBrowserClient lub komponentów z dyrektywą „use client”.

Odśwież w oprogramowaniu pośrednim

Wywołaj getUser() w proxy (middleware.ts w Next.js 15): odnawia tokeny przed ich wygaśnięciem i pyta serwer, kim jest użytkownik. Nigdy nie autoryzuj żądania serwera za pomocą metody getSession(): na serwerze odczytuje ona jedynie plik cookie, który może sfałszować przeglądarka.

Aby pójść dalej#