[!NOTE] Shannon 2.0 正式发布

Shannon - Keygraph 出品的 AI 渗透测试器

Shannon 是一款面向 Web 应用和 API 的自主 AI 渗透测试器。
它会分析你的源代码，识别攻击路径，并在漏洞进入生产环境之前执行真实漏洞利用来加以证明。

本仓库是 Shannon 开源版：完整智能体，可通过命令行在本地运行。

---

---

[!TIP] AI 智能体和 LLM： 请从 llms.txt 入手获取本仓库的简明地图，或使用 llms-full.txt 获取将 README 和文档合并为一个文件的版本。

目录

• 什么是 Shannon？
• Shannon 实战演示
• 快速开始
• 核心能力
• 版本
• 架构
• 文档
• 安全性、范围与限制
• 许可证
• 关于 Keygraph
• 社区与支持

什么是 Shannon？

Shannon 是由 Keygraph 开发的自主 AI 渗透测试器。它将源代码分析与实时漏洞利用相结合，对 Web 应用及其底层 API 执行安全测试。

Shannon 会分析你的 Web 应用源代码以识别潜在攻击向量，然后使用浏览器自动化和命令行工具，对运行中的应用及其 API 执行真实漏洞利用。最终报告只收录具有可用概念验证（PoC）的漏洞。

Shannon 就是那个智能体。本仓库是 Shannon 开源版，即由你自己运行的独立渗透测试器。同一个 Shannon 也为 Keygraph 平台（Keygraph 的商业渗透测试产品）提供支持。两者的对比请参阅版本。

Shannon 存在的意义

得益于 Claude Code 和 Cursor 等工具，你的团队可以一刻不停地交付代码。但你的渗透测试呢？一年才进行一次。这就造成了巨大的安全缺口。在其余 364 天里，你可能正在不知不觉中将漏洞交付到生产环境。

Shannon 通过提供按需、自动化的渗透测试来弥合这一缺口，可针对每一次构建或发布运行。

Shannon 实战演示

以下是 Shannon 开源版针对故意留有漏洞的应用程序生成的渗透测试报告示例：

快速开始

前提条件

• Docker：worker 容器所需。
• Node.js 18+：推荐的 npx 工作流所需。
• AI 提供商凭据：Anthropic、OpenAI、xAI 或 AWS Bedrock——或任何其他提供商。推荐使用 Claude 模型。关于各提供商建议的模型 ID，以及网关和自定义 base URL，请参阅 AI 提供商。
• 已通过提供商的网络安全防护审查：Anthropic 和 OpenAI 会对网络安全工作负载应用实时防护，这可能导致扫描中途中断。在首次运行前，请先完成他们为合法安全测试人员提供的指引——请参阅 AI 提供商。

运行 Shannon

[!WARNING] Shannon 会主动执行漏洞利用。请仅针对你拥有或已获得明确书面授权测试的应用和环境运行它。请勿对生产系统运行 Shannon。

# Configure credentials with the interactive wizard.
npx @keygraph/shannon setup

# Run a pentest against a source-available target.
npx @keygraph/shannon start -u https://your-app.com -r /path/to/your-repo

Shannon 会从 Docker Hub 拉取 worker 镜像，启动所需的本地基础设施，以只读方式将目标仓库挂载到临时 worker 容器中，并将结果写入本地工作区。

关于源码构建、认证扫描、特定提供商的设置以及平台说明，请参阅文档。

[!TIP] 更倾向于使用订阅而不是 API 额度？

• OpenAI Codex： 最新版 Shannon 支持 ChatGPT Plus 和 Pro 订阅。请按照 OpenAI Codex 订阅设置指南 开始使用。
• Claude Code： 最新版 Shannon 不支持 Claude Code 订阅。请按照 Claude Code 订阅设置指南 使用 1.9.0 版本，它是基于 Claude Agent SDK 的最终发布版。

核心能力

• 以漏洞利用为证明的报告：Shannon 报告经过验证的发现，并附上可复现的概念验证步骤，而非推测性警告。
• 白盒攻击规划：Shannon 使用源代码分析来指导动态测试，并聚焦于现实可行的攻击路径。
• 自主执行：Shannon 通过一条命令即可启动侦察、漏洞分析、漏洞利用和报告生成。
• 认证测试：配置文件可以描述登录流程、测试凭据、TOTP、基于邮件的登录流程、重点领域和交战规则。
• 聚焦 OWASP 漏洞：Shannon 针对可利用的注入、XSS、SSRF、认证失效和授权失效问题。
• 可恢复的工作区：Shannon 可以恢复中断的运行，而无需重新运行已完成的智能体。

版本

Shannon 以两种方式提供：Shannon 开源版（由你自己运行的渗透测试器）和 Keygraph 平台（持续运行 Shannon 并围绕其闭环完整 AppSec 生命周期的商业渗透测试产品）。

Shannon 开源版（本仓库）是独立的渗透测试器：一个用于白盒、以漏洞利用为证明的 CLI 智能体，可对你拥有或获授权测试的 Web 应用和 API 进行测试。它读取你的源代码，规划攻击，执行真实漏洞利用，并且只报告它能证明的内容。它按需运行，在其定位上已经完整。你将它指向一个目标，它执行渗透测试，然后输出报告。

Keygraph 平台 是一款由 Shannon 驱动、面向企业就绪的持续渗透测试产品。在 Keygraph 平台中，增强版 Shannon 会在一个经加固和编排的环境中持续运行，该环境以 Keygraph 的完整代码分析栈为数据来源。围绕这一引擎，平台闭环了从分析到经核验修复的完整漏洞生命周期：

• 分析（Analyze）：Code Property Graph SAST、带可达性分析的 SCA、密钥、IaC 和容器扫描。它们本身是一流的检测手段，也是让 Shannon 的攻击更精准的上下文。
• 证明（Prove）：自主黑盒和基于源码的白盒渗透测试，将候选发现转化为已被证明、已被利用的漏洞，而非推测性告警。
• 管理（Manage）：每个仓库的每个漏洞都有一条规范记录，跨所有来源去重，并具备负责人、状态、SLA 跟踪、仪表盘和双向 Jira 同步。
• 修复与验证（Remediate and verify）：自动编写补丁，并在交付前针对打过补丁的代码重新测试；补丁会进入你现有的审查工作流，而非自动应用。
• 部署（Deploy）：自托管和物理隔离（air-gapped）环境、严格的自带密钥（BYOK）模型访问，以及由客户控制的 LLM 网关模式，确保源码、结果和模型流量始终留在你的网络边界之内。

Shannon 是 Keygraph 平台核心的证明引擎。Shannon 开源版让你可以自行运行这一引擎。Keygraph 平台则围绕 Shannon 提供持续分析、发现管理、修复、验证和企业级部署。

欢迎访问 Keygraph 网站 了解更多，阅读 Keygraph 平台技术概览，开始免费试用或预约演示，或联系 [email protected]。

架构

Shannon 采用将源代码分析与实时漏洞利用相结合的多智能体工作流：

        ┌──────────────────────┐
        │   Pre-Reconnaissance │
        │   (source code scan) │
        └──────────┬───────────┘
                   │
                   ▼
        ┌──────────────────────┐
        │   Reconnaissance     │
        │  (attack surface     │
        │   mapping)           │
        └──────────┬───────────┘
                   │
                   ▼
        ┌──────────┴───────────┐
        │          │           │
        ▼          ▼           ▼
  ┌───────────┐ ┌───────────┐ ┌───────────┐
  │ Vuln      │ │ Vuln      │ │   ...     │
  │(Injection)│ │  (XSS)    │ │           │
  └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
        │              │             │
        ▼              ▼             ▼
  ┌───────────┐ ┌───────────┐ ┌───────────┐
  │ Exploit   │ │ Exploit   │ │   ...     │
  │(Injection)│ │  (XSS)    │ │           │
  └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
        │              │             │
        └──────┬───────┴─────────────┘
               │
               ▼
        ┌──────────────────────┐
        │      Reporting       │
        └──────────────────────┘

从宏观层面来看：

• 预侦察：从仓库中识别框架、入口点、数据流和可能的攻击面。
• 侦察：探查实时应用，并将运行时行为与代码级上下文关联起来。
• 漏洞分析：运行专门针对注入、XSS、SSRF、身份认证和授权的智能体。
• 漏洞利用：尝试真实的概念验证攻击，并舍弃无法被证明的假设。
• 报告：将经过验证的发现、证据和修复建议汇编成最终的 Markdown 报告。

每次扫描都在一个临时 Docker 容器中运行，配有隔离的工作区，并为每次调用进行编排。

文档

使用这些指南获取操作层面的详细信息：

安全性、范围与限制

Shannon 不是被动扫描器。它的漏洞利用智能体可以创建用户、提交表单、变更应用状态、触发对外请求，并以其他方式影响目标系统。请使用带一次性数据的沙箱、预发布（staging）或本地开发环境。

你有责任合法且合乎道德地使用 Shannon。不要将 Shannon 指向你不拥有或未获明确授权测试的系统、仓库或应用。

重要限制：

• Shannon 开源版专注于主动可利用的问题，如注入、XSS、SSRF、认证失效和授权失效。更广泛的静态分析覆盖（包括易受攻击的依赖和不安全的配置）通过 Keygraph 平台提供。
• 发现结果仍需要人工复核。LLM 生成的报告可能包含证据不足或错误的细节。
• Shannon 官方支持 Claude 模型。较小、替代性或经代理的非 Claude 模型可能不完整或不稳定。
• 一次完整运行大约需要 1 到 1.5 小时，并可能产生 LLM API 费用，具体取决于模型定价和应用复杂度。
• 不要扫描不受信任或对抗性的代码库。读取源代码的 AI 工具可能面临提示注入（prompt injection）的风险。

在全新环境中运行 Shannon 之前，请阅读完整的安全性与限制指南。

许可证

Shannon 开源版采用 GNU Affero General Public License v3.0 许可。

对于需要不同许可条款、商业支持、私有再分发、托管服务使用或更广泛部署选项（包括 Keygraph 平台）的组织，可提供商业和企业许可。

商业许可请联系 [email protected]。

关于 Keygraph

Keygraph 是 Shannon 背后的公司。它还打造了 Keygraph 平台——这一商业智能体化渗透测试产品闭环了完整的 AppSec 生命周期，并以增强版 Shannon 作为其渗透测试引擎。

社区与支持

社区在线答疑时间（Community office hours） 提供针对 bug、部署和配置问题的实操帮助。

• 美国/欧洲：周四上午 10:00（太平洋时间）
• 亚洲：周四下午 2:00（印度标准时间）
• 预约时段

加入 Discord 提问、分享反馈，并与其他 Shannon 用户交流。

目前，Keygraph 不接受外部代码贡献。欢迎提交 issue 进行 bug 报告和功能请求：

• 报告 Bug
• 建议新功能

保持联系：

• Keygraph 网站
• Twitter/X：@KeygraphHQ
• LinkedIn：Keygraph

由 Keygraph 打造