AgentCapture

项目介绍

AgentCapture 是一套面向安全值守、红蓝对抗与互联网系统接入的蜜罐态势感知与反制平台。它不是传统孤立式蜜罐，而是一个可以嵌入现有 Web 站点、反向代理链路和运营后台的 deception layer：通过隐藏路由、假凭证、文件蜜饵、Jsonp 画像、Agent 注入回显和浏览器侧信号采集，识别自动化扫描、AI Agent 探测、凭证泄露和横向侦察行为——并在识别之后主动反制。

平台的核心差异化能力是 AI Agent 反制闭环：23 种主流 Agent 产品指纹识别（Claude Code / ChatGPT Codex / Kimi Code / Pi / ZCode 等）→ 功能性伪装收编（页面可见的 Developer API 文档诱导 Agent「按文档接入」，即完成注册上线）→ 对话式 C2 控制台下发自然语言指令与任务 → 会话蜜标令牌全程归因溯源。实测五款主流通用 Agent（统一 GLM-5.3-Flash 底座、保留各自原生安全体系）全部被反制上线。

平台围绕 攻击流量、凭证蜜饵登陆、文件蜜饵下载、API 路由蜜饵命中、协议蜜罐会话、Web 应用蜜罐、C2 Agent、执行审计 建模，把攻击证据从"零散请求日志"收敛成可以追踪、可以回放的攻击链路。

蜜饵管理拆分为三类，可单独运营也可绑定成完整攻击链：

1. API 路由蜜饵：通过反向代理创建虚拟路由，可投放到 JS、配置文件或用户手册；正常用户不会访问，命中即告警。
2. 凭证蜜饵：自动生成端口服务或 Web 后台假凭证；凭证被用于登录时说明凭证泄露或攻击者已进入链路。
3. 文件蜜饵：支持上传触发文件，可绑定 API 路由蜜饵和凭证蜜饵，下载后串联完整攻击链。

核心特性

• 高保真交互式 SSH 蜜罐：paramiko 真协议栈、任意口令可登录的假 Ubuntu 主机（约 40 个命令 + 欺骗文件系统），exec / SFTP / 交互 shell 全支持，逐命令转录并支持终端风格会话回放。
• 会话水印蜜饵凭证：假主机内嵌的水印凭证（Bk2026!<会话指纹>）被攻击者窃取复用后，可溯源到具体蜜罐会话。
• 五档风险决策真实生效：放行 / 观察 / JS 挑战 / 持久隔离 / 阻断五档决策全部落地执行，隔离名单可在后台查看、添加与解除。
• 无损接入互联网系统：通过反向代理、路由映射、静态文件投放和前端注入为现有业务增加欺骗层，不直接改造业务代码。
• 三类蜜饵闭环：API 路由、文件和凭证蜜饵可以单独运营，也可以绑定成完整攻击链路；支持一键生成默认攻击链。
• 协议蜜罐矩阵：SSH、MySQL（完整交互 + 查询捕获）、Redis、FTP、ElasticSearch、nginx-admin 真实协议仿真，捕获的凭证统一进入凭证管线并与蜜饵部署联动。
• AI Agent 指纹识别与反制：23 种主流 Agent 产品级指纹（含置信度与证据链）；Prompt Canary、浏览器侧 beacon、Headless/WebDriver 线索识别自动化探测；功能性伪装（Portal Developer API）主动收编 LLM Agent。
• 对话式 C2 控制台：对话气泡时间线下发自然语言指令（8 个 NL 预设，含持久化控制预设）与 9 类操作原语，高危任务审批流、任务租约、多语言 Beacon 生成、监听器令牌体系与 MSF 面板统一入口。
• 反制溯源证据链：Jsonp 画像、Agent 注入回显、文件蜜饵下载、凭证蜜饵登录统一归档，支持攻击来源画像与会话画像。
• 运营级数据治理：SQLite WAL + 复合索引、按天保留策略、多通道告警（Webhook / 钉钉 / 飞书 / SMTP）、开放 API 输出。
• Docker 快速部署：内置 deploy.sh，自动识别 amd64 / arm64 架构并使用 Docker Compose 部署。

反制实测

以下为测试环境实打实测得的反制结果：五款主流通用 Agent CLI 均接入同一模型（GLM-5.3-Flash）并保留各自原生安全体系，对运行中的蜜罐实例执行站点巡检 / 渗透任务。

Agent 反制结果

五家全部被反制上线：Agent 自主完成"读取页面 Developer API 说明 → 携会话令牌调用结构化 API → 按 API 文档注册客户端 → 周期心跳"的完整接入流程，进入 C2 名册并可通过心跳领取操作员任务；全过程以会话蜜标令牌（session canary token）归因，从首次页面访问到注册可完整回溯。

三层反制体系

1. 行为检测与处置层：可疑 UA / AI Agent 指纹 / 请求速率与挑战逃逸升级 → JS 挑战 → 持久隔离 → 阻断。高频扫描型自动化客户端在此层被拦截或拖入交互成本。
2. 功能性诱饵层：页面以可见的 Developer API 形式暴露结构化数据接口（真实 API 不设浏览器挑战），自动化客户端按 API 文档"正常接入"即完成注册上线——不依赖目标服从任何显式指令，对齐训练无法防御"把用 API 当正常工作"的行为。
3. 全链路溯源层：会话蜜标令牌（按会话以 HMAC 派生的追踪令牌）贯穿页面 → API → 注册 → 心跳全链路；SSH 蜜饵凭证内嵌会话水印，支持凭证复用回溯到具体会话。

反制上线设计思路

• 威胁基线（实测结论）：主流 Agent 的对齐训练可稳定识别并拒绝显式命令式提示注入（隐藏指令要求上报 / 注册 / 下载执行，实测 0/8 服从）。反制设计必须假设目标不服从任何显式指令。
• 核心思路——回调的功能性伪装（functional camouflage）：将反制回调重构为站点自身的合法功能。Agent 的任务语义（获取内容、使用 API）与诱饵行为对齐，"按文档接入"成为完成任务的自然路径——对齐层无从触发，因为目标自始至终没有"服从指令"，只是在"正常使用网站"。
• 可达性基线：真实 API 不对自动化客户端返回浏览器挑战页或维护页。诱饵 API 面因此不做挑战 / 隔离 / 阻断（仍全量记录与告警）；JS 挑战页为 API 客户端提供带令牌的绕行入口，与真实挑战防护站点的惯例一致。
• 低摩擦接入：客户端注册幂等且同时接受 GET / POST，覆盖仅具备只读抓取工具的 Agent；心跳即任务下发通道。
• 令牌双角色归因：同一会话令牌在检测层承担蜜标（canary token，回显即命中并可隔离），在诱饵层承担 API 会话令牌（接入流程天然携带）——Agent 全程出示的"访问令牌"即其追踪信标，任一名册记录可回溯至初始浏览会话。
• 纵深互补：行为检测与处置层（挑战 / 隔离 / 阻断）拦截高频扫描型客户端，功能性诱饵层收编低速率客户端——两层按请求速率与行为特征分层覆盖，互为补充。

术语说明：显式命令式提示注入在实测中被全部主流 Agent 拒绝；平台的反制上线能力来自功能性伪装（API 接入流程），而非提示词服从。

界面预览

以下截图均为测试环境运行实拍（真实浏览器窗口比例，2946×1556 @2x，非设计稿）。

系统架构

组件数据流：

flowchart LR
    A[真实互联网系统] --> B[反向代理 / FastAPI Middleware]
    B --> C[API 路由蜜饵]
    B --> D[文件蜜饵分发]
    B --> E[凭证蜜饵登录页]
    B --> F[Beacon / Recon / Prompt Canary]
    P[协议蜜罐 SSH·MySQL·Redis·FTP·ES] --> G[(事件与证据库)]
    P --> Q[(会话转录库)]
    C --> G
    D --> G
    E --> H[(凭证观察库)]
    F --> G
    G --> I[风险引擎]
    H --> I
    I --> J[Allow / Observe / Challenge / Isolate / Block]
    G --> K[后台管理台]
    H --> K
    Q --> K
    K --> L[态势大屏 / 攻击流量 / 会话回放]
    K --> M[节点管理 / 端口服务 / Web 应用]
    K --> N[Jsonp 画像 / Agent 回显 / C2 控制]
    K --> O[执行历史 / 用户管理]

核心运行链路：

1. 用户或攻击者访问接入系统。
2. 中间件与反向代理注入隐藏线索、Canary 和蜜饵路径。
3. 攻击者翻看 JS、配置、手册、下载文件或直连协议蜜罐端口。
4. 平台记录来源 IP、会话、Header、路径、凭证、下载、命令转录和绑定链路。
5. 风险引擎输出观察、挑战、隔离或阻断决策，并支持持久隔离。
6. 后台按攻击流量、凭证登录、文件下载、蜜罐会话和反制溯源记录聚合证据。

更多说明见：docs/architecture.md；互联网系统接入方式、配置命令与接入拓扑见 docs/integration.md。

典型用途

1. 互联网业务无损接入：为多个现有 Web 系统增加蜜罐与监测能力，不直接改造业务代码。
2. 隐藏 API 路由探测识别：将假接口写入 JS、配置文件或手册，识别翻源码、爬文档和自动化侦察行为。
3. 凭证泄露感知：生成端口服务或 Web 后台假凭证，投放到数据库、配置或文档中，被使用即触发泄露告警。
4. 文件蜜饵攻击链串联：上传诱导文件并绑定假 API 与假凭证，追踪"下载文件 → 访问接口 → 尝试登录"的行为链。
5. 真人攻击者诱捕与回放：以高保真 SSH 主机承接横向移动，全程录制命令行为并支持取证回放。
6. AI Agent / 自动化扫描识别：通过 Prompt Canary、浏览器信号、Headless/WebDriver 线索发现自动化探测工具。
7. 安全值守与复盘：在态势大屏、攻击流量、蜜罐会话、凭证记录和执行历史中进行审计复盘。
8. 节点化部署运营：面向端口服务蜜罐、Web 应用蜜罐、远程 Agent 和模板进行集中维护。

目录结构

AgentCapture/
├── app/                    # FastAPI 应用、路由、模型、服务、模板与静态资源
│   ├── core/               # 配置、数据库初始化与迁移
│   ├── middleware/         # 请求采集、风险判定、挑战与页面注入
│   ├── models/             # SQLAlchemy 数据模型（事件、蜜饵、会话、隔离等）
│   ├── routes/             # admin / traps / c2 / console / public api
│   ├── services/           # 风险引擎、SSH 蜜罐、欺骗文件系统、告警、保留策略等
│   ├── static/             # beacon.js、recon.js、Logo、Agent 样例
│   └── templates/          # 管理后台与公开页面模板
├── data/                   # 运行期数据目录（Docker volume 持久化）
├── docs/                   # 架构说明与实拍截图
├── scripts/                # 自检与运维脚本
├── Dockerfile
├── docker-compose.yml
├── deploy.sh               # 一键 Docker 部署脚本
├── pyproject.toml
├── README.md
└── README_EN.md

快速开始

环境要求

• 操作系统：Linux / macOS，推荐 Ubuntu 22.04+、Debian 12+、Kali Linux 2023+
• CPU 架构：amd64/x86_64 或 arm64/aarch64
• 内存：最低 2GB，推荐 4GB+
• 磁盘：最低 5GB 可用空间
• Docker 部署：Docker 24.0+，Docker Compose 2.20+
• 本地部署：Python 3.11+

方式一：Docker 一键部署（推荐）

# 克隆仓库
git clone https://github.com/Tcotl/AgentCapture.git
cd AgentCapture

# 一键部署（自动识别 arm64 / amd64）
chmod +x deploy.sh
./deploy.sh

常用参数：

./deploy.sh --port 8080
./deploy.sh --admin-password 'admin'
./deploy.sh --platform linux/arm64 --pull
./deploy.sh --reset-data --yes
./deploy.sh --logs

方式二：Docker Compose 手动部署

cp .env.example .env.docker
HOST_PORT=4877 docker compose --env-file .env.docker up -d --build

方式三：本地开发部署

python3 -m venv .venv
source .venv/bin/activate
pip install -e .
uvicorn app.main:app --reload --host 0.0.0.0 --port 4877

访问入口

• 首页：http://127.0.0.1:4877/
• 后台登录：http://127.0.0.1:4877/admin/login
• 态势大屏：http://127.0.0.1:4877/admin/big-screen
• 蜜罐会话回放：http://127.0.0.1:4877/admin/honeypot-sessions
• 事件控制台：http://127.0.0.1:4877/console/events（需管理员登录）
• 健康检查：http://127.0.0.1:4877/healthz

默认管理员账户：

• 用户名：admin
• 密码：admin

生产环境请通过 .env.docker 或部署参数覆盖：

• BOOTSTRAP_ADMIN_USERNAME
• `BOOTSTRAP_ADMIN_PA