
منصة اختبار مفتوحة تختبر خوادم HTTP/1.1 وفقًا لمتطلبات RFC 9110/9112، ونواقل التهريب، ومعالجة المدخلات غير الصالحة. أضف إطار عملك، واحصل على نتائج التوافق تلقائيًا.
Http11Probe هو أداة اختبار للامتثال والأمان لخوادم HTTP/1.1. تقوم بإرسال طلبات مشوّهة وغامضة ومفرطة الحجم إلى الخادم عبر مآخذ TCP خام وتتحقق من كيفية استجابته مقابل ما تتطلبه RFC 9110 وRFC 9112 فعليًا. هذه هي الحالات الصعبة مثل نهايات الأسطر بـ LF المجردة، وطي الأسطر المهجور، وتهريب الطلبات CL/TE، وحيل تأطير القطع (chunk-framing)، والترويسات المفرطة الحجم، وبايتات NUL، حيث يبدأ المحلل الصارم والمتساهل في الاختلاف.
تُشغَّل الاختبارات الـ 215 نفسها ضد 47 خادمًا مرجعيًا مكتوبًا بـ 14 لغة، من Nginx وApache وEnvoy إلى Kestrel وGin وActix والخوادم المدمجة في Node وBun وDeno. تُقيَّم كل نتيجة مقابل صياغة MUST/SHOULD/MAY في المواصفة وتُصنَّف على أنها Pass أو Fail أو Warn. تعني Warn فقط أن RFC يسمح بكل من السلوك الصارم والمتساهل، لذا لا يُعد أي منهما خاطئًا.
ستجد التوثيق الكامل، ومعجمًا لكل اختبار مع استشهادات RFC، ومصفوفة النتائج الحية لكل خادم على http-probe.com.
الأداة مستقلة عن الهدف. فهي تختبر أي خادم HTTP/1.1 يستمع بالفعل على --host:--port، ولا توجد علامة لاختيار إطار عمل. ابدأ تشغيل الخادم أولًا (أو دع 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 | تشغيل معرّفات اختبارات محددة فقط، دون تمييز بين الأحرف الكبيرة والصغيرة (قابل للتكرار) | الكل |
--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 هي اسم الدليل (ActixServer)، وليس اسم العرض (Actix). إذا كان Docker daemon لديك يحتاج إلى صلاحيات الجذر، فأضف --docker-sudo حتى لا تضطر إلى تشغيل السكربت بأكمله باستخدام 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 | تمرير --verbose إلى واجهة سطر الأوامر (CLI) |
--docker-sudo | تشغيل أوامر Docker عبر sudo (يتيح لك تشغيل السكربت دون sudo) |
-h، --help | عرض المساعدة |
يكتب probe-<ServerDir>.json (واحد لكل خادم)، إضافةً إلى 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 عند طلبات السحب (pull requests) وعند workflow_dispatch. يبني صورة Docker لكل خادم، ويفحصها، وينشر جدول مقارنة كتعليق على طلب السحب (PR).