Сервер знакомого снесло за сорок секунд. Не «пошумели в чате» — залетело двенадцать аккаунтов, залили инвайты в каналы, скинули ссылки и ушли. Модератор в это время спал, потому что был третий час ночи. Утром разбирали.
После этого я написал бота, который держит такую волну сам. Не «антиспам по словам» — слова тут ни при чём, — а антирейд: смотрит, кто заходит и как быстро, находит группу связанных аккаунтов и снимает её целиком.
Главное решение, к которому я пришёл не сразу: вердикт считается по группе, а не по аккаунту. Один аккаунт, созданный три часа назад, без аватара — это нормально, так выглядят половина живых людей, которые зарегистрировались по ссылке из видео. Двенадцать таких за десять секунд — это ферма. По отдельности их не отличить, вместе — видно сразу.
Кластер собирается по четырём вещам: возрастная корзина (младше суток / младше недели / старше), наличие аватара, форма ника и общий префикс. Первая версия была слишком широкой и на моём же тесте забанила двенадцать разных людей с никами вроде korabel и matros — просто потому, что они все были свежие и без аватара. Пришлось добавить проверку на машинность: одинаковые ники, или последовательные числовые хвосты (odin1, odin2, odin3, с допуском на пропуски — генераторы рейдов иногда перескакивают номера), или общий префикс от пяти символов при одинаковой форме. И порог поднять с трёх до четырёх: три друга x1, x2, x3, зашедшие одновременно на игровой сервер, — обычное дело, четвёртый в той же серии за секунды — уже нет.
Порядок действий при входе тоже не с потолка. Первым проверяется вайтлист — раньше всех эвристик, потому что один ложный бан старого участника стоит дороже десяти пропущенных ботов. Дальше вердикт. Дальше локдаун — и вот здесь важная деталь: локдаун поднимается до первого бана, а не после. Если сначала отправить баны и дождаться ответов, следующие входы успеют пройти по мягкому пути, пока идёт HTTP. Уровень проверки гильдии уезжает с 1 на 4, и новые аккаунты просто не проходят.
Отдельная история, из-за которой такие боты и ломаются, — рейт-лимиты. Discord отвечает 429 с полем retry_after в теле и X-RateLimit-Reset-After в заголовках. Написать «забанить тридцать аккаунтов» циклом — значит потерять половину банов: часть запросов вернёт 429, и без разбора тела их никто не повторит, а гильдия останется забитой ботами. Поэтому транспорт отдельный, на aiohttp, и в нём три вещи: разбор retry_after, упреждающая пауза, если сервер сказал X-RateLimit-Remaining: 0, и повтор с бэкоффом на 5xx. Плюс причина в X-Audit-Log-Reason — иначе через неделю в аудит-логе гильдии будет пусто и никто не вспомнит, за что сняли человека.
В прогоне это видно на штурме: десять банов уходят одновременно, мок держит пять запросов за две секунды — тринадцать отказов 429, и все десять банов в итоге применены. Суммарные паузы по всем корутинам 27.59 секунды, но запросы ждут параллельно, так что по факту штурм занял около четырёх. Если бы retry_after игнорировался, применилось бы пять из десяти.
И откат. Ложная тревога случается чаще, чем кажется: раздача ключей, стример позвал зрителей, знакомые зашли пачкой с мультиаккаунтов. Поэтому баны пишутся в свою таблицу, и /guard revert снимает только их. Всё, что висело в гильдии с других источников, не трогается — иначе «откат» превращается в амнистию. В прогоне: девять банов, снято девять, повторный откат даёт ноль, потому что активных банов бота не осталось, и уровень проверки возвращается на прежний.
Про честность прогона, чтобы не было вопросов. Живого токена и гильдии у меня для этого нет, поэтому поднят mockdiscord.py — локальный сервер на aiohttp, который принимает PUT /v10/guilds/<g>/bans/<u>, DELETE, PATCH /guilds/<g> и POST /channels/<c>/messages. Подменён адрес, а не протокол: тела запросов, X-Audit-Log-Reason, заголовки X-RateLimit-*, настоящий 429 с retry_after, коды 204 и 404 — всё проходит по-настоящему. SQLite, детектор, локдаун, батчинг лога в канал — боевой код, не заглушки.
Чего в прогоне нет: gateway. События входа подаются прямо в Guard.on_join, а cog.py — адаптер discord.py — не запускался, для него нужен живой токен. Ядро под ним то же самое, адаптер только переводит discord.Member в снимок и вызывает on_join; но факт остаётся фактом, эта часть проверена глазами, а не запуском. Заодно в README написано, что нужно включить в Developer Portal: без Server Members Intent событие on_member_join просто не приходит, и бот молчит, выглядя абсолютно рабочим. И роль бота должна стоять выше ролей тех, кого он банит, иначе 403.
В архиве: detector.py (чистая логика, без сети и без discord), store.py, api.py (транспорт с 429), guard.py (ядро), cog.py, mockdiscord.py, make_transcript.py, transcript.txt целиком и selftest.py — десять сценариев с заранее известным ответом, от «двенадцать старых с аватаром» до «общий префикс, но хвосты случайные». Все десять проходят; на них и всплыло, что первая версия кластера банит живых людей.
Где это не спасает, чтобы не продавать лишнего:
— волна по два аккаунта в минуту окно в десять секунд не переполнит, и по скорости её не видно — ловится только кластером по никам, и то если ники шаблонные;
— прокси и случайные ники (qwkejr, mzqpwo) дают разные префиксы, кластера нет, остаётся только возраст аккаунта;
— аккаунты, которым роль выдали до атаки, бот не забанет: Discord вернёт 403, в лог уйдёт «НЕ УДАЛОСЬ»;
— в очень больших гильдиях gateway отдаёт события с задержкой, и окно в десять секунд начинает врать.
Лицензия — делайте что хотите. За баны в своём сервере отвечает тот, кто нажал запуск.