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/setup-domains.md (or send Accept: text/markdown).
Настройка кастомных доменов
Позвольте воркспейсам обслуживать приложение на собственных хостнеймах через Cloudflare for SaaS.
Настройка и конфигурация
Перед любым действием прочтите Перед началом работы и Основные сведения о терминале. В этих инструкциях предполагается, что вы открыли полный монорепозиторий 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.