Перейти к содержимому
supastack
Обзор документации
WebNext.js

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/web/provider-keys.md (or send Accept: text/markdown).

Соберите остальные ключи провайдеров

Короткие прохождения для оставшихся сервисов: AI-провайдеры, Trigger.dev, хранилище S3, Sentry или PostHog, Turnstile и ваш домен.

Задать вопрос об этом руководстве
Открыть в

Как пользоваться этой страницей

Каждый раздел ниже — одно полное прохождение настройки: создайте аккаунт, найдите ключ, установите имена env, проверьте. Берите только разделы для сервисов, которые поставляет ваш продукт — сайту без AI-функций первый никогда не нужен, и комплект продолжает работать со всеми пропущенными здесь разделами.

Те же правила секретов, что и везде: API-ключи и секреты webhook остаются только на сервере, только значения с префиксом NEXT_PUBLIC_/EXPO_PUBLIC_ могут достигать клиента, продакшен-секреты живут в хранилище секретов хоста, а dev-сервер перечитывает env только при перезапуске.

Ключи AI-провайдеров

AI_PROVIDER комплекта принимает openai, anthropic, openai-compatible и openrouter — плюс fake, локальную замену по умолчанию. Выберите одну; ключ провайдера — единственный нужный аккаунт, потому что id моделей и цены приходят из каталога базы данных комплекта, а не из env-переменных.

OpenAI: platform.openai.com → API keys → Create new secret key → скопируйте sk-… → OPENAI_API_KEY. Anthropic: console.anthropic.com → API Keys → Create Key → sk-ant-… → ANTHROPIC_API_KEY. Оба биллят за токен — несколько долларов кредита покрывают разработку.

OpenRouter маршрутизирует каждую модель каталога через один ключ: openrouter.ai → Keys → Create Key → sk-or-… → AI_PROVIDER=openrouter плюс OPENROUTER_API_KEY; необязательные OPENROUTER_APP_NAME/OPENROUTER_SITE_URL отправляют заголовки атрибуции. openai-compatible покрывает любой endpoint в форме OpenAI: OPENAI_COMPATIBLE_API_KEY плюс OPENAI_COMPATIBLE_BASE_URL.

Проверьте: перезапустите, запустите одну AI-задачу и ожидайте реальный ответ модели вместо детерминированного фейка. Ошибка запуска, называющая ключ, означает, что флаг провайдера включён без ключа. Реальный ответ также требует JOB_PROVIDER=trigger из раздела Trigger.dev ниже плюс одна включённая модель в каталоге комплекта — Настройка AI описывает эту настройку.

# apps/web/.env.local — pick ONE provider
AI_PROVIDER=openai
OPENAI_API_KEY=sk-…

# or AI_PROVIDER=anthropic
# ANTHROPIC_API_KEY=sk-ant-…

# or AI_PROVIDER=openrouter
# OPENROUTER_API_KEY=sk-or-…

# or AI_PROVIDER=openai-compatible
# OPENAI_COMPATIBLE_API_KEY=…
# OPENAI_COMPATIBLE_BASE_URL=https://your-endpoint/v1

Trigger.dev

Пропустите, если продукту не нужны реальные запуски фоновых задач — JOB_PROVIDER=local ставит задачи в очередь в памяти без их выполнения, что правильно для разработки.

1. Откройте app.trigger.dev → зарегистрируйтесь → создайте проект.

2. Скопируйте два значения: project ref proj_… из настроек проекта или URL дашборда → TRIGGER_PROJECT_REF и секретный ключ со страницы API keys проекта (tr_dev_… для dev-окружения, tr_prod_… для продакшена) → TRIGGER_SECRET_KEY. Оба остаются только на сервере.

3. Задачи комплекта уже живут в apps/web/trigger, и apps/web/trigger.config.ts читает TRIGGER_PROJECT_REF. Из apps/web запустите npx trigger.dev@latest dev — он регистрирует задачи в вашем проекте и запускает их локально против dev-ключа.

Проверьте: dev-команда логирует зарегистрированные задачи; поставьте одну в очередь в приложении и наблюдайте её выполнение в списке Runs дашборда. Развёрнутые окружения запускают corepack pnpm --filter @supastack/web trigger:deploy для публикации набора задач.

# apps/web/.env.local
JOB_PROVIDER=trigger
TRIGGER_PROJECT_REF=proj_…
TRIGGER_SECRET_KEY=tr_dev_…   # tr_prod_… in production

# run the worker alongside the app, from apps/web:
cd apps/web
npx trigger.dev@latest dev

S3-совместимое хранилище (Cloudflare R2)

Пропустите, если продукт не хранит файлы — STORAGE_PROVIDER=memory держит загрузки внутри процесса для разработки.

Подойдёт любой S3-совместимый бакет; Cloudflare R2 — выбор, дружелюбный к бесплатному тарифу. 1. Откройте dash.cloudflare.com → R2 Object Storage → Create bucket, назовите его и оставьте подсказку локации по умолчанию.

2. Вернувшись на обзор R2, откройте Manage R2 API Tokens → Create API token → разрешение Object Read & Write, ограниченное этим бакетом → Create. Скопируйте Access Key ID, Secret Access Key и показанный endpoint S3 — https://<account-id>.r2.cloudflarestorage.com.

3. Установите имена env ниже. STORAGE_REGION=auto — соглашение R2 — комплект по умолчанию ставит us-east-1, которое R2 тоже принимает. STORAGE_FORCE_PATH_STYLE уже включён по умолчанию для кастомных endpoint, что нужно R2. Отдача публичных файлов дополнительно требует STORAGE_PUBLIC_BASE_URL или подключения CDN; приватным файлам больше ничего не нужно.

Проверьте: перезапустите и загрузите через приложение — объект появится в браузере бакета R2. Ошибка подписи или 403 означает, что у токена нет чтения/записи объектов на этом бакете; создайте свежий токен с правильной областью.

# apps/web/.env.local
STORAGE_PROVIDER=s3
STORAGE_ENDPOINT=https://<account-id>.r2.cloudflarestorage.com
STORAGE_REGION=auto
STORAGE_BUCKET=your-bucket
STORAGE_ACCESS_KEY_ID=…          # server-only
STORAGE_SECRET_ACCESS_KEY=…      # server-only
# STORAGE_PUBLIC_BASE_URL=       # optional public-URL base

Sentry или PostHog (необязательно)

Полностью необязательно: каждое значение наблюдаемости по умолчанию не установлено, и комплект отлично работает без них — добавьте это, когда захотите отчёты об ошибках и аналитику в продакшене.

Sentry для ошибок: sentry.io → создайте проект → выберите платформу Next.js → экран настройки показывает DSN https://…@….ingest.sentry.io/… → SENTRY_DSN. Исключения затем достигают Sentry с тегами correlation id; бесплатного тарифа достаточно для старта.

PostHog для продуктовой аналитики вместо этого: posthog.com → создайте проект → скопируйте API-ключ проекта phc_… → NEXT_PUBLIC_POSTHOG_KEY плюс NEXT_PUBLIC_POSTHOG_HOST (https://us.i.posthog.com или ваш EU-хост). Эти двое — публичные браузерные значения по замыслу; SENTRY_DSN остаётся на стороне сервера. ALERT_WEBHOOK_URL опционально отправляет оповещения о сбоях на Slack-совместимый endpoint.

Проверьте: перезапустите, вызовите тестовое исключение (или воспроизведите образцовое событие Sentry) и подтвердите, что оно попадает в список Issues проекта.

# apps/web/.env.local — all optional
SENTRY_DSN=https://…@….ingest.sentry.io/…

NEXT_PUBLIC_POSTHOG_KEY=phc_…
NEXT_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com

# ALERT_WEBHOOK_URL=https://hooks.slack.com/services/…

Cloudflare Turnstile

Защита от ботов для публичных форм и endpoint с креденшелами — CAPTCHA_PROVIDER=off по умолчанию, поэтому добавьте её перед открытием регистрации чужим. Бесплатно.

1. Откройте dash.cloudflare.com → Turnstile → Add widget → назовите его и перечислите хосты: localhost для разработки плюс ваш реальный домен → Create.

2. Скопируйте оба значения: Site Key — публичный по замыслу, он рендерится внутри виджета → NEXT_PUBLIC_TURNSTILE_SITE_KEY — и Secret Key, который сервер использует для проверки → TURNSTILE_SECRET_KEY.

3. CAPTCHA_PROVIDER=turnstile включает её; запуск падает, называя недостающий ключ. Руководство по капче перечисляет, какие именно поверхности защищает виджет.

Проверьте: откройте /auth или контактную форму — виджет рендерится; отправки без решённого задания отклоняются. Если виджет никогда не загружается, хост, который вы просматриваете, не в списке виджета.

# apps/web/.env.local
CAPTCHA_PROVIDER=turnstile
NEXT_PUBLIC_TURNSTILE_SITE_KEY=0x…   # public by design
TURNSTILE_SECRET_KEY=0x…             # server-only

Собственный домен

Одна покупка у любого регистратора — Cloudflare Registrar, Porkbun, Namecheap все работают. Ничего здесь не копируется в env; домен появляется в Services ID, DNS Resend, хостах Turnstile и return URL OAuth, которые вы настроили по пути.

Два способа направить его на приложение: для Cloud Run используйте маппинг домена из руководства по развёртыванию — несколько кликов в консоли плюс DNS-записи, которые перечисляет Google. Или перенесите DNS на серверы имён Cloudflare (регистратор меняет две записи) — необязательно, но это также аккуратный способ управлять публичными бакетами R2 и хостами Turnstile в одном месте.

Чтобы продолжить настройку, прочитайте Настройка базы данных.

Часто задаваемые вопросы

14 вопросов

Что такое supastack?

supastack — модульная основа для создания SaaS-продуктов с AI. Она объединяет общую инфраструктуру, чтобы вы могли сосредоточиться на продуктовых функциях.

Поддерживает ли он web и mobile?

Да. supastack включает приложения Next.js и Expo как отправные точки для web- и мобильных интерфейсов.

Какая аутентификация включена?

Better Auth покрывает e-mail/пароль, OTP и социальный вход. Личные воркспейсы провижинируются вместе с аккаунтом, чтобы продуктовые записи были ограничены с первого дня.

Как он поддерживает AI?

supastack включает настраиваемый мультипровайдерный AI, учёт использования, бюджеты и зашифрованную поддержку bring-your-own-key.

Как обрабатываются подписки?

Для продуктов на ките Stripe-биллинг, подписки и права доступа образуют основу платного доступа. Секреты провайдеров остаются только на сервере.

Где живёт мой продуктовый код?

Продуктовые функции остаются в отдельном коде, а продукт настраивает и интегрирует модули основы supastack.

Как устроены цены supastack?

Кит — разовая покупка с пожизненными обновлениями: один фреймворк за $249 (временная стартовая цена — скидка $100 от стандартной цены $349) или все фреймворки (Next.js, iOS, Android) за $499 (временная стартовая цена — скидка $100 от стандартной цены $599), плюс $75 за каждое дополнительное место разработчика. Без подписки на кит. Оплата на этом сайте доставляет лицензионный ключ по e-mail, доступ к репозиторию — через приглашение GitHub.

Как воркспейсы ограничивают мои данные?

Записи пользователей ограничены по workspaceId. Идентичность, права доступа, AI-использование, события биллинга и записи аудита остаются внутри границы личного воркспейса.

Как работают фоновые задачи?

Trigger.dev — явный рантайм задач. Контракт JobRunner обещает только enqueue, status и cancel — семантика workflow остаётся специфичной для Trigger.dev и явной.

Чем почта отличается от рассылок?

Транзакционная почта покрывает продуктовые сценарии вроде уведомлений о завершении. Холодные рассылки и кампании — забота продукта, вне почтового модуля этого кита.

Как работают покупки в мобильном приложении?

Мобильное приложение поддерживает нативные покупки и восстановление через RevenueCat, а сервер проверяет доступ. Настройте аккаунты магазинов и завершите тестирование на устройствах перед публикацией. Веб-оплата остается отдельной.

Где хранятся ключи AI-провайдеров?

Bring-your-own-key креденшелы зашифрованы и остаются только на сервере. Ключи удаляются из логов; использование и бюджеты видны на уровне воркспейса.

Какие способы оплаты принимает оформление заказа?

Оформление заказа на Stripe принимает карты, а после включения кошельков в аккаунте Stripe может также предлагать Alipay и WeChat Pay — удобно для покупателей из Китая. Авторизации кошельков подтверждаются асинхронно, поэтому страница лицензии обновляется, как только платёж завершается.

Могу ли я получить возврат средств?

После получения доступа к репозиторию supastack остается вашим навсегда, поэтому возврат средств невозможен. Но будьте уверены: вы получаете полный исходный код с пожизненными обновлениями для создания и запуска неограниченного числа продуктов для себя или клиентов. Вы лишь не можете перепродавать код или распространять репозиторий как стартовый набор или шаблон.

RU
Тема