> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

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

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

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

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

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

[Назад к чек-листу аккаунтов](https://supastack.dev/ru/docs/web/external-accounts.md)


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

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

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

OpenRouter маршрутизирует каждую модель каталога через один ключ: [openrouter.ai](https://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](https://supastack.dev/ru/docs/web/setup-ai.md) описывает эту настройку.

```
# 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](https://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](https://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](https://sentry.io) → создайте проект → выберите платформу Next.js → экран настройки показывает DSN `https://…@….ingest.sentry.io/…` → `SENTRY_DSN`. Исключения затем достигают Sentry с тегами correlation id; бесплатного тарифа достаточно для старта.

PostHog для продуктовой аналитики вместо этого: [posthog.com](https://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](https://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` или контактную форму — виджет рендерится; отправки без решённого задания отклоняются. Если виджет никогда не загружается, хост, который вы просматриваете, не в списке виджета.

[Посмотрите, какие формы защищает Turnstile](https://supastack.dev/ru/docs/web/captcha.md)

```
# 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 в одном месте.

[Настройте маппинг домена на Cloud Run](https://supastack.dev/ru/docs/web/deploy-google-cloud.md)

[Далее настройте базу данных](https://supastack.dev/ru/docs/web/setup-database.md)


Чтобы продолжить настройку, прочитайте [Настройка базы данных](https://supastack.dev/ru/docs/web/setup-database.md).


## Вперёд

[Настройка базы данных](https://supastack.dev/ru/docs/web/setup-database.md)