honeyprompt

Представляем honeyprompt — ориентированную на LLM обманную среду, созданную веб-разработчиками для веб-разработчиков. Личный проект-увлечение @alectrocute.

Поддерживает всех крупных облачных и локальных провайдеров LLM. SSH, HTTP, TLS, TCP, telnet и другое. Поставляется в виде небольшого контейнера (и одного статического бинарного файла), а все настройки собраны в одном honeyprompt.yaml.

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

Демо-экземпляр

Демо-экземпляр доступен по адресу 172.233.151.216, с неаутентифицированной веб-панелью здесь: http://172.233.151.216:9090. Это публичный экземпляр honeyprompt, работающий на дешевом VPS от Linode, с openrouter/free в качестве единственного провайдера/модели LLM.

Быстрый старт

Для самой простой настройки в 2026 году мы рекомендуем Docker и OpenRouter/openrouter/free в качестве провайдера LLM. Поддерживаются все крупные облачные и локальные провайдеры LLM. Три файла и одна команда поднимают полное развертывание по умолчанию: семь приманок на базе LLM, надежное хранение событий и панель оператора.

1. Загрузите конфигурацию по умолчанию, файл compose и шаблон .env:

# если у вас нет Docker:
# curl -fsSL get.docker.com -o get-docker.sh && sh get-docker.sh

mkdir honeypot && cd honeypot
wget https://raw.githubusercontent.com/alectrocute/honeyprompt/main/honeyprompt.yaml
wget https://raw.githubusercontent.com/alectrocute/honeyprompt/main/compose.yaml
wget -O .env https://raw.githubusercontent.com/alectrocute/honeyprompt/main/.env.example

(Или клонируйте репозиторий и перейдите в него — те же три файла.)

2. Заполните .env. Требуются два значения:

OPENROUTER_API_KEY=sk-or-...            # используйте выделенный ключ с лимитом расходов
HONEYPROMPT_PANEL_PASSWORD=changeme     # пароль для базовой аутентификации панели

3. Запустите:

docker compose up -d

4. Протестируйте:

ssh -p 2222 root@localhost            # пароль: root — затем введите что угодно
curl http://localhost:2375/v1.54/containers/json   # "открытый" API Docker

5. Наблюдайте за происходящим в панели только для чтения по адресу http://127.0.0.1:9090 (войдите как admin с паролем панели). Каждое подключение, учетные данные и команда транслируются в реальном времени. Если вы развернуты на удаленном хосте, вам нужно будет открыть порт :9090 в compose.yaml. Это не рекомендуется для продакшн-развертываний.

Для продакшн-развертываний используйте пронумерованный релиз вместо latest — установите HONEYPROMPT_IMAGE в .env.

Только что загруженный вами honeyprompt.yaml — это полностью аннотированная демонстрация. Он содержит профили для:

• Типичного корпоративного веб-сервера — порт 80, самая широкая сеть; / мгновенно отдает стандартную страницу приветствия nginx, а более глубокие пути передаются LLM для генерации полноценных HTML/CSS страниц интрасети, форм входа и панелей администратора, созданных, чтобы удержать атакующего.
• MCP / агентских шлюзов — Streamable HTTP обнаружение, метаданные OAuth, вызовы инструментов JSON-RPC и заманчивые производственные инструменты.
• Docker Engine API 29.5 — неаутентифицированная поверхность порта 2375, используемая реальными облачными червями.
• Kubernetes API v1.36 — обнаружение пространств имен, рабочих нагрузок, секретов, ConfigMap и RBAC.
• Инфраструктуры сборки AI на Ubuntu 26.04 — SSH, рабочие нагрузки GPU, Docker, kubeconfigs, состояние CI и учетные данные провайдеров.
• Redis 8.8 — типичные RESP-зонды, используемые для кражи учетных данных, сохранения состояния и латерального перемещения.
• Промышленного периферийного / OT оборудования — намеренно устаревшая плоскость управления Telnet, потому что современная защита все еще должна перехватывать атаки на старую инфраструктуру.

Запуск без LLM

[!ВАЖНО] Даже если вы используете LLM, определите наиболее часто используемые пути и добавьте для них статические правила. Это сэкономит огромное количество токенов LLM и ускорит ответы на запросы, которые не стоят затрат на вызов LLM. Случайные примеры: whoami, проверки работоспособности, favicon, зондирование версий и т.д.

Этот минимальный honeyprompt.yaml эмулирует SSH-машину с двумя статическими правилами и без LLM:

panel:
  enabled: true
  address: "0.0.0.0:8080"

events:
  buffer: 2000
  file: /data/events.jsonl # долговременная активность атакующего

services:
  - protocol: ssh
    address: "0.0.0.0:2222"
    description: "Ubuntu 26.04 LTS build runner"
    serverName: "gpu-runner-07"
    passwordRegex: "^(root|admin|123456)$" # какие пароли "работают"
    commands:
      - regex: "^whoami$"
        handler: "root"
      - regex: "^(.+)$"
        handler: "bash: command not found"

docker run --rm \
  -p 2222:2222 -p 8080:8080 \
  -v "$(pwd)/honeyprompt.yaml:/etc/honeyprompt/honeyprompt.yaml:ro" \
  -v honeyprompt-data:/data \
  alectrocute/honeyprompt:latest

Развертывание

Для постоянного развертывания используйте прилагаемый compose.yaml. Руководство по развертыванию охватывает выпуски на Docker Hub, необходимые секреты GitHub, настройку портов и брандмауэра, доступ к панели через SSH, обновления, откат, хранение событий и изоляцию.

Кратко: почему обман на основе LLM

От honeypot требуется только одно: оставаться убедительным достаточно долго, чтобы атакующий продолжал печатать. Каждая выполненная им команда — разведданные: инструменты, к которым он тянется, учетные данные, которые он использует повторно, уязвимости (CVE), которые, по его мнению, вы не исправили. Статические honeypot'ы теряют маскировку, как только кто-то выполняет команду, которую автор не предусмотрел. honeyprompt передает этот момент LLM, поэтому оболочка отвечает на dmesg | tail или cat /etc/shadow так, как ответила бы настоящая, и сессия продолжается.

Посмотрите отличную презентацию Adel Karimi на DEF CON 32 о Galah, (первом?) LLM honeypot, которая вдохновила этот проект: https://www.youtube.com/watch?v=XGsm4Qcc_Ag

Что логируется: два отдельных потока

Это стоит понять заранее, потому что эти два потока намеренно разделены:

• События обмана: Каждое взаимодействие атакующего: подключения, попытки аутентификации, каждая команда или запрос, ответ, отправленный honeyprompt, какой провайдер и модель ответили, и сколько времени это заняло. Это ваши данные об угрозах. Они хранятся в ограниченном буфере в памяти для панели в реальном времени, и вы можете сохранять все это на диск.
• Операционные логи: Запуск, какие порты были связаны, сбои провайдеров, остановка, внутренние ошибки. Это то, что вы читаете, когда неправильно ведет себя среда выполнения. Они не имеют ничего общего с активностью атакующего.

Вы настраиваете их отдельно:

# Мед: активность атакующего.
events:
  buffer: 2000 # последние события хранятся в памяти для панели
  file: /data/events.jsonl # сохраняет каждое событие в формате JSON Lines

# Собственная диагностика среды выполнения.
logging:
  level: info # debug | info | warn | error
  format: text # как выглядит на консоли: text (человеко-читаемый) или json
  file: /data/honeyprompt.log # опционально; на диске всегда JSON

events.jsonl — это один самодостаточный JSON-объект в строке — готов к tail -f, отправке в SIEM или воспроизведению с помощью jq. Команды Docker выше монтируют именованный том honeyprompt-data в /data, поэтому события переживают замену контейнера. Оба файла дополняются и сбрасываются при чистом завершении работы.

format влияет только на то, как операционные логи отображаются на консоли; файл операционных логов, если он включен, всегда структурированный JSON для удобства парсинга.

Веб-панель

Опциональная панель только для чтения транслирует события обмана по мере их возникновения, группирует по протоколу и позволяет экспортировать все в JSON одним кликом:

panel:
  enabled: true
  address: "0.0.0.0:8080"
  auth: # опциональная базовая аутентификация
    username: admin
    password: "${HONEYPROMPT_PANEL_PASSWORD}"

Панель — это простой HTML, CSS и JavaScript (src/panel/assets), встроенные в бинарный файл. Оставьте auth неопределенным, чтобы отключить аутентификацию.

Провайдеры

Каждый провайдер — это собственный модуль со своими таймаутами, повторными попытками, ограничениями скорости и заголовками. Ключи берутся из переменных окружения. Из коробки:

Балансировка нагрузки и отказоустойчивость

Настройте провайдеров, выберите pool.strategy (round-robin, weighted, random или failover), и honeyprompt будет распределять трафик между ними. Если выбранный провайдер превышает таймаут или возвращает повторяемую ошибку, honeyprompt прозрачно переключается на следующего — мертвый бэкенд никогда не выводит honeypot из строя. Неповторяемые ошибки (например, неверный ключ API) останавливают каскад, чтобы вы узнали о проблеме, а не тратили квоту молча.

Сервисы используют глобальный пул, если не указывают собственный поднабор провайдеров:

llm:
  enabled: true
  providers: [local-ollama] # одно имя: принудительно использовать этого провайдера для этого сервиса

Укажите несколько имен, чтобы сохранить балансировку нагрузки и отказоустойчивость, но только в пределах этого поднабора:

llm:
  enabled: true
  providers: [openai-primary, openrouter-backup]

Именованные пулы

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

pools:
  - name: cheap-first
    strategy: failover # сначала пробовать локальную модель, при сбое переходить на платный API
    order: [local-ollama, openrouter]
  - name: spread
    strategy: round-robin
    order: [openrouter, openai]

services:
  - protocol: ssh
    # ...
    llm:
      enabled: true
      providers: [cheap-first] # имя пула, вместо провайдера
  - protocol: http
    # ...
    llm:
      enabled: true
      providers: [spread]

Имя пула должно быть единственной записью в providers — смешивать пул с отдельными провайдерами в одном списке нельзя, так как было бы неясно, какая стратегия выигрывает. Имена пулов находятся в том же пространстве имен, что и имена провайдеров, и не могут с ними конфликтовать.

Расширение ответов с помощью хуков

Когда "соответствие регулярному выражению" или "запрос модели" недостаточно, хуки позволяют вставить собственный TypeScript в путь запроса и ответа. Хук может переписать промпт до того, как он попадет к модели, или переписать ответ до того, как он попадет к атакующему.

import { registerHook } from "./src/engine/hooks.ts";

registerHook({
  name: "fake-latency-notice",
  transformResponse(response, ctx) {
    if (ctx.protocol === "ssh" && /rm -rf/.test(ctx.input)) {
      return "rm: cannot remove '/': Operation not permitted\n";
    }
    return response;
  },
});

Ссылайтесь на него по имени из списка hooks: любого сервиса. Встроенный хук redact-secrets включен в пример конфигурации, чтобы модель никогда не могла выдать реальные учетные данные обратно.

Метрики

Метрики Prometheus доступны по пути /metrics на панели (без аутентификации, поэтому сборщики просто работают):

honeyprompt_events_total{protocol="ssh"}                          412
honeyprompt_llm_requests_total{provider="openai",protocol="ssh"}  118
honeyprompt_auth_attempts_total{protocol="ssh"}                    87
honeyprompt_engine_errors_total{protocol="http"}                   0

Сборка из исходников

Хотите внести вклад или нужен нативный бинарник? Вам понадобится Deno 2.x — единственная зависимость.

deno task check    # проверка типов
deno task lint
deno task fmt
deno task test     # модульные и интеграционные тесты

deno task start -- --config honeyprompt.yaml    # запуск локально
deno task dev   -- --config honeyprompt.yaml    # запуск с отслеживанием файлов
deno task compile                                # -> ./dist/honeyprompt (самодостаточный бинарник)

deno compile встраивает среду выполнения, ресурсы панели и все остальное в один исполняемый файл без каких-либо зависимостей. Готовые бинарники для Linux, macOS и Windows прикреплены к каждому помеченному релизу.

CI запускает форматирование, линтинг, проверку типов, тесты, проверку конфигурации, кроссплатформенную compile и сборку Docker при каждом пуше. Тегирование vX.Y.Z создает бинарники релиза и публикует образ для нескольких архитектур с подтверждением происхождения и SBOM в alectrocute/honeyprompt.

CLI

honeyprompt run [--config <path>]        запустить все настроенные сервисы (по умолчанию)
honeyprompt validate [--config <path>]   разобрать и проверить конфиг, затем выйти — отлично для CI
honeyprompt version
honeyprompt help

--config по умолчанию равен ./honeyprompt.yaml или $HONEYPROMPT_CONFIG, если задан (контейнер устанавливает его в /etc/honeyprompt/honeyprompt.yaml).

Предупреждение для пользователей и участников

Это инструмент для привлечения и изучения атакующих на инфраструктуру, которую вы контролируете или имеете право тестировать. Развертывание сервисов-приманок все равно означает развертывание сервисов; запускайте его на изолированных хостах, поддерживайте в актуальном состоянии и не направляйте на то, что вы не можете позволить себе зондировать. Обман не заменяет реальную защиту.

Если вы хотите внести вклад в этот проект и используете ИИ-агента или сильно полагаетесь на сгенерированный код, это совершенно нормально, но вас ОБЯЗАТЕЛЬНО лично спросят по каждой строке кода, которую вы предложите, и если вы не продемонстрируете немедленное понимание без помощи ИИ, ваш ВЕСЬ вклад будет отклонен и удален.

Лицензия

MIT.