ericmtzmtz/pwnproxyEine offene, lokal-first Sicherheitstest-Plattform für Pentester, KI-Agenten, CI/CD-Pipelines und Teams.
CI: suite · goldens · perf-check — Baseline 281.9ms / 19 Seiten (tests/perf/baseline.json) — .github/workflows/ci.yml
Eine Security-Testing-Engine. Jede Schnittstelle.
Eine offene, lokal-first Security-Testing-Plattform für Pentester, KI-Agenten, CI/CD-Pipelines und Teams.
Traditionelle Security-Tools wurden für einen einzelnen Tester mit einer Desktop-Oberfläche entwickelt.
pwnproxy basiert auf einer gemeinsamen Security-Testing-Engine, die über ein Terminal, eine TUI, eine REST-API, WebSocket-Streams, CI/CD-Pipelines oder KI-Agenten über MCP gesteuert werden kann.
┌─────────────────────┐
│ pwnproxy core │
│ │
│ Proxy · Scanners │
│ Repeater · Intruder │
│ Sessions · Plugins │
└──────────┬──────────┘
│
┌───────────┬───────────┼───────────┬───────────┐
▼ ▼ ▼ ▼ ▼
CLI TUI REST API WebSocket MCP
│ │ │ │ │
Pentesters Pentesters Automation Teams AI Agents
Derselbe Kern wird verwendet, egal ob Sie den Datenverkehr manuell abfangen, einen automatisierten Scan ausführen, Sicherheitsprüfungen in CI/CD integrieren oder einem KI-Agenten Zugriff auf Ihren Test-Workflow geben.
Der Proxy, die Scanner, die Speicherung und die Automatisierung laufen auf Ihrer Infrastruktur.
Für den zentralen Test-Workflow ist keine Cloud-Abhängigkeit erforderlich.
Die CLI, TUI, REST-API, WebSocket-Streams und der MCP-Server sind Schnittstellen zu demselben zugrunde liegenden System.
Sie benötigen keine separaten Tools für manuelles Testen und Automatisierung.
Führen Sie Scans direkt über die Befehlszeile aus, nutzen Sie JSON- oder SARIF-Ausgaben und integrieren Sie Funde in CI/CD-Pipelines.
pwnproxy stellt seine Funktionen über einen nativen MCP-Server bereit, sodass kompatible KI-Agenten mit derselben Test-Engine interagieren können, die auch menschliche Bediener verwenden.
Scanner und Hooks verwenden eine Plugin-Architektur, die für integrierte und Drittanbieter-Erweiterungen konzipiert ist.
git clone https://github.com/ericmtzmtz/pwnproxy.git
cd pwnproxy
poetry install
Python 3.12 oder höher ist erforderlich.
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
Exit-Codes:
| Code | Bedeutung |
|---|---|
| 0 | Scan abgeschlossen, keine Funde |
| 1 | Scan abgeschlossen, Funde vorhanden |
| 2 | Fehler |
pwnproxy wird derzeit aus dem Quellcode mit Poetry installiert (0.1.0 Pre-Release; 0.2.0-dev in CHANGELOG.md). Eine PyPI-Paketierung ist für eine zukünftige Version geplant.
Die Konfiguration befindet sich in ~/.pwnproxy/config.toml — siehe config.example.toml für [triage] / [llm] / max_llm_per_scan und Scope-Einstellungen. Das Kern-Testing (Proxy, Scanner, Speicherung) funktioniert ohne LLM-API-Schlüssel; Triage läuft standardmäßig auf Basis von Heuristiken.
HTTP/HTTPS-Traffic pausieren, inspizieren, modifizieren und fortsetzen.
Zu den integrierten Scannern gehören derzeit:
| Scanner | Erkennung |
|---|---|
| SQLi | Fehlerbasiert (Signaturen + gedämpfte 5xx mit Negativkontrollen / Anti-WAF-Guards), Boolean-Blind (mehrere Runden + Baseline), zeitbasiert, OOB |
| XSS | Reflektiert/Gespeichert mit kontextbewusster Ausnutzbarkeit (Reflexion ≠ XSS); statische DOM-Sink-Signale (dom-xss, abgeleitet) |
| LFI | Inhaltssignaturen, Traversal und PHP-Wrapper |
| XXE | Fehlerbasiert, XInclude, JSON-Mutation und OOB-Workflows |
| SSRF | Nur OOB-/Callback-Bestätigung (fail-closed; kein spekulatives fehlerbasiertes SSRF) |
Funde verwenden drei Konfidenzstufen — tentative, inferred und confirmed —, sodass schwache Signale nicht als Exploits behandelt werden. LLM-Triage ist optional; standardmäßig bleibt die Pipeline bei Heuristiken und sendet niemals tentative-Funde an den LLM-Judge.
Scanner verarbeiten erfasste Flows und können auch direkt im Headless-Modus ausgeführt werden.
Rohe HTTP-Requests unabhängig vom Proxy erneut abspielen und modifizieren.
Funde bewahren die Request-Daten auf, sodass erkannte Probleme manuell validiert werden können.
Request-Fuzzing mit Burp-artigen §marker§-Positionen.
Zu den unterstützten Modi gehören:
Wordlist-basierte Pfad- und Dateierkennung mit:
Automatisches Extrahieren und Speichern von:
Sitzungen sind isoliert und werden lokal persistiert.
pwnproxy mit benutzerdefinierten Scannern und Hooks erweitern.
Plugins können:
Dieselbe Plugin-Schnittstelle wird für integrierte und Drittanbieter-Scanner verwendet.
Ein Watchdog verfolgt Plugin-Fehler und kann wiederholt fehlschlagende Plugins automatisch deaktivieren.
pwnproxy direkt vom Terminal aus ausführen.
pwnproxy start
pwnproxy history
pwnproxy findings
pwnproxy scan url https://example.com
pwnproxy plugin list
pwnproxy session list
Verwende eine interaktive Terminal-Oberfläche für:
Steuere die Plattform programmatisch.
curl http://127.0.0.1:8000/api/v1/flows
Die API stellt Funktionalität bereit für:
Interaktive API-Dokumentation ist verfügbar unter:
http://127.0.0.1:8000/docs
Konsumieren Sie Echtzeit-Ereignisse für Traffic, Findings, Crawler-Aktivität und andere Workflows.
Beispiel-Streams: