一份整理的技术目录与真实案例集,记录攻击者如何通过配置、状态、工具和继承权限滥用本地 AI 智能体。
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
克隆仓库
git clone https://github.com/jamesalmeida/agent-honeypot.git - 2
进入项目目录
cd agent-honeypot - 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 数据每日更新。
相关项目
一体化多蜜罐平台,可运行 20 多种蜜罐,配合 Elastic Stack 仪表盘与实时攻击地图。
基于 Go 的开源欺骗(蜜罐)框架,部署 SSH、HTTP、TCP、TELNET 和 MCP 诱饵服务并记录攻击者交互。
endlessh SSH 蜜罐的 Go 实现,导出 Prometheus 指标并配有 Grafana 仪表盘,用于查看攻击来源统计。
一个 Node.js 命令行工具,在 HTML 和 JavaScript 中嵌入可逆的带密钥提示诱饵注释,干扰 AI 安全评估代理。
为 Claude Code 等 AI 编程代理提供沙箱隔离,在原生沙箱或 Docker 中免确认运行,保护本机文件安全。