smuggler
Auth/lab ref: HTTP/1.1 request smuggling and desync detection tool testing CL.TE, TE.CL, and TE.TE variants.
v2026.11.13-21cd5684 installs+4 in 7 days39 StarsMITsynced 10 hours ago
Install
No NotHoly CLI yet? Install it first.
$ curl -fsSL https://notholy.com/install.sh | sh$ notholy skills install aeondave/smugglerWrites to ~/.notholy/skills after checking the signature and the SHA-256.
SignatureSigned, ed25519
Packageda73a48c…062a44d4
da73a48ca159…6e92062a44d41 file · 1.8 KBScanLow1 finding
- Links to outside domains
Sourcegithub.com/AeonDave/malskill/tree/main/offensive-tools/web/smuggler@21cd568
On this page
HTTP request smuggling / desync detection — CL.TE, TE.CL, TE.TE variants.
Quick Start
git clone https://github.com/defparam/smuggler
cd smuggler && pip3 install -r requirements.txt
# Single target
python3 smuggler.py -u https://target.com/endpoint
# Pipe a list of URLs
cat urls.txt | python3 smuggler.py
# Quiet mode (only show findings)
python3 smuggler.py -u https://target.com -q
# Exit on first finding per host
python3 smuggler.py -u https://target.com -xCore Flags
| Flag | Purpose |
|---|---|
-u, --url <url> |
Target URL with endpoint |
-v, --vhost <host> |
Override Host header (virtual host) |
-x, --exit_early |
Exit on first finding (useful in bulk mode) |
-m, --method <verb> |
HTTP method (default: POST) |
-l, --log <file> |
Write output to file + stdout |
-q, --quiet |
Suppress non-finding output |
-t, --timeout <s> |
Socket timeout (default: 5) |
--no-color |
Suppress color codes (for piping/logs) |
-c, --configfile <file> |
Custom payload config file |
Vulnerability Types Detected
| Type | Frontend | Backend | Description |
|---|---|---|---|
| CL.TE | Content-Length | Transfer-Encoding | Frontend routes by CL; backend parses chunked TE |
| TE.CL | Transfer-Encoding | Content-Length | Frontend routes chunked; backend expects CL |
| TE.TE | Transfer-Encoding | Transfer-Encoding | Both parse TE but one can be obfuscated |
How It Works
smuggler sends mutations of CL/TE headers to detect desync behavior via:
- Timing attacks — a smuggled keep-alive request causes the connection to hang
- Differential responses — subsequent request returns part of the smuggled request
Each mutation is sent with precise socket-level control (no HTTP libraries that auto-normalize headers).
Bulk Scan
# Using subfinder + httpx to build target list, then smuggle-test
subfinder -d target.com | httpx -silent | python3 smuggler.py -q -x
# From existing URL list
cat endpoints.txt | python3 smuggler.py -l smuggler-results.txt -qManual Verification with Repeater
After smuggler reports a potential issue, confirm manually in Burp Repeater:
# CL.TE probe — send with Connection: keep-alive
POST / HTTP/1.1
Host: target.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 6
Transfer-Encoding: chunked
0
XIf response is delayed or error changes between requests → real desync.
Common Exploitation Scenarios
# 1. Bypass front-end access controls
# Smuggle a request to a restricted path hidden in the body
# 2. Capture other users' requests
# Poison backend socket to prepend attacker-controlled prefix to next user's request
# 3. Cache poisoning
# Smuggle a request that causes malicious response to be cached for next user
# 4. Web cache deception
# Smuggle static-looking path to cache authenticated responseImportant Note
smuggler can produce false positives on large CDN/proxy providers (Google, AWS, Akamai). Always manually verify before reporting or exploiting. Use -q -x in bulk scans to minimize noise.
References
Files in this version
- SKILL.md3.6 KB
Permissions
| Permission | Declared | Found by the scan |
|---|---|---|
| Reads files | Yes | Yes |
| Writes files | No | No |
| Runs shell commands | Yes | Yes |
| Uses the network | Yes | Yes |
| Uses connectors | No | No |
| Drives a browser | No | No |
Scan findings
Reviewed on Nov 13, 2026
- InfoLink · Links to outside domains
A clean scan lowers the risk but does not prove a package is safe. Read what you install.
| Version | Published | Commit | SHA-256 | Signature | Permission change |
|---|---|---|---|---|---|
| v2026.11.13-21cd568 | Nov 13, 2026 | 21cd568 | da73a48c | Signed | – |
More from AeonDave
All from this publisherMore in Web and bug bounty
See the categoryAsk anything your scope allows.
Create an account, add credits and ask the first question in the chat or the terminal.
- 1/3
Create the account
Individual or company. You can switch to a company later without losing balance or keys.
IndividualCompany - 2/3
Add credits
By card. Pay per token, no subscription.
$5.00minimum deposit - 3/3
Ask
In the chat, or install the CLI and run notholy login in your terminal.
$ notholy login