Repolode
jamesalmeida

jamesalmeida/agent-honeypot

一个蜜罐式 flag 文件,用于在 AI 智能体误入你的机器时留下提示并记录访客。

Star
64
Fork
8
未关闭 Issue
1
最近提交
14天前

这是什么?

agent-honeypot 会在访客智能体可能查看的位置放置 flag.txt,包括主目录、/etc、/tmp 和 root 目录等。文件内容是一段纯文本提示,请陌生的智能体停止探索、不要触碰敏感信息、只修复能确定的问题,并向你汇报。

安装脚本还会在 ~/guest-book.txt 创建一个只能追加、所有用户可写的访客簿,访客可以留下一行带时间戳的记录,说明自己是谁或是什么、如何进入的。flag 中也列出了你自己的智能体(如 opencode、Claude Code、Codex、Cursor),让它们不会被打断,也不会签署访客簿。

它是一个提示性的检查点,而不是安全边界:flag 只是不可信的文本,不会授予或收回任何权限。项目提供 Linux、macOS 和 Windows 的安装脚本;macOS 可选择写入需重启生效的 /flag.txt,Windows 的符号链接和部分受保护路径则需要以管理员身份运行 PowerShell。

核心功能

  • 01安装统一的 flag.txt,并通过符号链接放到常见的探测位置。
  • 02在 flag 中列出你自己的智能体,避免它们被打断。
  • 03提供只能追加、所有用户可写的访客簿供访客留言。
  • 04macOS 可选写入 /flag.txt,需重启后生效。
  • 05为 Linux、macOS 和 Windows 提供安装与卸载脚本。

适用场景

  • 在个人开发机上放置检查点,观察是否有未知智能体在探查。
  • 在共享服务器或 CI 运行器上设置触发器,记录来访的智能体。
  • 在受控环境中试验针对 AI 智能体的提示注入防御。

快速上手

  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 是什么?
一个蜜罐式 flag 文件,用于在 AI 智能体误入你的机器时留下提示并记录访客。 agent-honeypot 会在访客智能体可能查看的位置放置 flag.txt,包括主目录、/etc、/tmp 和 root 目录等。文件内容是一段纯文本提示,请陌生的智能体停止探索、不要触碰敏感信息、只修复能确定的问题,并向你汇报。
agent-honeypot 可以免费使用吗?用的什么许可证?
agent-honeypot 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
agent-honeypot 还在维护吗?
活跃维护中。agent-honeypot 最近一次提交是在 2026年10月23日。
agent-honeypot 适合用来做什么?
在个人开发机上放置检查点,观察是否有未知智能体在探查。 在共享服务器或 CI 运行器上设置触发器,记录来访的智能体。 在受控环境中试验针对 AI 智能体的提示注入防御。
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

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目