Фильтр ссылок

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

Коротко#

Фильтр ссылок умеет отдельно управлять разными типами ссылок. Для доверенных доменов используйте белый список, для известных плохих источников — чёрный.

Как это работает#

1. Defendy определяет тип найденного элемента: внешний сайт, источник Telegram, инвайт, IP-адрес или упоминание.
2. Для обычных источников применяется выбранный режим и соответствующий список. Включённые проверки инвайтов и цитат действуют отдельно; белый список их не отменяет. Исключения популярных сайтов проверяются раньше чёрного списка.
3. Если элемент запрещён, Defendy удаляет сообщение при включённом удалении и применяет выбранное действие.

Настройка в мини-приложении#

Откройте «Настройки» в личном чате с @defendy_bot, выберите группу в «Мои группы» и проверьте её название сверху.

1. Откройте «Антиспам» → «Ссылки» и включите фильтр.
2. Отдельно выберите режим для «Веб-сайты» и «Каналы и чаты».
3. Настройте исключения и проверки в появившихся блоках.
4. Откройте белый/чёрный список, нажмите «Добавить», выберите тип записи, введите значения или загрузите TXT и нажмите «Сохранить».

Переключатели и списки выбора сохраняются при изменении. Если открыта отдельная форма с кнопкой «Сохранить», нажмите её перед выходом. При ошибке снова откройте раздел и проверьте фактические значения.

Разбор каждой настройки#

Включить фильтр#

По умолчанию: Выключено.

Включает фильтрацию ссылок в группе.

Удаление сообщения с нарушением#

По умолчанию в настройках: Включено.

Удаление сообщения и наказание участника — разные последствия. В текущем экране ссылок отдельный переключатель удаления не выведен: рядом с наказанием указано, что сообщение удаляется. Действие «Нет» не отключает удаление. Для проверки используйте подготовленные сообщения в тестовой группе; чтобы остановить работу модуля целиком, выключите фильтр.

Действие#

По умолчанию: Нет.

Что делает Defendy после нарушения: ничего, предупреждение, уведомление, мут, кик или бан в зависимости от функции.

Длительность действия#

Начальное значение: 1 час (3600 секунд).

Срок мута или бана, когда выбранное действие поддерживает длительность. Ноль означает бессрочное действие там, где оно поддерживается. После смены действия заново проверьте срок.

Вес предупреждения#

По умолчанию: 1.

Сколько баллов предупреждений это нарушение добавляет в систему варнов.

Режим внешних ссылок#

По умолчанию: Выключено.

«Не трогать», «Удалять» или «Чёрный список». «Удалять» проверяет отсутствие источника в белом списке; «Чёрный список» проверяет наличие в запрещённом списке.

Разрешить топ сайтов#

По умолчанию: Выключено.

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

Разрешить топ Runet#

По умолчанию: Выключено.

То же правило для встроенного списка популярных ресурсов Рунета. Перед включением проверьте полные списки доменов.

Некликабельные внешние ссылки#

По умолчанию: Включено.

Обрабатывает ссылки, которые Telegram показывает как текст, а не как кликабельный URL.

Режим Telegram-ссылок#

По умолчанию: Выключено.

«Не трогать», «Удалять» или «Чёрный список» для обычных Telegram-источников. «Не трогать» не отключает самостоятельные проверки инвайтов и цитат.

Реагировать на IP-адреса#

По умолчанию: Выключено.

Включает реакцию на числовые адреса. Проверенная специальная обработка исключения IP распознаёт IPv4; не считайте это обещанием одинаковой обработки IPv6. В хранилище параметр обратный (ignore_ip_addresses), поэтому по умолчанию переключатель выключен. Проверяйте нужный формат адреса отдельно.

Инвайт-ссылки#

По умолчанию: Включено.

Обрабатывает приглашения вида t.me/joinchat/..., t.me/+..., а также некоторые ссылки запуска ботов с параметрами. Если ссылка распознана как инвайт при включённой проверке, обычный белый список не отменяет срабатывание. Проверка может действовать и при режиме «Не трогать» для обычных Telegram-ссылок.

Цитаты из групп#

По умолчанию: Выключено.

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

Упоминания пользователей#

По умолчанию: Выключено (элемент недоступен).

Зарезервированная настройка разрешения @username. В текущем WebApp элемент заблокирован, поэтому администратор пока не может его изменить.

Практический пример#

В чате проекта можно выбрать для сайтов «Удалять» и добавить example.com и docs.example.com в белый список отдельными доменными записями. Проверьте оба адреса от обычного участника. Для Telegram отдельно проверьте публичную ссылку, приглашение, ссылку на пост и упоминание человека: недоступный переключатель упоминаний не гарантирует исключение для всех пользователей. Замаскированные записи вида site[.]com также проверяйте отдельно.

Рекомендации#

• В форме списка доступны типы «Домен», «IP-адрес» и «Telegram». Проверенная логика сравнивает выделенное имя с записью точно, без учёта регистра. Поддомены добавляйте отдельно; не рассчитывайте на расширение масок и CIDR-диапазонов, несмотря на подсказки формы. Используйте конкретные значения и контрольные сообщения.
• Режим «Чёрный список» сохраняет больше полезных новых источников, но не блокирует незнакомый источник только за то, что он новый. Выбирайте режим по правилам сообщества.

Если не работает#

• Проверьте, что Defendy всё ещё администратор группы.
• Обновите панель настроек и убедитесь, что редактируете правильную группу.
• Если настройка сохраняется, но не работает, проверьте права бота в Telegram.
• Если журнал действий уже подключён и нужная категория включена, проверьте запись о событии. Журнал не покажет события, которые не записывались.

Проверьте срок наказания#

После смены типа наказания заново проверьте длительность: форма может сбросить её в 0. Ноль означает бессрочное действие там, где оно поддерживается, а не отключение наказания. Для временного мута минимальный срок — 60 секунд.