Repolode
jamesalmeida

jamesalmeida/agent-honeypot

Файл-флаг для honeypot устанавливает контрольную точку и гостевую книгу, чтобы обнаруживать AI-агентов, которые заглядывают на вашу машину.

Звёзды
64
Форки
8
Открытые issues
1
Последний коммит
15 дней назад

Что это?

agent-honeypot размещает flag.txt в местах, которые может проверить заглянувший AI-агент: например, в домашнем каталоге, /etc, /tmp и домашнем каталоге root. В файле содержится обычное текстовое сообщение с просьбой к незнакомому агенту прекратить исследовать систему, не трогать секреты, исправлять только то, в чём он уверен, и отчитаться о проделанном.

Установщик также создаёт доступную для записи всем гостевую книгу ~/guest-book.txt, в которую посетитель может добавить строку с временной меткой и описанием того, кто он или что собой представляет и как попал на машину. Ваши собственные агенты, например opencode, Claude Code, Codex и Cursor, перечислены в файле-флаге: их не прерывают, и они не оставляют записей в гостевой книге.

Это контрольная точка, а не граница безопасности: флаг — недоверенный текст, который не выдаёт и не отбирает разрешения. Установщики доступны для Linux, macOS (с необязательной синтетической записью /flag.txt, для появления которой нужна перезагрузка) и Windows, где для создания symlink и доступа к некоторым защищённым путям требуется запустить PowerShell с повышенными правами.

Ключевые возможности

  • 01Устанавливает основной файл flag.txt и создаёт на него symlink в распространённых местах, где ищут информацию о системе.
  • 02Перечисляет в файле-флаге ваши собственные агенты, чтобы не прерывать их работу.
  • 03Создаёт доступную для записи всем гостевую книгу, в которую посетители могут добавлять записи, но не удалять их.
  • 04Предлагает необязательную синтетическую запись /flag.txt в macOS, которая появляется после перезагрузки.
  • 05Включает скрипты установки и удаления для Linux, macOS и Windows.

Сценарии использования

  • Оставить контрольную точку на личной машине для разработки и проверить, будут ли её исследовать неизвестные агенты.
  • Добавить триггер на общий сервер или CI-раннер, чтобы фиксировать, какие агенты туда приходят.
  • Экспериментировать с защитой AI-агентов от prompt injection в контролируемой среде.

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

  1. 1

    Клонируйте репозиторий

    git clone https://github.com/jamesalmeida/agent-honeypot.git
  2. 2

    Перейдите в каталог проекта

    cd agent-honeypot
  3. 3

    Запустите установщик в Linux или macOS

    ./install.sh

Что важно знать

  • Ничто не указывает агенту на расположение флага, поэтому он работает, только если агент случайно заглянет в эти места.
  • Флаг — это запрос на уровне промпта, и агент с некорректным поведением может его проигнорировать.
  • Гостевая книга основана на самоотчётах и доступна для записи всем, поэтому записи — это заявления, а не доказательства.
  • Для полной установки в Windows требуется сеанс PowerShell с повышенными правами.

В подборках

Темы

Частые вопросы

Что такое agent-honeypot?
Файл-флаг для honeypot устанавливает контрольную точку и гостевую книгу, чтобы обнаруживать AI-агентов, которые заглядывают на вашу машину. agent-honeypot размещает flag.txt в местах, которые может проверить заглянувший AI-агент: например, в домашнем каталоге, /etc, /tmp и домашнем каталоге root. В файле содержится обычное текстовое сообщение с просьбой к незнакомому агенту прекратить исследовать систему, не трогать секреты, исправлять только то, в чём он уверен, и отчитаться о проделанном.
agent-honeypot можно использовать бесплатно? Какая у него лицензия?
agent-honeypot распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
agent-honeypot всё ещё поддерживается?
Активно поддерживается. Последний коммит в agent-honeypot — 23 окт. 2026 г..
Для чего можно использовать agent-honeypot?
Оставить контрольную точку на личной машине для разработки и проверить, будут ли её исследовать неизвестные агенты. Добавить триггер на общий сервер или CI-раннер, чтобы фиксировать, какие агенты туда приходят. Экспериментировать с защитой AI-агентов от prompt injection в контролируемой среде.
Как установить agent-honeypot?
Клонируйте репозиторий: git clone https://github.com/jamesalmeida/agent-honeypot.git Перейдите в каталог проекта: cd agent-honeypot Запустите установщик в Linux или macOS: ./install.sh
Где скачать agent-honeypot?
Исходный код и инструкции по установке — на GitHub: https://github.com/jamesalmeida/agent-honeypot

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Подборка техник и реальных случаев злоупотребления локальными AI-агентами через их конфигурацию, состояние, инструменты и унаследованные права доступа.

100+1 за неделю6PythonCC0-1.0Активно поддерживаетсяОбновлён 4 дня назад

Обёртка для запуска Claude Code и других AI-агентов с автоматическим подтверждением действий в песочнице ОС или Docker, чтобы защитить компьютер.

42931ShellMITАктивно поддерживаетсяОбновлён в прошлом месяце