Перейти к содержимому
Логотип Аурабаза
аурабаза

Маршрутизатор приложений Next.js и руководство по SSR

Пошаговое архитектурное руководство по интеграции Aurabase в приложение Next.js 15/16 App Router с серверными компонентами, действиями сервера, промежуточным программным обеспечением и безопасными сеансами.

Практическое руководство10 мин читатьУровень среднийПересмотрено 19 авг. 2026 г.

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

Модель Aurabase SSR#

В современных приложениях, отображаемых на стороне сервера, состояние аутентификации пользователя не может храниться в localStorage браузера (недоступно для сервера). Aurabase автоматически синхронизирует сеанс в безопасных файлах cookie HTTP.

Полная изоляция запросов

createServerClient не имеет общего состояния в памяти. Каждый запрос сервера создает экземпляр изолированного клиента, подключенного к HTTP-заголовкам запроса, гарантируя абсолютную герметичность между пользователями (нулевой риск утечки сеанса).

Три столпа App Router#

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
}

Автоматическое управление многофрагментацией#

Веб-браузеры ограничивают размер файла cookie примерно 4 КБ. Когда токен JWT или метаданные пользователя превышают этот предел, модуль @aurabase/aurabase-js/ssr автоматически разделяет нагрузку на несколько пронумерованных файлов cookie:

  • aura-<scope>-auth.0 (первые 3600 байт)
  • aura-<scope>-auth.1 (оставшаяся часть сеанса)

После чтения сервер добросовестно собирает фрагменты, чтобы восстановить состояние без потери данных или прерывания сеанса.

Золотые правила в производстве#

Атрибуты HttpOnly и SameSite

Файлы cookie токена обновления никогда не должны предоставляться клиентскому JavaScript для предотвращения XSS-атак.

Служба ролевых ключей строго серверная

НИКОГДА не передавайте свой AURABASE_SERVICE_ROLE_KEY в createBrowserClient или компоненты с директивой «use client».

Обновление в промежуточном программном обеспечении

Вызовите getUser() в прокси-сервере (middleware.ts в Next.js 15): он обновляет токены до истечения срока их действия и спрашивает сервер, кто является пользователем. Никогда не авторизуйте запрос к серверу с помощью getSession(): на сервере он только считывает файлы cookie, которые браузер может подделать.

Чтобы пойти дальше#