Перейти к основному содержимому

Настройка DNS и доменов

После установки модуля вам необходимо решить, как арендаторы будут получать доступ к своей CRM. Это одно из самых важных решений для вашей SaaS-платформы, поэтому давайте подробно объясним все варианты.

Понимание структур URL​

Модуль поддерживает три различных способа доступа арендаторов к CRM. Вот как выглядит каждый из них:

Вариант 1: Режим подкаталогов (самый простой)​

https://yoursite.com/ws/tenant-name

Пример: Если ваш домен — mycrm.com, и арендатор "Acme Corp" регистрируется, он получит доступ к CRM по адресу:

https://mycrm.com/ws/acme-corp

Преимущества:

  • Не требуется дополнительная настройка DNS
  • Работает на любом хостинг-плане
  • Не нужен wildcard SSL
  • Самая простая настройка

Недостатки:

  • Менее «профессиональный» вид по сравнению с поддоменом
  • Арендаторы не могут использовать пользовательские домены

Лучше всего подходит для: Быстрого старта, тестирования, небольших развёртываний.

Вариант 2: Режим поддоменов​

https://tenant-name.yoursite.com

Пример: Acme Corp получит доступ к CRM по адресу:

https://acme-corp.mycrm.com

Преимущества:

  • Профессиональный и брендированный внешний вид
  • Каждый арендатор чувствует, что у него своя платформа
  • Отраслевой стандарт для SaaS-платформ

Недостатки:

  • Требуется wildcard DNS-запись
  • Может потребоваться wildcard SSL (но у нас есть обходные решения!)

Лучше всего подходит для: Профессиональных SaaS-развёртываний, бизнесов, которые хотят произвести впечатление на клиентов.

Вариант 3: Режим пользовательских доменов​

https://crm.tenant-own-domain.com

Пример: Acme Corp может использовать собственный домен:

https://crm.acmecorp.com

Преимущества:

  • Максимальный брендинг для арендаторов
  • Арендаторы могут использовать домен своей компании
  • Наивысшая воспринимаемая ценность

Недостатки:

  • Каждому арендатору нужно настроить DNS
  • Требуется больше настроек для каждого арендатора

Лучше всего подходит для: Корпоративных предложений, премиум-планов, white-label сервисов.

Настройка режима подкаталогов​

Это режим по умолчанию, который почти не требует настройки DNS.

Шаг 1: Включите структуру подкаталогов​

  1. Перейдите в SaaS Management → SuperAdmin Settings
  2. Нажмите на вкладку MySQL Server Settings
  3. Установите "Use Subdir Structure '/ws/{tenant}'" в значение Yes
  4. Нажмите Save Settings

Шаг 2: Готово!​

Серьёзно — при использовании режима подкаталогов дополнительная настройка DNS не требуется. Арендаторы автоматически будут доступны по адресу yoursite.com/ws/tenant-slug.

Настройка режима поддоменов​

Режим поддоменов требует wildcard DNS-записи. Вот точные инструкции:

Что такое wildcard DNS-запись?​

Wildcard DNS-запись — это специальная DNS-запись, которая перехватывает ВСЕ поддомены и направляет их на ваш сервер. Вместо создания отдельной DNS-записи для каждого арендатора (что было бы невозможно), одна wildcard-запись обрабатывает их все.

Представьте это как переадресацию почты: «Любая корреспонденция на адрес что-угодно@вашакомпания.com должна направляться в главный офис».

Шаг 1: Найдите IP-адрес вашего сервера​

Вам нужен IP-адрес сервера. Вот как его найти:

  • cPanel: Посмотрите вверху панели управления cPanel — там показан IP
  • VPS/Облако: Проверьте панель управления хостинг-провайдера
  • Командная строка: Выполните curl ifconfig.me на сервере

Шаг 2: Добавьте wildcard DNS-запись​

  1. Войдите в учётную запись регистратора доменов (где вы купили домен — например, Namecheap, GoDaddy, Cloudflare)
  2. Перейдите в DNS-настройки вашего домена
  3. Добавьте новую A-запись со следующими параметрами:
ПолеЗначение
TypeA
Host/Name* (просто звёздочка)
Value/Points toIP-адрес вашего сервера (например, 123.456.789.0)
TTLAutomatic (или 3600)
warning

Звёздочка (*) важна! Она должна быть именно * — не *.yoursite.com или что-то другое. Просто один символ звёздочки.

Шаг 3: Дождитесь распространения DNS​

Изменения DNS не вступают в силу мгновенно. Им нужно «распространиться» по интернету:

  • Cloudflare: Обычно мгновенно (в течение 5 минут)
  • Большинство регистраторов: от 15 минут до 4 часов
  • Некоторые регистраторы: до 24-48 часов (редко)

Проверить распространение DNS можно с помощью dnschecker.org.

Шаг 4: Отключите режим подкаталогов​

  1. Перейдите в SaaS Management → SuperAdmin Settings
  2. Нажмите на вкладку MySQL Server Settings
  3. Установите "Use Subdir Structure '/ws/{tenant}'" в значение No
  4. Нажмите Save Settings

Теперь арендаторы будут доступны по адресу tenant-name.yoursite.com вместо yoursite.com/ws/tenant-name.

Настройка пользовательских доменов​

Пользовательские домены позволяют арендаторам использовать собственный домен (например, crm.theircompany.com) для доступа к CRM. Это премиум-функция, которую полюбят ваши арендаторы!

Как работают пользовательские домены​

  1. Вы включаете функцию пользовательского домена в плане арендатора
  2. Арендатор вводит желаемый домен в своей панели управления
  3. Арендатор (или вы) направляет DNS домена на IP вашего сервера
  4. Модуль автоматически обнаруживает домен и маршрутизирует трафик к нужному арендатору

Включение пользовательских доменов​

  1. Перейдите в SaaS Management → Plans
  2. Откройте план, для которого хотите включить пользовательские домены
  3. В разделе Advanced Features переключите "Enable Custom Domain" в ON
  4. Сохраните план

Переключите "Enable Custom Domain" в разделе Advanced Feature вашего плана

Что нужно сделать арендаторам​

Когда арендатор хочет использовать пользовательский домен, ему нужно добавить DNS-записи, указывающие на ваш сервер. Модуль включает встроенное руководство по DNS, к которому арендаторы могут получить доступ одним нажатием:

Встроенное руководство по DNS точно указывает арендаторам, какие DNS-записи добавить — никаких тикетов в поддержку!

Руководство говорит им:

  1. Добавить A-запись с доменом, указывающим на IP вашего сервера
  2. По желанию добавить версию с www
  3. Дождаться распространения DNS (до 48 часов)

Шпаргалка по настройке DNS​

Вот краткий справочник по всем DNS-записям, которые могут понадобиться:

НазначениеТипHost/NameЗначение
Основной доменA@IP вашего сервера
Версия с wwwAwwwIP вашего сервера
Wildcard-поддоменыA*IP вашего сервера
Пользовательский домен арендатораA (в DNS арендатора)@IP вашего сервера

Тестирование конфигурации DNS​

После внесения изменений в DNS проверьте их:

  1. Откройте браузер и перейдите на тестовый поддомен: http://test123.yourdomain.com
  2. Если вы видите Perfex CRM (или лендинг-страницу) — DNS работает!
  3. Если видите ошибку — DNS ещё не распространился. Подождите и попробуйте снова.

Также можете использовать онлайн-инструменты для проверки:

success

DNS настроен? Отлично! Теперь настройте SSL для безопасных соединений. Перейдите к руководству Настройка SSL.