CI:suite · goldens · perf-check — 基线 281.9ms / 19 个页面(tests/perf/baseline.json)— .github/workflows/ci.yml
一个安全测试引擎。所有接口。
一个开放的、本地优先的安全测试平台,面向渗透测试人员、 AI 智能体、CI/CD 流水线和团队。
传统安全工具是围绕单个测试人员使用桌面界面而设计的。
pwnproxy 围绕一个共享的安全测试引擎构建,可通过终端、TUI、REST API、WebSocket 流、CI/CD 流水线或通过 MCP 的 AI 智能体进行控制。
┌─────────────────────┐
│ pwnproxy core │
│ │
│ Proxy · Scanners │
│ Repeater · Intruder │
│ Sessions · Plugins │
└──────────┬──────────┘
│
┌───────────┬───────────┼───────────┬───────────┐
▼ ▼ ▼ ▼ ▼
CLI TUI REST API WebSocket MCP
│ │ │ │ │
Pentesters Pentesters Automation Teams AI Agents
无论你是手动拦截流量、运行自动化扫描、将安全检查集成到 CI/CD,还是让 AI 代理访问你的测试工作流,使用的都是同一套核心。
代理、扫描器、存储和自动化均运行在你自己的基础设施上。
核心测试工作流无需依赖云端。
CLI、TUI、REST API、WebSocket 流和 MCP 服务器都是同一底层系统的接口。
你无需为手动测试和自动化分别使用不同的工具。
直接从命令行运行扫描,使用 JSON 或 SARIF 输出,并将发现结果集成到 CI/CD 流水线中。
pwnproxy 通过原生 MCP 服务器暴露其能力,使兼容的 AI 代理能够与人类操作员使用相同的测试引擎进行交互。
扫描器和钩子采用插件架构,专为内置和第三方扩展而设计。
git clone https://github.com/ericmtzmtz/pwnproxy.git
cd pwnproxy
poetry install
需要 Python 3.12 或更高版本。
poetry run pwnproxy start --proxy-port 8080 --api-port 8000
127.0.0.1:8080127.0.0.1:8000http://127.0.0.1:8000/docscurl -x http://127.0.0.1:8080 http://httpbin.org/get
poetry run pwnproxy history
poetry run pwnproxy scan url https://example.com \
--scanners sqli,xss \
--output sarif \
--output-file report.sarif
退出码:
| 代码 | 含义 |
|---|---|
| 0 | 扫描完成,未发现漏洞 |
| 1 | 扫描完成,发现漏洞 |
| 2 | 错误 |
pwnproxy 目前通过 Poetry 从源码安装(0.1.0 预发布版;CHANGELOG.md 中为 0.2.0-dev)。PyPI 打包计划在未来版本中提供。
配置位于 ~/.pwnproxy/config.toml —— 有关 [triage] / [llm] / max_llm_per_scan 及范围设置,请参见 config.example.toml。核心测试(代理、扫描器、存储)无需 LLM API 密钥即可运行;triage 默认基于启发式规则运行。
暂停、检查、修改并恢复 HTTP/HTTPS 流量。
内置扫描器目前包括:
| 扫描器 | 检测能力 |
|---|---|
| SQLi | 基于错误(签名 + 带阴性对照/反 WAF 防护的静默 5xx)、布尔盲注(多轮 + 基线)、基于时间、OOB |
| XSS | 反射型/存储型,具备上下文感知的可利用性判断(反射 ≠ XSS);静态 DOM sink 信号(dom-xss,推断) |
| LFI | 内容签名、路径遍历及 PHP 包装器 |
| XXE | 基于错误、XInclude、JSON 变异及 OOB 工作流 |
| SSRF | 仅 OOB/回调确认(失败即关闭;不做推测性基于错误的 SSRF) |
漏洞发现使用三个置信级别 —— tentative(暂定)、inferred(推断)和 confirmed(确认)—— 因此弱信号不会被当作漏洞利用。LLM triage 为可选启用;默认情况下流水线保持基于启发式规则,且绝不会将 tentative 发现发送给 LLM 评判器。
扫描器消费捕获的流量,也可在无头模式下直接执行。
独立于代理重放和修改原始 HTTP 请求。
漏洞发现会保留请求数据,以便手动验证检测到的问题。
使用 Burp 风格的 §标记§ 位置进行请求模糊测试。
支持的模式包括:
基于字典的路径和文件发现,支持:
自动提取并存储:
会话相互隔离并在本地持久化。
使用自定义扫描器和钩子扩展 pwnproxy。
插件可以:
内置扫描器和第三方扫描器使用相同的插件接口。
看门狗会跟踪插件故障,并可自动禁用反复失败的插件。
直接从终端运行 pwnproxy。
pwnproxy start
pwnproxy history
pwnproxy findings
pwnproxy scan url https://example.com
pwnproxy plugin list
pwnproxy session list
使用交互式终端界面进行以下操作:
以编程方式控制平台。
curl http://127.0.0.1:8000/api/v1/flows
该 API 提供以下功能:
交互式 API 文档可在以下地址获取:
http://127.0.0.1:8000/docs
消费流量、发现项、爬虫活动及其他工作流的实时事件。
示例流:
/ws/traffic/ws/findings/ws/events这允许外部接口和自动化系统实时响应测试活动。
pwnproxy 包含一个原生 MCP 服务器,可将测试平台暴露给兼容 MCP 的代理。
Claude / Copilot / Custom Agent
│
▼
┌──────────────┐
│ MCP Server │
└──────┬───────┘
│
▼
┌──────────────┐
│ pwnproxy API │
└──────┬───────┘
│
┌─────────┼─────────┐
▼ ▼ ▼
Traffic Findings Scanners
│ │ │
└─────────┼─────────┘
▼
Security workflow
启动 pwnproxy:
pwnproxy start
然后配置你的 MCP 兼容代理:
{
"mcpServers": {
"pwnproxy": {
"command": "python",
"args": [
"-m",
"apps.mcp.src.pwnproxy_mcp.server"
]
}
}
}
MCP 服务器充当 pwnproxy 平台之上的轻量集成层。
参见:
docs/mcp.md
了解针对 agent 的配置和工具文档。
pwnproxy
┌───────────────┐
│ Proxy Layer │
│ mitmproxy │
└───────┬───────┘
│
▼
┌─────────────────┐
│ HookBus │
│ async events │
└────────┬────────┘
│
┌──────────────────┼──────────────────┐
▼ ▼ ▼
Scanners Sessions Plugins
│ │ │
└──────────────────┼──────────────────┘
│
▼
┌─────────────────┐
│ Storage Layer │
│ SQLite / async │
└────────┬────────┘
│
▼
┌──────────────────────────────────────┐
│ Control Plane │
│ │
│ FastAPI · REST · WebSocket · Events │
└──────────────────┬───────────────────┘
│
┌──────────┬────────┼────────┬──────────┐
▼ ▼ ▼ ▼ ▼
CLI TUI REST WS MCP
pwnproxy 的设计使核心测试工作流独立于用于控制它的界面。
pwnproxy 不是 Burp Suite 的克隆。
Burp Suite 仍然是基于 GUI 的手动测试的优秀工具。
pwnproxy 专注于不同的架构:
| Burp Suite | pwnproxy | |
|---|---|---|
| 主要模型 | 桌面应用程序 | 共享测试引擎 |
| 手动测试 | GUI | TUI + API 接口 |
| 自动化 | 扩展 / 集成 | CLI + REST + SARIF |
| AI 代理 | 外部集成 | 原生 MCP 服务器 |
| 插件 | Java 生态系统 | 基于 Python 的插件 |
| 无头工作流 | 有限 | 原生 |
| CI/CD | 外部工具 | 内置输出和退出码 |
| 本地部署 | 是 | 是 |
pwnproxy 还可以导入 Burp 范围配置。
pwnproxy import burp --config burp-config.json
参见:
docs/burp-migration.md
了解迁移详情。
在不启动代理的情况下运行扫描:
pwnproxy scan url https://example.com \
--output sarif \
--output-file report.sarif
示例 GitHub Actions 工作流:
- name: Install pwnproxy
run: |
git clone https://github.com/ericmtzmtz/pwnproxy.git
cd pwnproxy
pip install poetry
poetry install