ScanGuard

Telegram-бот для администратора VPS. Он читает логи nginx, Caddy и SSH, находит сканеры и присылает карточку с расшифровкой IP: страна, хост, ASN, провайдер, теги. Под карточкой кнопки «Забанить», «Скип» и «В белый список». Работает на вашем сервере, открытый код под лицензией MIT.

Подключитесь к VPS по SSH под root и выполните одну команду: bash <(curl -Ls https://1344.pl/downloads/scanguard/get.sh). Установщик спросит токен бота и ваш Telegram ID, найдёт логи и фаервол, создаст службу и запустит её. После этого напишите боту /menu.

Токен выдаёт @BotFather после команды /newbot. Числовой ID покажет бот @userinfobot. Установщик проверяет токен запросом к Telegram, поэтому неверный токен он не примет.

Ставит Python, venv, git и curl через пакетный менеджер системы, копирует проект в /opt/scanguard и ставит зависимости в виртуальное окружение. Записывает конфиг в /etc/scanguard/scanguard.env с правами 600, создаёт службу systemd scanguard и команду scanguard. Ваш SSH-адрес он добавляет в белый список, чтобы вы не забанили себя.

Да. Передайте токен и ID переменными и добавьте ключ --yes: BOT_TOKEN=... ADMIN_IDS=... bash <(curl -Ls https://1344.pl/downloads/scanguard/get.sh) --yes. Это удобно для скриптов и для нескольких серверов.

На Linux с systemd: Ubuntu, Debian, Fedora, RHEL-семейство, Arch и Alpine. Нужен Python 3.9 и новее. Установщик рассчитан на эти системы, но на реальном сервере пока не прогонялся, поэтому о проблемах сообщайте.

nginx читается в стандартном формате combined (/var/log/nginx/access.log). Для Caddy нужен JSON-лог: добавьте в Caddyfile блок log с output file и format json. SSH читается из /var/log/auth.log или /var/log/secure, а если файла нет, из journald. Пути можно изменить в /etc/scanguard/scanguard.env.

Через ufw, nftables или iptables, на выбор при установке. Можно задать свою команду, например fail2ban-client set sshd banip {ip}. Бан закрывает все порты для этого IP. Для nft и iptables бот восстанавливает баны из базы после перезагрузки сервера.

Нет. Приватные и локальные адреса, IP самого сервера, ваш SSH-адрес на момент установки и всё из белого списка бот не банит и не показывает в алертах. Белый список пополняется кнопкой под карточкой или в меню.

Вы добавляете в боте свои CIDR, ASN и ключевые слова (меню «РКН-правила»). Запрос с адреса из CIDR даёт алерт сразу. Совпадение по ASN или слову в названии провайдера добавляет метку «РКН/ГРЧЦ» в карточку. Официального публичного списка адресов проверок нет, поэтому диапазоны вы подбираете сами по своим логам.

Выполните scanguard status и scanguard logs. Частые причины: неверный токен или ID в /etc/scanguard/scanguard.env, вы не нажали /start у бота, в настройках выключен нужный источник, пути к логам указаны неверно, либо мониторинг стоит на паузе. После правки конфига выполните scanguard restart.

Бот общается с Telegram, чтобы присылать вам сообщения. Для расшифровки IP он отправляет адрес сканера на ip-api.com по HTTP, лимит бесплатного плана 45 запросов в минуту. Остальное остаётся на вашем сервере. Логи и содержимое запросов никуда не отправляются.

Да, но у каждого сервера своя установка и свой бот. Один токен нельзя использовать на двух серверах: Telegram позволяет только одному процессу получать сообщения. Создайте по боту на сервер у @BotFather и укажите свой ID для каждого.

Владельцы указываются при установке (ADMIN_IDS). Дополнительных админов владелец добавляет в боте: /menu, «Админы», «Добавить админа», затем числовой Telegram ID. Остальные пользователи бота игнорируются.

Выполните scanguard update. Команда скачивает свежий бандл с 1344.pl, проверяет SHA-256, обновляет код и перезапускает службу. Конфиг и база сохраняются.

Команда scanguard uninstall останавливает службу и удаляет код и команду. Конфиг, базу и таблицу nft она удаляет только после вашего подтверждения. Правила ufw и iptables, добавленные ботом, остаются: снимите их вручную, если нужно.

MIT. Исходный код входит в архив, который вы скачиваете, и вы можете просмотреть его перед установкой.