+4
Daily
17,059
stars
1,626
forks
162
watchers
385
prs
555
issues
28
releases
README
!ffuf mascot
ffuf - Fuzz Faster U Fool
A fast web fuzzer written in Go.
- Installation
- Example usage
- Content discovery
- Vhost discovery
- Parameter fuzzing
- POST data fuzzing
- Using external mutator
- Configuration files
- Help
- Interactive mode
Installation
- Download a prebuilt binary from releases page, unpack and run!
_or_
- If you are on Windows with Scoop, ffuf can be installed with: scoop install ffuf
_or_
- If you are on Windows with Winget, ffuf can be installed with: winget install ffuf.ffuf
_or_
- If you are on macOS with homebrew, ffuf can be installed with: brew install ffuf
_or_
- If you have recent go compiler installed: go install github.com/ffuf/ffuf/v2@latest (the same command works for updating)
_or_
- git clone https://github.com/ffuf/ffuf ; cd ffuf ; go get ; go build
1. Ffuf depends on Go 1.20 or greater.
2. A go build from a checkout shows git-- rather than the tag. A local build isn't an official release even when you're sitting on a tag, and Go's embedded build info gives us the commit but not the tag name — so we surface the exact commit it was built from. The authoritative versioned binaries are the ones on the releases page.
Example usage
The usage examples below show just the simplest tasks you can accomplish using ffuf.
More elaborate documentation that goes through many features with a lot of examples is
available in the ffuf wiki at https://github.com/ffuf/ffuf/wiki
For more extensive documentation, with real life usage examples and tips, be sure to check out the awesome guide:
"Everything you need to know about FFUF" by
Michael Skelton (@codingo).
You can also practise your ffuf scans against a live host with different lessons and use cases either locally by using the docker container https://github.com/adamtlangley/ffufme or against the live hosted version at http://ffuf.me created by Adam Langley @adamtlangley.
Typical directory discovery
By using the FUZZ keyword at the end of URL (-u):
ffuf -w /path/to/wordlist -u https://target/FUZZ
Virtual host discovery (without DNS records)
Assuming that the default virtualhost response size is 4242 bytes, we can filter out all the responses of that size (-fs 4242)while fuzzing the Host - header:
ffuf -w /path/to/vhost/wordlist -u https://target -H "Host: FUZZ" -fs 4242
GET parameter fuzzing
GET parameter name fuzzing is very similar to directory discovery, and works by defining the FUZZ keyword as a part of the URL. This also assumes a response size of 4242 bytes for invalid GET parameter name.
ffuf -w /path/to/paramnames.txt -u https://target/script.php?FUZZ=test_value -fs 4242
If the parameter name is known, the values can be fuzzed the same way. This example assumes a wrong parameter value returning HTTP response code 401.
ffuf -w /path/to/values.txt -u https://target/script.php?valid_name=FUZZ -fc 401
POST data fuzzing
This is a very straightforward operation, again bTop issues
#377recursion not working properly21 comments · 2021-01-18#257Multiple and rare feature requests 16 comments · 2020-06-21#790Proxy and Akamai Errors13 comments · 2024-05-30#141Input command usability improvement suggestion13 comments · 2020-01-25#324Follow redirects while printing redirect chains11 comments · 2020-10-02#387Option -ac is hiding valid results because of the way how auto-calibrated filters are applied.10 comments · 2021-02-07#681Output format9 comments · 2023-05-17#526ffuf fails to match / filter encoded content due Accept-Encoding header8 comments · 2022-03-01
Latest release
v2.3.0 v2.3.0 2026-09-09Changelog 256c1b02499f5f8672af965d4ad7a321d606bc65 Changelog: add v2.3.0, and backfill the v2.2.0 and v2.2.1 sections 90e28bd42efc4ee1f4e4645fc6920212ccd1ea2c Bound the -od/-audit-log response snapshot and the response header size (934) 33c67d28c85b94589d029b3bcaff205a40cee9c4 Count response words/lines without allocating a []string (930) 8162f48742ff140cafd0d8eb4f071714befccef5 Add preflight/postflight requests with variable extraction (920) e43b4a239564e229d7469a957a8574bf25cc0fac Drop redundant security contact link from issue config (919) a614addba3bf9327b115302dea1f5ac47a65c82a Add