项目的 README,来自 github.com/zgsfsec/Full-Chain-Sentinel-System。合并为一个 markdown 文件:README.md。
简体中文 | English · 版本 2.3.1
知攻善防实验室出品,基于 pi 的授权渗透测试 Agent。通过中英文 Web 控制台,统一管理 Web、小程序与移动端测试、项目环境、审批和证据。
仅用于已获得书面授权的目标。 自动执行模式可运行任意命令,使用者须自行承担操作后果。使用前请阅读授权声明与安全边界。
交流群 · 快速开始 · 核心能力 · 常见问题 Q&A · 文档导航 · 许可
加入交流群请在打招呼内容中备注 「全链哨兵」。
先安装并启动 Docker,再从 Releases 选择与你的系统和架构匹配的压缩包。
Linux x64 示例:
tar -xzf sentinel-web-linux-x64.tar.gz
cd sentinel-web
chmod +x sentinel-web
./sentinel-web
Windows 解压 sentinel-web-windows-x64.zip 后,在 PowerShell 运行 .\sentinel-web.exe。请保留程序旁的 replayd/ 目录。
打开启动日志中的完整入口地址,设置账号密码并确认授权声明。在「设置 → 环境」准备工具镜像,在「设置 → 模型」添加端点并分配主模型,然后创建项目。
新项目包含工作容器与常驻网关,切换代理无需重建工作容器。
在对话中描述授权范围和目标,默认使用审批模式。移动端测试需先接入设备,再启用当前会话的对应工具。
安装部署与启动参数 · 源码运行 · 使用指南 · 设备接入
以下截图来自当前 v2.3.0 源码运行的完整控制台,使用独立本地项目、真实后端与 Docker 容器。尚未配置模型、没有记录或未接入设备的页面按实际状态展示。截图来源与更新方式。
汇总当前项目的运行任务、待审批项、漏洞与会话;从最近会话、运行状态和漏洞分布进入具体工作。

流式展示回复、思考与工具过程,支持会话分支、文件、终端和子代理。在输入区选择审批模式、预设 Agent、监督及设备工具;持续目标在自动执行或 AI 审批模式下续跑。

项目隔离工作目录、容器、会话与漏洞记录。新项目使用 Kali 工作容器和常驻网关;代理页管理 SOCKS5/HTTP、订阅、WireGuard 与 OpenVPN,运行中的项目可切换出口。


在漏洞页筛选、复核严重程度、CVSS、状态与证据,导出 Markdown 报告;资产库按项目归并域名、IP、服务和 URL,维护标签、测试记录与关联漏洞。


为当前项目启动 HTTP 显式代理、安装 HTTPS 解密证书,实时查看流量。按方法和状态筛选,检查请求与响应,并将选中的数据包发送到 WebFuzz。

多标签编辑原始 HTTP 请求,选择项目代理、直连或 MITM 路由,查看响应报文、正文和响应头,检索响应内容并回看历史。下图为真实请求本地文档服务得到的 200 响应。

将目标业务与接口整理成 OpenAPI 3.0 文档,在项目内查看建模状态、目标、接口数与实体,打开详情或导出文档。

检索和引用 Nuclei 模板;在「设置 → POC 订阅」管理官方或自建订阅源、同步计划和更新记录。模板同步与执行测试是不同操作。
手动同步、同步官方和定时同步均使用同步开始时当前项目的代理网络,重试不会跟随切换后的其他项目。未选择项目或项目不使用代理时,走宿主机网络;项目代理不可用时记录同步失败,不自动直连。订阅与模板库仍全局共享。


批量添加 GitHub / GitHub Enterprise 仓库和分支,按固定间隔或 Cron 监控新提交。动态页集中处理安全更新、判定失败与检查异常,支持复现、重判、忽略与日志回溯;复现会准备漏洞版和修复版源码并新建工程。


通过 DroidBridge 与 SentinelBridge 接入测试设备,管理反连凭据与连接状态,按会话启用 shell、文件、抓包、动态调试和应用分析工具。安卓需 root,iOS 需越狱;截图时没有接入设备。


粘贴授权目标清单、选择指挥思路,由指挥官组织多个测试任务,查看任务状态、进度和提交结果。工程模式适合批量工作,仍处于测试阶段。

支持人工审批、自动执行与 AI 审批。审批页区分 AI 判定和自动审批流水,按项目、会话、来源、时间与关键词回溯;AI 判定失败或超时会放行,完整范围见安全边界。

对话可启用监督模型与介入策略。监督页汇总会话阶段、进展、停滞、循环、建议与 Token 使用,便于定位任务为何继续或停止;具体策略在设置中配置。

模型库集中管理端点,将主模型、守门、漏洞评审、监督、指挥和监测六个角色分配给不同模型。环境页检查 Docker、镜像、挂载与目录权限,并管理镜像源、网络与默认代理。
添加或编辑模型时,可使用当前 Base URL 和 API Key「获取远端模型列表」,搜索并选择模型 ID,无需先保存;支持 OpenAI 兼容、Anthropic 和 Gemini 接口。已有模型可复用已保存的密钥;服务商未提供列表接口时仍可手动填写,模型能力与价格需单独核对。



按 Agent 类型管理工具权限与插件访问范围;维护可复用的身份、背景和任务指令,在对话或编排任务中选择对应预设。


配置 FOFA、360 Quake、奇安信 Hunter 与 Tavily;管理密钥、验证状态、额度和查询记录。启用权限且凭据验证通过后,对应工具才会挂载给 Agent。


连接 HTTP、SSE 或 stdio MCP 服务器;管理本地和远端插件主机,安装官方插件或上传插件包。插件可提供独立前端,开发页提供完整规范。


在「设置 → 通知」创建多个全局通知组,每组独立选择运行报告、高危漏洞、开源情报、持续目标、工程完成和 POC 同步失败等事件,可添加多个钉钉、飞书与企业微信群机器人,同类型不限一个。自动通知按类别发送到匹配的启用组;对话中手动开启通知时发送到所有启用组。组与机器人可独立启停、逐个测试,最近投递结果按组和机器人展示。现有配置会自动读取为默认通知组,保留原有渠道、类别与正文字数上限。

从对话页打开「文件」,上传、预览项目产物,或将目录打包下载。Agent 可用 replay_capture 将真实请求与响应保存为 PNG 证据,用 replay_flows 查询历史;取证截图经过审批链。

跟随全局项目,统一归档普通会话、自主目标、工程任务和工程总报告。Agent 完成实质测试任务时主动提交 Markdown 报告与证据图片,普通问答不生成报告;工程总报告归档成功后再结束工程。
支持搜索、来源筛选、Markdown 渲染与源文查看、图片放大、下载和删除。点击「编辑」后,左侧修改标题与 Markdown,右侧实时预览,支持保存、取消、草稿恢复和修改冲突提示。已有图片独立保存,容器停止、重建或删除后仍可查看;含图片的报告下载为包含正文与图片的 ZIP,无图片时下载 Markdown。
编辑器保留已有归档图片,暂不上传新图片。完整提交方式、图片限制与数据清理规则见报告中心使用说明。
使用中的常见问题与解答集中维护在独立页面:查看常见问题 Q&A。
| 我想了解 | 文档 |
|---|---|
| 安装、HTTPS、启动参数、常驻运行 | 安装部署 |
| 完整功能与配置条件 | 功能详解 |
| 创建项目、Web / 小程序、工程、审批与 POC | 使用指南 |
| HTTP 代理、HTTPS 证书与流量查询 | MITM 中心 |
| 原始 HTTP 手动发包与响应检查 | WebFuzz |
| 安卓与 iOS 设备接入 | 移动端指南 |
| 代理切换、网关与旧项目迁移 | 项目网关 |
| 资产上报、关联漏洞与导出 | 资产库 |
| 报告提交、图片归档、实时编辑与下载 | 报告中心 |
| 安装本地 / 远端插件 | 插件中心 |
| 开发插件与插件前端 | 插件开发 · 插件前端 |
| 仓库结构、构建与测试 | 开发指南 |
| 授权、审批范围与数据边界 | 授权声明与安全边界 |
本项目是 pi 的衍生作品(fork),不是上游官方项目,与上游团队无关。
上游代码以 MIT 许可发布,版权归 Mario Zechner,许可全文见 LICENSE;本仓库保留该许可与版权声明,并在此基础上加入渗透测试相关的系统提示、Web 控制台、容器化作业环境与安卓设备插件。