Plugin for Velocity and BungeeCord proxies that blocks user IPs based on their **A**utonomous**S**ystem**N**umber **(ASN)**. Protect your server against Layer 7 bot attacks with **ASN**-level filtering. > **WARNING!** This solution ~~is quick fix~~ does not guarantee complete protection against all bots, > however, it correctly performs the intended functionality. ## Localization The localization files are located in the `translations` directory of the plugin and support the [MiniMessage](https://docs.advntr.dev/minimessage/format.html) format. Localization files are generated automatically on the first plugin startup. The message shown when a user is blocked by **ASN** can be configured using the `asnblacklist.message.kick` key. > **Example:** > > ```properties > asnblacklist.message.kick=Your ASN is blacklisted on this server. > ``` > [![Disconnect reason](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/disconnect_reason_en.png)](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/disconnect_reason_en.png) If you need to display a message with line breaks, use the `` tag. > **Example:** > > ```properties > asnblacklist.message.kick=\ > Your ASN is blacklisted on this server. > ``` ## Configuration All duration formats must be specified using the standard **ISO 8601** format, for example: - `PT6H` → 6 hours - `P3D` → 3 days - `P2DT3H4M` → 2 days, 3 hours, 4 minutes --- > ### asn-blacklist > > Blacklisted ASN. You can look up information or obtain the ASN number [on website bgp.tools](https://bgp.tools/) > > **Example:** > > ```yaml > asn-blacklist: > - "AS35048" # Value with the AS prefix > - "53667" # Value without the AS prefix > ``` --- > ### maxmind-database > > MaxMind database settings. > > - `api-key` — MaxMind API key. The default configuration already includes a valid one. If necessary, you can use your own key generated [on the MaxMind website](https://www.maxmind.com/en/accounts/current/license-key). > - `file` — Path to the local database file > - `ttl` — Local database retention period (ISO 8601). After the retention period expires, the database will be downloaded again. > > **Example:** > > ```yaml > maxmind-database: > api-key: "apiKey" > file: "GeoLite2-ASN.mmdb" > ttl: "P3D" > ``` --- > ### cache-ttl > > Cache duration for verified ASNs (ISO 8601). > > **Example:** > > ```yaml > cache-ttl: "PT12H" > ``` --- ## Commands - `/asnblacklist` - Main command. Aliases - `/asnbl` - `/asnblacklist add ` - Add ASN to the blacklist. - `/asnblacklist remove ` - Remove ASN from the blacklist. - `/asnblacklist list` - Get blacklist of the ASN. - `/asnblacklist reload` - Reload configuration and localization. [![Commands](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/commands_en.png)](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/commands_en.png) ## Support and Feedback Please use the [GitHub issue tracker](https://github.com/novitpw/ans-blacklist/issues) to report bugs and submit suggestions. ## License The project is licensed under [GNU GPL v3.0 license](https://github.com/novitpw/asn-blacklist/LICENSE). --- # Описание на русском Плагин для прокси Velocity и BungeeCord, предназначенный для блокировки IP адресов пользователей по **A**utonomous**S**ystem**N**umber **(ASN)**. Блокировка по **ASN** позволяет серверам защититься от ботов на уровне L7. > **ВНИМАНИЕ!** Данное решение ~~является костылём~~ не гарантирует полноценную защиту от всех ботов, > однако, оно корректно выполняет задуманный функционал. ## Локализация Локализация находится в директории `translations` плагина, поддерживает формат [MiniMessage](https://docs.advntr.dev/minimessage/format.html). Файлы локализации создаются автоматически при первом запуске. Сообщение о блокировке пользователя по **ASN** настраивается с помощью ключа `asnblacklist.message.kick`. > **Пример:** > > ```properties > asnblacklist.message.kick=Ваш ASN заблокирован на данном сервере. > ``` > [![Причина отключения](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/disconnect_reason.png)](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/disconnect_reason.png) Если необходимо вывести сообщение с переносами строк, то необходимо использовать тег ``. > **Пример:** > > ```properties > asnblacklist.message.kick=\ > Ваш ASN заблокирован на данном сервере. > ``` ## Конфигурация Все форматы времени указываются в стандарте **ISO 8601**, например: - `PT6H` → 6 часов - `P3D` → 3 дня - `P2DT3H4M` → 2 дня, 3 часа, 4 минуты --- > ### asn-blacklist > > Список заблокированных ASN. Узнать информацию или получить номер ASN можно [на сайте bgp.tools](https://bgp.tools/) > > **Пример:** > > ```yaml > asn-blacklist: > - "AS35048" # Значение с префиксом AS > - "53667" # Значение без префикса AS > ``` --- > ### maxmind-database > > Настройки базы MaxMind. > > - `api-key` — Ключ API MaxMind. Конфигурация по умолчанию уже содержит действующий. При необходимости можно использовать собственный ключ, сгенерированный [на сайте MaxMind](https://www.maxmind.com/en/accounts/current/license-key). > - `file` — Путь к локальному файлу базы данных. > - `ttl` — Срок хранения локальной базы данных (в ISO 8601). После истечения срока база данных будет загружена повторно. > > **Пример:** > > ```yaml > maxmind-database: > api-key: "apiKey" > file: "GeoLite2-ASN.mmdb" > ttl: "P3D" > ``` --- > ### cache-ttl > > Продолжительность кэша для проверенных ASN (в ISO 8601). > > **Пример:** > > ```yaml > cache-ttl: "PT12H" > ``` --- ## Команды - `/asnblacklist` - Основная команда. Алиасы - `/asnbl` - `/asnblacklist add ` - Добавить ASN в список заблокированных. - `/asnblacklist remove ` - Удалить ASN из списка заблокированных. - `/asnblacklist list` - Получить список ASN, находящихся в блокировке. - `/asnblacklist reload` - Перезагрузить конфигурацию и локализацию. [![Причина отключения](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/commands.png)](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/commands.png) ## Поддержка и обратная связь Используйте [трекер проблем GitHub](https://github.com/novitpw/asn-blacklist/issues) для сообщений об ошибках и предложений. ## Лицензия Проект распространяется под [лицензией GNU GPL v3.0](https://github.com/novitpw/asn-blacklist/LICENSE).

_Novit_

AsnBlacklist

Информация