Http11Probe は HTTP/1.1 サーバー向けのコンプライアンスおよびセキュリティテスターです。生の TCP ソケットを介して不正な形式、曖昧、または過大なリクエストをサーバーに送り、その応答が RFC 9110 と RFC 9112 の実際の要件に照らしてどうなっているかを検査します。対象となるのは、裸の LF 改行、廃止された行折り畳み、CL/TE リクエストスマグリング、チャンクフレーミングのトリック、過大なヘッダー、NUL バイトといった厄介なケースであり、厳格なパーサーと寛容なパーサーの見解が分かれる領域です。
同じ 215 個のテストが、Nginx、Apache、Envoy から Kestrel、Gin、Actix、そして Node、Bun、Deno の組み込みサーバーまで、14 言語で書かれた 47 個のリファレンスサーバーに対して実行されます。すべての結果は仕様の MUST/SHOULD/MAY の文言に照らして採点され、Pass、Fail、または Warn としてマークされます。Warn は、RFC が厳格な動作と寛容な動作の両方を許容している、つまりどちらも間違いではないという意味にすぎません。
完全なドキュメント、RFC の引用付きのテストごとの用語集、そしてすべてのサーバーのライブ結果マトリクスは http-probe.com で確認できます。
このプローブはターゲット非依存です。--host:--port で既にリッスンしている HTTP/1.1 サーバーであれば何でもテストし、フレームワークを選択するフラグはありません。まずサーバーを起動し(または probe-local.sh に起動させ)、そのサーバーにプローブを向けてください。
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080
| フラグ | 説明 | デフォルト |
|---|---|---|
--host | 対象のホスト名または IP アドレス | localhost |
--port | 対象のポート番号 | 8080 |
--category | このカテゴリのテストのみを実行(Compliance、Smuggling、MalformedInput、Normalization、Cookies、Capabilities) | すべて |
--test | 特定のテスト ID のみを実行、大文字小文字を区別しない(繰り返し指定可能) | すべて |
--timeout | テストごとの接続および読み取りタイムアウト(秒) | 5 |
--output | JSON 結果をファイルに書き込む | なし |
--verbose, -v | 各テストの生のサーバーレスポンスを出力する | オフ |
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080 --output results.json
特定のテストを実行します:
dotnet run --project src/Http11Probe.Cli -- --test SMUG-CL-TE-BOTH --test SMUG-DUPLICATE-CL
各テストが完了するたびに結果がコンソールにストリーミングされ、最後にサマリーが表示されます:
Score: 97/97 19 warnings (146 tests, 35.5s)
プローブはリクエストを送信するだけで、サーバーは起動しません。src/Servers/ 配下のバンドルされたサーバーのいずれかをプローブするには、scripts/probe-local.sh を使用します。これは CI パイプラインが行うのと同じ処理を実行します。つまり、サーバーの Docker イメージをビルドし、--network host で実行し、起動するまで待機してからプローブし、その後クリーンアップします。
# 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
--server の値は表示名(Actix)ではなくディレクトリ名(ActixServer)です。Docker デーモンに root 権限が必要な場合は、スクリプト全体を sudo で実行しなくて済むように --docker-sudo を追加してください:
scripts/probe-local.sh --server ActixServer --docker-sudo
| フラグ | 説明 |
|---|---|
--server <Dir> | src/Servers/ 配下のディレクトリ名で単一のサーバーをプローブします(例: NginxServer) |
--all | src/Servers/*/probe.json 配下のすべてのサーバーをプローブします |
--port <Port> | 対象ポート(デフォルト: 8080) |
--skip-build | dotnet build をスキップします(Release ビルドが既に存在することを前提とします) |
--verbose | CLI に --verbose を渡します |
--docker-sudo | sudo 経由で Docker コマンドを実行します(sudo なしでスクリプトを実行できます) |
-h, --help | ヘルプを表示します |
probe-<ServerDir>.json(サーバーごとに1つ)に加え、ローカルレンダリング用に probe-data.js と docs/static/probe/data.js を書き出します。jq、docker、curl、python3、および .NET 10 SDK が必要です。
probe-local.sh は単なる便利なラッパーです。複数回のプローブ実行にわたってサーバーを起動したままにしたい場合など、手動で行いたい場合は、自分でコンテナをビルドして実行し、そのコンテナに対してプローブを実行してください。Docker のビルドコンテキストはリポジトリルートであるため、リポジトリルートから以下を実行してください:
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
既に稼働中の任意の HTTP/1.1 サーバーにプローブを向けることもできます:
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 9000
.NET 10 SDK が必要です。
dotnet build Http11Probe.slnx
Probe ワークフローはプルリクエストと workflow_dispatch で実行されます。各サーバーの Docker イメージをビルドし、プローブを実行して、比較表を PR コメントとして投稿します。