> ## 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

# Настройка кастомных доменов

Позвольте воркспейсам обслуживать приложение на собственных хостнеймах через Cloudflare for SaaS.

## Настройка и конфигурация

Перед любым действием прочтите [Перед началом работы](https://supastack.dev/ru/docs/web/before-you-start.md) и [Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md). В этих инструкциях предполагается, что вы открыли полный монорепозиторий supastack в VS Code; его корень package.json отмечает корень репозитория. В командах pnpm пакет рабочей области представляет собой папку приложения или общего кода; В продукте рабочее пространство — это контейнер данных и граница безопасности команды. corepack pnpm --filter ... выбирает один пакет из монорепозитория, пока команды выполняются из его корня. Если вы открыли только синхронизированную папку мобильного устройства или рабочего стола, она не содержит веб-серверной части, настройки Docker или корневых сценариев: запустите серверную часть из этого монорепозитория или доступного размещенного сервера и используйте собственные сценарии папки платформы. Переменная среды — это именованный параметр, хранящийся в локальном файле .env или на панели управления хостингом; перезапустите соответствующее приложение после его изменения и не допускайте попадания секретов сервера в значения NEXT_PUBLIC_ и EXPO_PUBLIC_.

1. Откройте apps/web/.env.local и используйте CUSTOM_DOMAINS_PROVIDER=local для предварительного просмотра экрана «Домены» без изменений DNS.

2. Для реального имени хоста клиента настройте Cloudflare для SaaS с собственной зоной, токеном API, ограниченным этой зоной, и целью CNAME; вводите значения только для сервера на веб-хосте, а не в браузере.

3. Запустите Web с помощью corepack pnpm --filter @supastack/web dev и откройте «Настройки» → «Домены» от имени владельца/администратора рабочей области. Ожидается: локальный адаптер немедленно активирует тестовый домен; адаптер Cloudflare ожидает отображаемых записей DNS.

Установите CUSTOM_DOMAINS_PROVIDER=cloudflare с помощью CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID и CUSTOM_DOMAIN_CNAME_TARGET. Токену API требуется разрешение SSL и сертификаты: редактирование зоны (пользовательские имена хостов API находятся в каталоге /zones/{zone_id}/custom_hostnames). Цель CNAME — это имя хоста в вашей зоне Cloudflare (например, customer.example.com), которое соответствует вашему развернутому приложению.

Добавьте в зону запись DNS, указывающую цель CNAME на ваш источник (резервный источник в Cloudflare для условий SaaS). Cloudflare выдает каждому пользовательскому имени хоста запись DCV TXT плюс необязательную запись владельца TXT; экран настроек показывает клиентам, какие именно записи нужно создать.

Для локальной разработки используйте CUSTOM_DOMAINS_PROVIDER=local, который немедленно помечает каждое активное имя хоста целевыми клиентами. localhost. CUSTOM_DOMAINS_PROVIDER=off (по умолчанию) скрывает элементы управления раздела.

```
CUSTOM_DOMAINS_PROVIDER=cloudflare
CLOUDFLARE_API_TOKEN=cf_token_with_ssl_edit
CLOUDFLARE_ZONE_ID=zone_id
CUSTOM_DOMAIN_CNAME_TARGET=customers.example.com
```


## Команды для копирования

Следуйте комментариям, чтобы узнать, в какой папке запускается команда. Если помечены два терминала, откройте два окна терминала и продолжайте выполнять первую команду, пока используете вторую.

```
corepack pnpm --filter @supastack/web dev
```


## Рабочий процесс внедрения

Владельцы и администраторы рабочих пространств управляют доменами в разделе «Настройки» → «Домены» (по пять на каждое рабочее пространство). Клиенты указывают запись CNAME для своего имени хоста на целевом объекте CNAME, добавляют записи TXT, отображаемые для владения и проверки сертификата, а затем нажимают «Обновить статус». Как только Cloudflare сообщает об активном имени хоста, оно становится надежным источником для аутентификации в этом развертывании, а имя/логотип рабочей области обозначает хром приложения на этом имени хоста.

Домены Apex (корневые) не могут быть CNAME у большинства поставщиков DNS — клиентам следует использовать поддомен, такой как портал.example.com, или поставщика с выравниванием CNAME. Файлы cookie остаются привязанными к каждому хосту, поэтому домен клиента требует отдельного входа; единый вход в личные домены выходит за рамки.


## Проверка и устранение неполадок

Если Cloudflare остается в режиме ожидания, сравните записи CNAME и TXT клиента с точными значениями, указанными на карточке домена, и дайте DNS время для обновления. Используйте поддомен, если поставщик DNS не может свести корневой домен CNAME. Если меню отсутствует, убедитесь, что эта функция включена, а вошедший в систему пользователь является владельцем или администратором рабочей области.

Ожидание в течение длительного времени обычно означает, что CNAME клиента отсутствует или все еще распространяется — повторно проверьте записи DNS, показанные на карточке домена. Статус «Перемещено» или «Не удалось» означает, что Cloudflare больше не может сопоставить имя хоста с зоной; удалите и добавьте заново. Данные проверки хранятся как поставщик JSON, поэтому будущие формы проверки Cloudflare не требуют изменения схемы.


Чтобы продолжить настройку, прочитайте [Развёртывание в Google Cloud](https://supastack.dev/ru/docs/web/deploy-google-cloud.md).


## Вперёд

[Развёртывание в Google Cloud](https://supastack.dev/ru/docs/web/deploy-google-cloud.md)