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 автоматически авторизует ваш домен, если в вашем тарифе есть свободный слот.
Домен добавляется только в момент подключения — поэтому если позже вы удалите его в панели, guard учтёт это: перестанет защищать и покажет чёткое предупреждение «не защищено» вместо того, чтобы тихо добавить его обратно.

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

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

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

Защита папки

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

Что защищает Folder Guard — а что нет

Folder Guard работает на уровне PHP: каждый запрос, выполняющий PHP в защищённой папке, проверяется до загрузки страницы.
С версии 1.3.0 он также может направлять статические файлы через PHP, охватывая страницы и текстовые ресурсы.

Folder Guard защищает

• PHP-страницы и скрипты в защищённой папке — index.php, contact.php, админ-панели, зоны для участников, любой файл .php.
• Статические страницы (.html, .htm) по умолчанию, плюс дополнительные текстовые ресурсы (.css, .js, .json, .xml, .svg, .txt), включаемые в Настройки → Защищённые расширения — каждый отдаётся с корректным типом содержимого.
• Посетитель блокируется, проверяется или логируется до отправки какого-либо содержимого, а разрешённые HTML-страницы несут бейдж и скрипт отпечатка.
  Защищённые статические файлы отдаются с no-store — браузер никогда не хранит копию, способную обойти защиту.

Folder Guard не защищает

• Изображения и другие бинарные файлы — картинки, PDF, видео, шрифты и загрузки.
  Их нельзя безопасно направить через PHP, поэтому защита для них не срабатывает.
• Невключённые статические типы — по умолчанию покрыты только .html и .htm; остальные текстовые ресурсы остаются без защиты, пока вы не включите их в Защищённых расширениях.
• PHP-файлы вне защищённой папки или хостинги, где механизм auto-prepend включить не удалось.
  Маршрутизация статики дополнительно требует Apache или LiteSpeed — на чистом PHP-FPM/nginx используйте режим Include, покрывающий только .php.
• Копии, уже сохранённые CDN до включения защиты — решение принимается в момент запроса на вашем сервере; очистите кэш CDN после защиты папки.

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

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

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

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

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

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

Капча ZeroBot

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

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

Скрипт отпечатка устройства ZeroBot можно включить в Настройках.
На защищённых страницах он собирает более 40 сигналов браузера (canvas, WebGL, аудио, часовой пояс и другие), чтобы оценить каждого посетителя.
Чистый посетитель проходит незаметно; посетителю со средним риском показывается быстрая капча, чтобы подтвердить, что он человек; посетитель с высоким риском блокируется автоматически — без отдельного правила.

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

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

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

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

• IP, статус (бот или человек), посещённая страница, браузер, ОС и страна.
• Фильтруйте по странице, листайте историю по страницам и очищайте журнал, когда захотите.
• Журнал действий фиксирует каждое внесённое вами изменение в белый и чёрный список.
• Включите «Удалять дубликаты», чтобы считать каждого посетителя один раз на папку — страница, её ресурсы (.css, .js) и быстрые перезагрузки с того же 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 — мы будем рады помочь вам с настройкой.