ماسح ضوئي لتهريب طلبات HTTP مبني بلغة Rust.

نظرة عامة

Smugglex هي أداة اختبار أمان تكتشف ثغرات تهريب طلبات HTTP (HTTP Request Smuggling) في تطبيقات الويب. تختبر هجمات CL.TE وTE.CL وTE.TE وH2C وH2، وعلى الأهداف التي تعمل بنظام HTTPS — يتحدث بروتوكول HTTP/2 حقيقي (ALPN h2) لاكتشاف تهريب الترقية من HTTP/2 إلى HTTP/1.1 (H2.CL / H2.TE) عبر فحص h2-downgrade.

للحصول على توثيق مفصّل، تفضل بزيارة smugglex.hahwul.com.

التثبيت

Homebrew (macOS وLinux)

brew install hahwul/smugglex/smugglex

البناء من المصدر

يتطلب Rust 1.70 أو أحدث:

git clone https://github.com/hahwul/smugglex
cd smugglex
cargo install --path .

للاطلاع على طرق التثبيت الأخرى، راجع دليل التثبيت.

الاستخدام

فحص أساسي:

smugglex https://target.com

قراءة العناوين من stdin:

cat urls.txt | smugglex

إعادة تشغيل طلب تم التقاطه (مثل المُصدَّر من Burp Suite) كقالب للطلب:

smugglex --raw-request request.txt              # target taken from the Host header
smugglex --raw-request request.txt --raw-request-proto http
smugglex --raw-request request.txt -H "X-Collab: abcd.oastify.com"  # -H is additive

يُرسل هدف الطلب الذي تم التقاطه حرفيًا — مقاطع النقاط ومعاملات المصفوفة و# محفوظة وليست مُوحَّدة — لكل من سطري الطلب بصيغة origin-form (POST /path ...) وبصيغة absolute-form (GET http://...)؛ لذا تبقى الحمولات المعتمدة على المسار سليمة. ويتم دمج أي ترويسات -H فوق الترويسات الملتقطة.

للحصول على تفاصيل الاستخدام والخيارات، راجع دليل الاستخدام.

أمثلة

smugglex https://target.com -v -o results.json
cat urls.txt | smugglex --exit-first

للوكلاء الذكيين والنصوص البرمجية وبيئات CI

تم تصميم smugglex ليكون متوافقًا مع الاستخدام الآلي:

# Clean JSON output (only JSON on stdout) + proper exit code
smugglex --json https://target.com
echo $?   # 0 = clean, 1 = vulnerable found

# Batch + structured output (single valid JSON document)
cat urls.txt | smugglex -f json -o report.json

# Quiet + JSON for pipelines
smugglex -q --json https://target.com | jq '.summary.vulnerable_targets'

رموز الخروج:

0 — لم يتم العثور على ثغرات
1 — تم العثور على ثغرة واحدة على الأقل
2 — خطأ في الاستخدام / الإدخال

راجع دليل خطوط الأنابيب وصيغ الإخراج لمزيد من التفاصيل.

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة والحلول متاحة في دليل استكشاف الأخطاء وإصلاحها.

smugglex

الأكثر شعبية