XCloak Logo XCloak

PHP интеграция XCloak: установка на хостинг за 5 минут без кода

Updated: 31.10.2026 · 4 min read · 5 views

Введение

PHP-интеграция — это самый простой и надежный способ защиты вашего сайта. Вся фильтрация происходит в момент захода пользователя на сайт: облачный сервис фильтрации XCloak мгновенно определяет тип посетителя и показывает ботам или модераторам безопасную страницу (White Page), а целевым клиентам — ваш оффер (Offer Page).

Для настройки вам не понадобятся навыки программирования или администрирования серверов. Все действия выполняются через удобный интерфейс панели XCloak и стандартный файловый менеджер вашего хостинга.


Шаг 1. Создание и настройка потока в XCloak

Перейдите в раздел Потоки -> Создать поток (/flows/create) в панели XCloak и пройдите 4 простых шага мастера:

1. Основное & Офферы

  • Название потока: Введите понятное имя для вашего потока.
  • White Page (Для ботов и модераторов): Укажите ссылку на безопасный сайт или выберите загрузку локального файла (site.html). Выберите режим отображения: Подгрузка (curl) (загружает контент без изменения URL), Редирект или iFrame.
  • Offer Page (Для целевых клиентов): Укажите ссылку на вашу целевую страницу. Также выберите удобный режим отображения.

2. Таргетинг

  • Укажите Разрешенные страны, из которых вы планируете принимать целевой трафик.
  • Выберите допустимые типы устройств (Desktop, Mobile, Tablet) и операционные системы (iOS, Android, Windows, Mac OS).

3. Фильтры и Защита

  • Включите Фильтр Black IP (block_bot) для блокировки рекламных модераторов, ботов, спай-сервисов и хостинговых IP-адресов.
  • Включите Фильтр VPN / Proxy (block_vpn) для отсечения нецелевых пользователей с коммерческими VPN, Tor и прокси.
  • При необходимости активируйте Фильтр без ISP и Фильтр без Referer.
  • Пропуск кликов перед включением фильтрации (clicks_before_filter): Укажите количество прогревочных кликов, которые будут гарантированно отправлены на White Page во время первичной проверки кампании.
  • Отметьте галочку Сохранять GET-параметры (UTM, SubID), чтобы сервис автоматически пробрасывал все метки (utm_*, fbclid, gclid, sub1..sub5).

4. Запуск & Код

  • Выберите способ подключения PHP Интеграция index.php.
TIP

Вы можете скачать готовый ZIP-архив прямо из раздела White Pages в панели XCloak, нажав кнопку С интеграцией. Архив уже содержит безопасную страницу site.html и полностью настроенный файл index.php. Вам не придется редактировать код вручную!


Шаг 2. Загрузка файлов на хостинг

После скачивания ZIP-архива его необходимо развернуть на вашем хостинге (например, Beget, cPanel, REG.RU или любом другом).

  1. Войдите в панель управления вашего хостинга.
  2. Откройте Файловый менеджер.
  3. Перейдите в корневую папку вашего домена (обычно она называется public_html, httpdocs или совпадает с именем вашего домена).
  4. Загрузите полученный ZIP-архив в эту папку.
  5. Распакуйте (разархивируйте) ZIP-архив средствами файлового менеджера.
WARNING

Убедитесь, что в корневой папке вашего сайта файл называется именно index.php. Если там находился стандартный файл index.html от хостинга, удалите или переименуйте его, иначе сайт может открываться некорректно.


Шаг 3. Проверка работы фильтрации

После загрузки файлов открывать и тестировать сайт можно сразу по вашему домену.

Чтобы убедиться, что система работает корректно:

  1. Зайдите в панель XCloak в раздел Клики -> Инспектор клика.
  2. Перейдите по ссылке вашего сайта.
  3. В инспекторе кликов в реальном времени появится запись о вашем визите с подробной информацией:
    • На какую страницу вас направила система (White Page или Offer Page).
    • Причина решения (например, срабатывание фильтра VPN/Proxy, Black IP или успешное прохождение всех проверок).
NOTE

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


Частые вопросы (FAQ)

Нужны ли навыки программирования для установки?

Нет. Сервис XCloak формирует готовый файл index.php автоматически. Вам нужно лишь скачать ZIP-архив и распаковать его в файловом менеджере вашего хостинга.

Что делать, если на хостинге уже есть файл index.html?

Если в корневой папке сайта присутствует файл index.html, удалите его или переименуйте (например, в site.html), чтобы основным исполняемым файлом стал index.php от XCloak.

Как передаются метки UTM и SubID?

При включенной опции Сохранять GET-параметры в Step 3 мастера настройки, XCloak автоматически подставляет все входящие параметры (fbclid, gclid, utm_source, sub1..sub5) к итоговой ссылке целевой страницы.

Was this technical guide helpful?
Thank you for your feedback! We use ratings to improve our documentation.

Still have questions about your flow setup?

Contact XCloak technical support on Telegram — our engineers will help verify your integration, headers, and filter rules.