Skip to content
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
aeondave/smugglerWeb and bug bounty

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/smuggler

Writes to ⁦~/.notholy/skills⁩ after checking the signature and the SHA-256.

SignatureSigned, ed25519
BXhYzT6cSU…YIOBfyBA==The CLI checks the SHA-256 and the signature before it writes a file.
Packageda73a48c…062a44d4
da73a48ca159…6e92062a44d41 file · ⁦1.8 KB⁩
ScanLow1 finding
  • Links to outside domains
See the full scan
Sourcegithub.com/AeonDave/malskill/tree/main/offensive-tools/web/smuggler@21cd568

HTTP request smuggling / desync detection — CL.TE, TE.CL, TE.TE variants.

Quick Start

bash
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 -x

Core 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:

  1. Timing attacks — a smuggled keep-alive request causes the connection to hang
  2. 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

bash
# 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 -q

Manual Verification with Repeater

After smuggler reports a potential issue, confirm manually in Burp Repeater:

http
# 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

X

If response is delayed or error changes between requests → real desync.

Common Exploitation Scenarios

text
# 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 response

Important 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

Permissions

PermissionDeclaredFound by the scan
Reads filesYesYes
Writes filesNoNo
Runs shell commandsYesYes
Uses the networkYesYes
Uses connectorsNoNo
Drives a browserNoNo

Scan findings

Reviewed on Nov 13, 2026

  1. InfoLink · Links to outside domains

A clean scan lowers the risk but does not prove a package is safe. Read what you install.

VersionPublishedCommitSHA-256SignaturePermission change
v2026.11.13-21cd568Nov 13, 202621cd568da73a48cSigned–

Ask anything your scope allows.

Create an account, add credits and ask the first question in the chat or the terminal.

  1. 1/3

    Create the account

    Individual or company. You can switch to a company later without losing balance or keys.

    IndividualCompany
  2. 2/3

    Add credits

    By card. Pay per token, no subscription.

    $5.00minimum deposit
  3. 3/3

    Ask

    In the chat, or install the CLI and run notholy login in your terminal.

    $ notholy login