
Eine offene Testplattform, die HTTP/1.1-Server auf RFC 9110/9112-Anforderungen, Smuggling Vectors und die Verarbeitung fehlerhafter Eingaben überprüft. Fügen Sie Ihr Framework hinzu und erhalten Sie automatisch Compliance-Ergebnisse.
Http11Probe ist ein Konformitäts- und Sicherheitstester für HTTP/1.1-Server. Er sendet fehlerhafte, mehrdeutige und überdimensionierte Anfragen über rohe TCP-Sockets an einen Server und prüft, wie dieser darauf antwortet, gemessen an dem, was RFC 9110 und RFC 9112 tatsächlich verlangen. Dabei handelt es sich um die heiklen Fälle wie reine LF-Zeilenenden, veraltete Zeilenfaltung, CL/TE-Request-Smuggling, Chunk-Framing-Tricks, überdimensionierte Header und NUL-Bytes, bei denen ein strikter Parser und ein nachsichtiger Parser beginnen, sich zu widersprechen.
Dieselben 215 Tests laufen gegen 47 Referenzserver, die in 14 Sprachen geschrieben sind, von Nginx, Apache und Envoy bis hin zu Kestrel, Gin, Actix und den eingebauten Servern in Node, Bun und Deno. Jedes Ergebnis wird anhand der MUST/SHOULD/MAY-Formulierungen in der Spezifikation bewertet und mit Pass, Fail oder Warn gekennzeichnet. Ein Warn bedeutet lediglich, dass die RFC sowohl das strikte als auch das nachsichtige Verhalten erlaubt, sodass keines von beiden falsch ist.
Die vollständige Dokumentation, ein Glossar pro Test mit RFC-Zitaten und die Live-Ergebnismatrix für jeden Server finden Sie unter http-probe.com.
Die Probe ist zielagnostisch. Sie testet jeden HTTP/1.1-Server, der bereits auf --host:--port lauscht, und es gibt kein Flag zur Auswahl eines Frameworks. Starten Sie zuerst den Server (oder lassen Sie probe-local.sh einen für Sie hochfahren) und richten Sie dann die Probe darauf aus.
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080
| Flag | Beschreibung | Standard |
|---|---|---|
--host | Ziel-Hostname oder IP-Adresse | localhost |
--port | Ziel-Portnummer | 8080 |
--category | Nur Tests in dieser Kategorie ausführen (Compliance, Smuggling, MalformedInput, Normalization, Cookies, Capabilities) | alle |
--test | Nur bestimmte Test-IDs ausführen, Groß-/Kleinschreibung wird nicht unterschieden (wiederholbar) | alle |
--timeout | Verbindungs- und Lese-Timeout in Sekunden pro Test | 5 |
--output | JSON-Ergebnisse in Datei schreiben | keine |
--verbose, -v | Die rohe Serverantwort für jeden Test ausgeben | aus |
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080 --output results.json
Führe spezifische Tests aus:
dotnet run --project src/Http11Probe.Cli -- --test SMUG-CL-TE-BOTH --test SMUG-DUPLICATE-CL
Ergebnisse werden während der Ausführung jedes Tests an die Konsole gestreamt, mit einer Zusammenfassung am Ende:
Score: 97/97 19 warnings (146 tests, 35.5s)
Der Probe sendet nur Anfragen, er startet keine Server. Um einen der gebündelten Server unter src/Servers/ zu testen, verwenden Sie scripts/probe-local.sh. Es macht dasselbe wie die CI-Pipeline: das Docker-Image des Servers bauen, es mit --network host ausführen, warten, bis es hochgefahren ist, es testen und dann wieder abbauen.
# Probe one server by its directory name under src/Servers/, e.g. ActixServer
scripts/probe-local.sh --server ActixServer
# Probe every bundled server
scripts/probe-local.sh --all
Der --server-Wert ist der Verzeichnisname (ActixServer), nicht der Anzeigename (Actix). Wenn Ihr Docker-Daemon Root-Rechte benötigt, fügen Sie --docker-sudo hinzu, damit Sie nicht das gesamte Skript mit sudo ausführen müssen:
scripts/probe-local.sh --server ActixServer --docker-sudo
| Flag | Beschreibung |
|---|---|
--server <Dir> | Prüft einen einzelnen Server anhand seines Verzeichnisnamens unter src/Servers/ (z. B. NginxServer) |
--all | Prüft jeden Server unter src/Servers/*/probe.json |
--port <Port> | Zielport (Standard: 8080) |
--skip-build | Überspringt dotnet build (setzt voraus, dass bereits ein Release-Build existiert) |
--verbose | Übergibt --verbose an die CLI |
--docker-sudo | Führt Docker-Befehle über sudo aus (ermöglicht das Ausführen des Skripts ohne sudo) |
-h, --help | Zeigt die Hilfe an |
Es schreibt probe-<ServerDir>.json (eine pro Server) sowie probe-data.js und docs/static/probe/data.js für die lokale Darstellung. Du benötigst jq, docker, curl, python3 und das .NET 10 SDK.
probe-local.sh ist nur ein Komfort-Wrapper. Wenn du es lieber von Hand machen möchtest, etwa um einen Server über mehrere Probe-Läufe hinweg aktiv zu halten, baue und starte den Container selbst und richte dann die Probe darauf aus. Führe diese Befehle vom Repo-Stammverzeichnis aus aus, da dies der Docker-Build-Kontext ist:
docker build -t probe-actix -f src/Servers/ActixServer/Dockerfile .
docker run -d --name probe-target --network host probe-actix
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080
docker rm -f probe-target
Sie können die Sonde auch auf jeden bereits laufenden HTTP/1.1-Server richten:
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 9000
Erfordert das .NET 10 SDK.
dotnet build Http11Probe.slnx
Der Probe-Workflow läuft bei Pull Requests und workflow_dispatch. Er baut das Docker-Image jedes Servers, prüft es und veröffentlicht eine Vergleichstabelle als PR-Kommentar.