ffuf
Auth/lab ref: High-speed HTTP fuzzing engine for endpoint discovery and input mutation on web/API targets.
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/ffufWrites to ~/.notholy/skills after checking the signature and the SHA-256.
SignatureSigned, ed25519
Packageebd15517…e6a58622
ebd155170734…7a93e6a586222 files · 4.4 KBScanMedium3 findings
- Link to a raw IP addressSKILL.md:157
- Link to a raw IP addressreferences/filters.md:191
- Links to outside domains
Sourcegithub.com/AeonDave/malskill/tree/main/offensive-tools/fuzzing/ffuf@21cd568
On this page
Go-based web fuzzer — FUZZ keyword can be placed anywhere in a request (URL, headers, body, hostname).
Use ffuf when you need fast, iterative fuzz campaigns and deterministic filtering; use crawlers (hakrawler, etc.) only for passive discovery.
Quick Start
# Directory fuzzing
ffuf -u http://example.com/FUZZ -w /usr/share/wordlists/dirb/common.txt
# With file extension
ffuf -u http://example.com/FUZZ -w common.txt -e .php,.html,.txt
# Subdomain/vhost fuzzing
ffuf -u http://FUZZ.example.com -w subdomains.txt -H "Host: FUZZ.example.com"Core Flags
| Flag | Description |
|---|---|
-u <url> |
Target URL (use FUZZ as placeholder) |
-w <wordlist> |
Wordlist path (:KEYWORD for named payloads) |
-e <ext> |
Append extensions to each word |
-t <n> |
Threads (default 40) |
-rate <n> |
Max requests per second |
-H <header> |
Custom header |
-X <method> |
HTTP method (default GET) |
-d <data> |
POST data body |
-b <cookies> |
Cookie string |
-r |
Follow redirects |
-k |
Skip TLS verification |
-x <proxy> |
Proxy URL |
-o <file> |
Output file |
-of <format> |
Output format: json, html, csv, md, all |
-timeout <n> |
HTTP timeout in seconds |
-ignore-body |
Skip response body download when only status/size matters |
-noninteractive |
Disable interactive console mode for scripts and agents |
-v |
Verbose (show redirects) |
-s |
Silent mode |
-p <delay> |
Delay between requests (e.g., 0.1 or 0.1-0.5) |
-recursion |
Enable recursive fuzzing |
-recursion-depth <n> |
Max recursion depth |
-recursion-strategy default|greedy |
Strategy for recursion |
-ac |
Auto-calibrate filter (detect and filter noise) |
-ach |
Auto-calibrate per host |
-maxtime <n> |
Max run time in seconds |
-ic |
Ignore wordlist comments |
-c |
Colorize output |
Stateful pre/postflight (v2.3.0+)
Use repeatable raw-request files to establish or clean up session state around fuzz requests. -preflight-var NAME:regex binds to the preceding -preflight; the first capture group is substituted literally wherever NAME appears in the main request (URL, headers, body) and later flight requests. Postflight variables can use values captured earlier.
ffuf -u https://authorized.example/api/FUZZ -w items.txt -H 'X-CSRF: TOKEN' \
-preflight login.req -preflight-var 'TOKEN:csrf=([[:alnum:]]+)' \
-postflight logout.req -preflight-mode per-request -preflight-error abort-preflight/-postflight files contain raw HTTP requests and are repeatable, in order. -preflight-mode per-request (default) refreshes state for every fuzz request; per-thread amortizes the chain once per worker lane, so use it only when that reuse is valid. -preflight-error abort (default) stops on preflight errors; ignore continues with variables gathered so far. Postflight runs only after a successful main request; its errors are logged and do not discard that result. These flags were added in ffuf v2.3.0; check ffuf -h for the installed version.
Filtering & Matching
| Flag | Description |
|---|---|
-mc <codes> |
Match HTTP status codes (default 200,204,301,302,307,401,403,405) |
-ml <n> |
Match by response lines |
-mw <n> |
Match by word count |
-ms <size> |
Match by response size |
-mr <regex> |
Match by regex in body |
-fc <codes> |
Filter (exclude) status codes |
-fl <n> |
Filter by lines |
-fw <n> |
Filter by words |
-fs <n> |
Filter by size |
-fr <regex> |
Filter by regex |
Multiple FUZZ Positions
# Two wordlists: W1 + W2
ffuf -u http://target.com/W1/W2 -w list1.txt:W1 -w list2.txt:W2
# Cluster bomb (all combinations)
ffuf -u http://target.com/W1?param=W2 -w list1.txt:W1 -w list2.txt:W2 -mode clusterbomb
# Pitchfork (paired positions)
ffuf -u http://target.com/W1?user=W2 -w paths.txt:W1 -w users.txt:W2 -mode pitchforkCommon Workflows
# Standard dir fuzz with auto-calibration (best noise filter)
ffuf -u https://target.com/FUZZ -w raft-medium.txt -ac -o dirs.json -of json
# POST login brute-force
ffuf -u https://target.com/login -X POST -d "user=admin&pass=FUZZ" -w passwords.txt -fc 401
# Parameter discovery (GET)
ffuf -u "https://target.com/page?FUZZ=test" -w params.txt -fw 42
# Vhost discovery
ffuf -u http://target.com -H "Host: FUZZ.target.com" -w vhosts.txt -fw 42
# API endpoint fuzzing with auth
ffuf -u https://api.target.com/v1/FUZZ -w api-words.txt -H "Authorization: Bearer TOKEN" -mc 200,201,204
# Recursive dir fuzz
ffuf -u https://target.com/FUZZ -w common.txt -recursion -recursion-depth 3 -ac
# Header fuzzing (find supported methods/auth headers)
ffuf -u https://target.com/api/resource -w methods.txt -X FUZZ -mc 200,201,405
# JSON POST body fuzzing
ffuf -u https://api.target.com/v1/users -X POST \
-H "Content-Type: application/json" \
-d '{"username":"FUZZ","password":"test"}' \
-w usernames.txt -mc 200Operator Playbook (Recommended)
- Start with
-ac,-noninteractive, and explicit output (-o <file> -of json) to reduce baseline noise and keep automation deterministic. - Lock stable match/filter logic (
-mc+ one of-fs/-fw/-fl) before deep recursion. - Run endpoint discovery first, then parameter/header/body fuzzing on confirmed routes.
- Only then enable recursion (
-recursion) to avoid exploding false positives. - In agent or CI runs, always include
-noninteractive; if ffuf drops into interactive mode, stop it and rerun with this flag.
Fast baseline profile
ffuf -u https://target/FUZZ -w raft-medium-words.txt -ac -fc 404 -t 40 -rate 100 -timeout 10 -noninteractive -o ffuf-baseline.json -of jsonParameter-name fuzzing profile
ffuf -u "https://target/api/resource?FUZZ=1" -w params.txt -ac -mc all -fs 0Replay to proxy for manual confirmation
ffuf -u https://target/FUZZ -w words.txt -ac -replay-proxy http://127.0.0.1:8080Resources
| File | When to load |
|---|---|
references/filters.md |
All filter/matcher flags, noise reduction strategies, multi-FUZZ patterns |
Files in this version
references/15.1 KB
- filters.md5.1 KB
- SKILL.md6.3 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
- MediumLink · Link to a raw IP addressSKILL.md:157
- MediumLink · Link to a raw IP addressreferences/filters.md:191
- 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 | ebd15517 | 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