TurtleGuard

Документация / Начало работы

Режимы защиты

Сколько защиты включить: от наблюдения до проверки браузера для всех.

2 минуты чтенияОбновлено 07.11.2026

Режим защиты задаёт, что делает узел с подозрительным запросом: только записывает его в журнал, блокирует или сначала просит браузер пройти проверку. Режим выбирается для каждого сайта отдельно и меняется в один клик.

Три режима

РежимЧто происходитКогда брать
ПассивныйПравила WAF и ваши правила срабатывают только в журнал, запросы доходят до сервера. Списки адресов, страны и лимиты работают как обычно.Первые дни после подключения: видно, что правила не задевают живых посетителей
СтандартWAF (OWASP CRS) и ваши правила блокируют. Проверка браузера показывается только там, где её просит ваше правило, и во время атаки.Обычная работа сайта
ПроверкаКаждый новый посетитель сначала проходит проверку браузера, потом попадает на сайт.Сайт под атакой или вам нужно пускать только живых людей

Режим переключается в панели: домен → Защита → Режим защиты. Какие режимы доступны, зависит от тарифа: пассивный есть всегда, «Стандарт» и «Проверка» открываются на тарифах с WAF.

Как работает проверка браузера

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

  • Боты без настоящего браузера задачу не решают и дальше не проходят.
  • Во время атаки и для подозрительных посетителей задача становится чуть сложнее.
  • Фоновые запросы страницы (XHR, fetch, JSON, статика) без метки получают короткий ответ 429 вместо страницы проверки: проверка нужна один раз, на открытии страницы.

Включите «Показывать проверку»

Страница проверки показывается, только когда в Защита → Проверка браузера включён переключатель «Показывать проверку». Без него режим «Проверка» и проверки из ваших правил не срабатывают.

Там же можно включить капчу-слайдер поверх проверки: никогда, во время атаки, для подозрительных посетителей или всегда.

Кто проходит без проверки

  • Подтверждённые поисковые и сервисные боты: Googlebot, Bingbot, Яндекс, Telegram и другие. Подробнее в статье «Известные боты».
  • Запросы к API с заголовком Authorization.
  • Запросы, которые открыты вашими правилами «Пропустить».
  • VPN-приложения на путях подписки, если они включены в Защита → VPN-приложения.

API и приложения

В режиме «Проверка» запросы, которые не могут показать страницу, — /api/, файлы, служебные запросы фреймворков — не получают страницу проверки, но проходят лимиты и WAF как обычно. Мобильным приложениям и интеграциям лучше передавать токен в заголовке Authorization.

Автоматически при атаке

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

  • Проверка браузера включается для новых посетителей, даже если сайт в пассивном режиме. Те, кто уже был на сайте, продолжают работать без проверки.
  • Выбранный вами режим не меняется. Проверка выключается сама после окончания атаки, но не раньше чем через 15 минут после её начала.
  • Вы получаете уведомление о начале и конце атаки.

Что дальше

Настройте свои правила и списки стран и адресов, затем смотрите журнал запросов: у каждого решения есть причина и Ray ID.