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

Интеграция Cloudflare

Обзор​

Cloudflare — ведущая сеть доставки контента (CDN) и поставщик решений безопасности, который помогает защищать и ускорять веб-сайты. Эта интеграция обеспечивает автоматическое управление доменами между Ultimate Multisite и Cloudflare, особенно для multisite-установок с поддоменами.

Возможности​

  • Автоматическое создание поддоменов в Cloudflare
  • Поддержка проксируемых поддоменов
  • Управление DNS-записями
  • Улучшенное отображение DNS-записей в админке Ultimate Multisite

Требования​

Следующие константы должны быть определены в вашем файле wp-config.php:

define('WU_CLOUDFLARE_API_KEY', 'your_api_key');
define('WU_CLOUDFLARE_ZONE_ID', 'your_zone_id');

Инструкции по настройке​

1. Получите ваш API-ключ Cloudflare​

  1. Войдите в ваш Dashboard Cloudflare
  2. Перейдите в "My Profile" (нажмите на ваш email в правом верхнем углу)
  3. Выберите "API Tokens" в меню
  4. Создайте новый API-токен со следующими разрешениями:
    • Zone.Zone: Read
    • Zone.DNS: Edit
  5. Скопируйте ваш API-токен

2. Получите ваш Zone ID​

  1. В вашем Dashboard Cloudflare выберите домен, который хотите использовать
  2. Zone ID отображается на вкладке "Overview" в правой боковой панели в разделе "API"
  3. Скопируйте Zone ID

3. Добавьте константы в wp-config.php​

Добавьте следующие константы в ваш файл wp-config.php:

define('WU_CLOUDFLARE_API_KEY', 'your_api_token');
define('WU_CLOUDFLARE_ZONE_ID', 'your_zone_id');

4. Включите интеграцию​

  1. В вашей админке WordPress перейдите в Ultimate Multisite > Settings
  2. Перейдите на вкладку "Domain Mapping"
  3. Прокрутите вниз до "Host Integrations"
  4. Включите интеграцию Cloudflare
  5. Нажмите "Save Changes"

Как это работает​

Управление поддоменами​

Когда новый сайт создается в multisite-установке с поддоменами:

  1. Интеграция отправляет запрос в API Cloudflare, чтобы добавить CNAME-запись для поддомена
  2. Поддомен по умолчанию настраивается на проксирование через Cloudflare (это можно изменить с помощью фильтров)
  3. Когда сайт удаляется, интеграция удалит поддомен из Cloudflare

Отображение DNS-записей​

Интеграция улучшает отображение DNS-записей в админке Ultimate Multisite за счет:

  1. Получения DNS-записей напрямую из Cloudflare
  2. Отображения того, проксируются записи или нет
  3. Показа дополнительной информации о DNS-записях

Cloudflare Custom Hostnames​

Cloudflare Custom Hostnames (ранее называлось "Cloudflare for SaaS") — это функция Cloudflare, которая позволяет вашим клиентам использовать собственные домены с SSL в вашей multisite-сети. Это рекомендуемый подход для multisite-установок с сопоставленными доменами, которые используют Cloudflare, поскольку Cloudflare автоматически управляет выпуском и продлением SSL-сертификатов для каждого пользовательского домена.

Чем это отличается от стандартной интеграции Cloudflare​

Стандартная интеграцияCloudflare Custom Hostnames
НазначениеАвтоматически создает DNS-записи для поддоменовВключает пользовательские (сопоставленные) домены с SSL, управляемым Cloudflare
Лучше всего подходит дляMultisite с поддоменамиMultisite с сопоставленными доменами
SSLОбрабатывается отдельноАвтоматически управляется Cloudflare

Настройка Cloudflare Custom Hostnames​

  1. В вашем Dashboard Cloudflare откройте зону для вашего основного домена.
  2. Перейдите в SSL/TLS > Custom Hostnames.
  3. Добавьте резервный origin, указывающий на IP-адрес или hostname вашего сервера.
  4. Для каждого клиентского домена, сопоставленного в Ultimate Multisite, добавьте запись Custom Hostname в Cloudflare. Вы можете автоматизировать этот шаг с помощью API Cloudflare.
  5. Cloudflare автоматически выпускает и продлевает TLS-сертификаты для каждого пользовательского hostname, как только DNS клиента будет направлен на вашу сеть.

Полную справку по API см. в документации Cloudflare Custom Hostnames.

Обновление терминологии

Начиная с Ultimate Multisite v2.6.1, эта функция называется Cloudflare Custom Hostnames во всех настройках и метках plugin. В более ранних версиях использовалось название "Cloudflare for SaaS", которое является названием базового продукта Cloudflare.

Важные примечания​

После недавних обновлений Cloudflare проксирование wildcard теперь доступно всем клиентам. Это означает, что стандартная интеграция Cloudflare DNS стала менее критичной для multisite-установок с поддоменами, чем раньше, поскольку вы можете просто настроить wildcard DNS-запись в Cloudflare.

Устранение неполадок​

Проблемы с подключением API​

  • Убедитесь, что ваш API-токен корректен и имеет необходимые разрешения
  • Проверьте, что ваш Zone ID корректен
  • Убедитесь, что ваш Account Cloudflare имеет необходимые разрешения

Поддомен не добавлен​

  • Проверьте журналы Ultimate Multisite на наличие сообщений об ошибках
  • Убедитесь, что поддомен еще не добавлен в Cloudflare
  • Убедитесь, что ваш план Cloudflare поддерживает количество DNS-записей, которые вы создаете

Проблемы с проксированием​

  • Если вы не хотите, чтобы поддомены проксировались, вы можете использовать фильтр wu_cloudflare_should_proxy
  • Некоторые функции могут работать некорректно при проксировании (например, определенные функции админки WordPress)
  • Рассмотрите возможность использования Page Rules Cloudflare, чтобы обходить кэш для страниц админки