Beelzebub CLI
Открытый фреймворк ловушек: поддельные SSH, HTTP, базы данных и MCP-инструменты на YAML, ответы можно поручить LLM, а действия атакующего пишутся в журнал
- 2 206 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Открывает сетевые слушатели, в том числе на привилегированных портах, и принимает трафик от посторонних, поэтому запускать надо на изолированном хосте
- Записывает команды и данные запросов атакующих и может передавать их в RabbitMQ или облачную платформу
- Плагины на Go выполняются внутри процесса с теми же правами
Установка
Ручная установка
git clone https://github.com/beelzebub-labs/beelzebub.git && cd beelzebub && ./install.sh --dockerЗапускайте только на изолированном лабораторном хосте: скрипт занимает привилегированные порты.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Открывает сетевые слушатели, в том числе на привилегированных портах, и принимает трафик от посторонних, поэтому запускать надо на изолированном хосте
- Записывает команды и данные запросов атакующих и может передавать их в RabbitMQ или облачную платформу
- Плагины на Go выполняются внутри процесса с теми же правами
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Beelzebub разворачивает приманки, которые выглядят как настоящие сервисы, и записывает все, что с ними делают. Службы, маршруты и правила ответов описываются в YAML. Статические обработчики отвечают предсказуемо, а для гибких диалогов можно подключить ответы языковой модели. Поддерживаются протоколы SSH, HTTP, TCP, TELNET и MCP. В каталоге `configurations/services` лежат 18 готовых примеров: SSH, RDP, VNC, WordPress, MySQL, PostgreSQL, Redis, SMB, LDAP, MQTT и другие. MCP-приманки показывают агентам ложные инструменты. Если агент вызывает такой инструмент, вызов фиксируется, и это помогает при контролируемых испытаниях на внедрение промптов. Автор оговаривает, что метод не гарантирует обнаружение каждой попытки. Зафиксированные данные (команды, детали HTTP-запросов, контекст сессии) можно читать в локальных журналах, отправлять в RabbitMQ или в облачную платформу Beelzebub. Метрики отдаются в Prometheus. Запускать можно локальным бинарником на Go, через Docker Compose или в Kubernetes с Helm. Свое поведение добавляют плагины на Go, которые выполняются внутри процесса.
Для кого. Для команд безопасности и исследователей, которые хотят изучать действия атакующих и проверять агентов на внедрение промптов в изолированной лаборатории.
Подходит, если
- Нужна приманка с поддельным SSH или TELNET, чтобы записывать команды, которые вводит атакующий
- Вы проверяете, поддается ли ваш агент внедрению промптов, и ставите MCP-приманку с ложными инструментами
- Нужна ловушка под WordPress, MySQL или Redis для записи сканирований, чтобы увидеть, кто и что пробует
- Журналы приманок нужно передавать в очередь RabbitMQ или собирать метрики в Prometheus
- В лаборатории нужен набор из 18 готовых конфигураций вместо ручного описания сервисов
Не подходит, если
- Нет изолированного лабораторного хоста: установщик занимает привилегированные порты и на Linux может включить сетевой режим хоста
- Нужен защитный экран или система обнаружения вторжений на рабочем сервере: приманки изучают активность, но трафик не фильтруют
- Нужна гарантия, что любая попытка внедрения промпта будет замечена: автор такой гарантии не дает
- Нет Git, оболочки и Docker Engine с Compose v2 для установки из репозитория
Пример запроса к агенту
Подними Beelzebub в Docker на лабораторном хосте, проверь HTTP-приманку на порту 8080 и покажи, как выглядит ее журналОграничения
- Фреймворк лицензирован по GPL v3.
- Для установки из репозитория нужны Git, оболочка и Docker Engine с Compose v2. Автор советует изолированный лабораторный хост с разрешением на все слушаемые порты: скрипт запускает набор примеров, в том числе на привилегированных портах, а на Linux может включить сетевой режим хоста, где Docker не изолирует сеть.
- Для ответов LLM нужен настроенный провайдер модели. Статические обработчики работают без него.
- Плагины на Go выполняются внутри процесса, поэтому исходный код плагина надо проверять и фиксировать доверенные версии.
- Перед открытием сервисов в интернет автор требует прочитать руководство по безопасной эксплуатации и использовать синтетические учетные данные.
- Подключение к облачной платформе Beelzebub необязательно, но без него отчеты остаются локальными.
Как отключить. Остановите лабораторию командой `docker compose down` в папке репозитория. Чтобы убрать установку целиком, удалите клонированную папку и образы Docker. Если включали сетевой режим хоста, проверьте, что слушатели приманок на машине закрыты.
Частые вопросы
Что такое Beelzebub и чем он занимается?
Это фреймворк ловушек (deception). Вы описываете в YAML поддельные сервисы, они отвечают атакующему, а фреймворк записывает его действия для расследования.
Как установить Beelzebub?
Склонируйте репозиторий и выполните `./install.sh --docker` в его папке. Нужны Git, оболочка и Docker Engine с Compose v2. Платформенный токен можно оставить пустым, тогда фреймворк работает независимо.
Как проверить, что приманка работает?
Выполните `curl -i http://localhost:8080/`. Встроенный HTTP-пример отвечает `401 Unauthorized`: так настроена приманка, и это подтверждает, что слушатель доступен. Журнал открывается командой `docker compose logs -f beelzebub`.
Для чего нужны MCP-приманки?
Они выставляют агентам ложные инструменты. Подозрительные вызовы фиксируются при контролируемых испытаниях, и это помогает заметить попытки внедрения промпта. Полного обнаружения всех попыток разработчик не обещает.
Нужна ли модель для ответов приманок?
Только для примеров с LLM, например SSH на порту 2222 и PostgreSQL. Для них нужен настроенный провайдер. Статические обработчики, например HTTP 401 или MySQL, работают без модели.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНабор для авторизованного багбаунти: 50 субагентов, 26 команд и 2 MCP-сервера площадок багбаунти для Claude Code, Codex и еще пяти агентов
ИИ-фреймворк для пентеста на своем сервере: граф поверхности атаки, Kali в контейнере, ручное одобрение шагов и MCP-сервер для Claude Code
Открытый инструмент для эмуляции атак на AI-агентов, LLM-приложения и MCP серверы, с проверкой по каталогам OWASP
MCP-сервер для наступательной безопасности: агент запускает более 150 инструментов пентеста и разведки и ведет автоматическую проверку целей
MCP-сервер платформы ARL-Next: по домену, IP или адресу сайта возвращает порты, отпечатки, сертификаты, уязвимости и утечки из вашей базы активов
Мост между MCP-клиентом и терминалом Kali Linux: агент запускает nmap, sqlmap, hydra и другие инструменты для авторизованного пентеста и CTF
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Beelzebub (эта запись) | да | 2 206 | |
| MCP Scanner | да | 1 096 | статически проверяет MCP-серверы на подозрительные инструменты, а Beelzebub выставляет приманки и ждет вызовов |
| Snyk Agent Scan | нет | 3 169 | проверяет уже установленные у вас скиллы и MCP-серверы, а Beelzebub ловит вызовы на поддельных инструментах |
Коротко о README
README объясняет три идеи: настраиваемые под вашу среду ловушки, наблюдение за тем, что происходит после контакта, и передачу данных в ваши процессы. Затем показана схема работы, таблица 18 примеров по категориям, установка в лаборатории и проверка. Завершают страницу описание облачной платформы, ссылки на документацию, руководство по плагинам и правила разработки.