Troubleshooting

После установки 500 или белый экран

• Проверьте версию PHP и наличие обязательных расширений.
• Убедитесь, что require_once подключен до вывода HTML, но путь к /antibot/index.php верный.
• Проверьте права веб-сервера на logs/, cache/ и lists/.
• Временно включите debug и откройте logs/antibot.log.

Все посетители видны как один IP

Это почти всегда означает, что сайт стоит за proxy/CDN без корректного header_proxy. Сначала настройте X-Real-IP или Cloudflare-заголовки, затем очищайте ошибочные блокировки.

[header_proxy]
enabled = On
header_ip = X-Real-IP
header_protocol = X-Forwarded-Proto

Капча появляется слишком часто

• Проверьте whitelist_url для API, REST, XML, callback и health-check URL.
• Для спорных проверок используйте CAPTCHA вместо BLOCK.
• Посмотрите RayID в logs/antibot.log и найдите конкретный фильтр.
• Добавляйте точечные исключения, а не отключайте весь фильтр без анализа.

Пользователь заблокирован ошибочно

Попросите RayID и IP со страницы блокировки, найдите запись в логе, удалите IP из blacklist_ip или добавьте узкое исключение в whitelist_*.