Folder Guard — Protected By ZeroBot

Что такое Folder Guard?

Folder Guard — это небольшой PHP-пакет, который вы размещаете на собственном сервере.
Как только папка защищена, каждый запрос к ней проверяется через вашу учётную запись ZeroBot ещё до загрузки страницы — поэтому боты блокируются, а реальные посетители проходят беспрепятственно.

Он подключается к вашей существующей учётной записи ZeroBot по лицензионному ключу, поэтому ваш белый список, чёрный список, журналы трафика и настройки остаются синхронизированными с основной панелью управления.
Никакие данные не хранятся у сторонних сервисов.

Как работает защита

Когда посетитель открывает защищённую папку, Folder Guard срабатывает до загрузки вашей страницы и запрашивает у ZeroBot, является ли запрос ботом или человеком, а затем применяет выбранное вами правило:

• Он загружается автоматически при каждом запросе внутри защищённой папки (через .user.ini или .htaccess).
• Каждый запрос проверяется в реальном времени по вашей учётной записи ZeroBot — без устаревшего кэширования.
• Он работает по принципу fail-open: если ZeroBot вдруг окажется недоступен, ваш сайт продолжит работать в обычном режиме.
• Каждое посещение записывается в вашу учётную запись, поэтому оно отображается как в самом пакете, так и в основной панели управления ZeroBot.

Требования

• PHP 8.1 или новее.
• Apache (mod_php) либо PHP-FPM / FastCGI / LiteSpeed — пакет настраивает оба варианта автоматически.
• Активный лицензионный ключ ZeroBot (находится в панели управления в разделе «Профиль»).
• Свободный слот для домена в вашем тарифе.
  Folder Guard авторизует ваш домен автоматически, и это занимает один из слотов для доменов вашего тарифа.

Авторизация домена

При входе Folder Guard автоматически авторизует ваш домен.
Он добавляет домен в вашу учётную запись ZeroBot, чтобы защита ваших папок распознавалась, а каждое посещение записывалось в обеих панелях.

Авторизация домена занимает один из слотов для доменов вашего тарифа.
Если свободных слотов нет, домен невозможно авторизовать — и пока он не авторизован, Folder Guard не может защищать ваши папки, и посетители просто пропускаются.
Освободите слот, удалив неиспользуемый домен в панели, или перейдите на более высокий тариф, чтобы добавить больше.

Установка в 4 шага

Не требуется ни кода, ни командной строки — просто загрузите пакет и откройте его в браузере.

Защита папки

Откройте вкладку «Защищённые папки», укажите абсолютный путь к папке, которую хотите защитить (поле уже заполнено корневым каталогом вашего сайта), и нажмите «Защитить папку».
На Apache защита включается сразу, а на PHP-FPM — примерно в течение пяти минут.

Правила защиты

В разделе «Настройки» вы отдельно определяете, что происходит с ботами и что — с реальными людьми:

Когда обнаружен бот

• Блокировать — показать аккуратную страницу «Доступ запрещён».
• Проверка — показать слайдер-капчу ZeroBot; пройдя её, посетитель получает доступ.
• Перенаправление — отправить посетителя на выбранный вами URL.
• Только журналирование — зафиксировать посещение, но не блокировать (удобно для тестирования).

Когда заходит реальный человек

• Ничего не делать — пропустить его напрямую (по умолчанию).
• Проверка — попросить пройти капчу даже людей.
• Блокировать — закрыть доступ всем (полезно, чтобы полностью закрыть папку).
• Перенаправление — отправить людей на другой URL.

Капча ZeroBot

Когда активно правило проверки, подозреваемые боты видят настоящую слайдер-капчу ZeroBot.
После того как посетитель её проходит, он получает кратковременный доступ и больше не сталкивается с проверкой — это в точности та же капча, что используется на всей платформе ZeroBot.

Цифровой отпечаток устройства (опционально)

В разделе «Настройки» вы можете включить скрипт цифрового отпечатка устройства ZeroBot.
Он собирает более 40 сигналов браузера (canvas, WebGL, аудио, часовой пояс и другие) на защищённых страницах, чтобы со временем повышать точность обнаружения ботов.

Белый & чёрный список

Разрешайте или блокируйте конкретные IP-адреса прямо из пакета.
Поскольку он синхронизирован с вашей учётной записью ZeroBot, каждое изменение применяется везде, где ваша учётная запись обеспечивает защиту, — и отображается в основной панели управления.

Трафик & журналы

Вкладка «Трафик» показывает решения в реальном времени по каждому запросу, точно так же, как и основная панель управления:

• IP, статус (бот или человек), посещённая страница, браузер, ОС и страна.
• Фильтруйте по странице, листайте историю по страницам и очищайте журнал, когда захотите.
• Журнал действий фиксирует каждое внесённое вами изменение в белый и чёрный список.

Включение & отключение защиты

Один переключатель в разделе «Настройки» приостанавливает или возобновляет защиту сразу для всех папок, не удаляя вашу конфигурацию.
Когда защита отключена, каждый посетитель просто пропускается — удобно на время технического обслуживания.

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

Если защищённая папка всё равно пропускает посетителей, проверьте эти четыре пункта.
Они охватывают те немногие конфигурации, где активации нужен небольшой толчок.

Защищает только PHP-запросы

Folder Guard работает через auto_prepend_file в PHP, поэтому активируется только на запросах, которые обрабатывает PHP.
Статические страницы .html, изображения или папка, отдаваемая без PHP, не защищены.
Укажите его на папку, в которой работает ваше PHP-приложение, или добавьте его в точку входа этого приложения.

Активация на cPanel / LiteSpeed

На LiteSpeed настройка находится в .user.ini и кэшируется около 5 минут, поэтому срабатывает не мгновенно.
Смена версии PHP в разделе «Select PHP Version» принудительно перечитывает её.
Если активация всё равно не происходит, ваш хостинг может вообще не учитывать ни .user.ini, ни php_value в .htaccess.
Включите PHP-расширение htscanner в разделе «Select PHP Version» и «Extensions», чтобы это заработало.
Также держите включённым расширение curl, потому что Folder Guard использует его для обращения к API.

Боты проходят, но появляются в журналах

Это значит, что действие для ботов установлено на «Журналировать», которое записывает ботов, но не останавливает их.
Откройте «Настройки» и установите действие для ботов на «Блокировать» или «Проверка», чтобы действительно их останавливать.

В панели подключено, но ничего не записывается

Защита читает вашу лицензию из файла с именем .env.php в папке установки, а не из .env.example, который является лишь образцом и его нельзя редактировать.
Панель может выглядеть подключённой из-за сессии браузера, даже когда этого файла нет.
Если вы переместили или переименовали папку установки, просто откройте «Настройки» один раз, и Folder Guard сохранит лицензию автоматически.

Спасибо

Нужна помощь?
Свяжитесь с нами в нашем канале Telegram или по адресу support@zerobot.info — мы будем рады помочь вам с настройкой.