feroxbuster Documentation
repository·main·Indexed 27 days ago
https://github.com/epi052/feroxbusterA fast, simple, recursive content discovery tool written in Rust, designed for forced browsing attacks to enumerate unlinked resources on web applications. Version 2.13.1 supports custom HTTP headers, proxying through Burp or SOCKS, and automatic 404 response pattern detection. It includes heuristics for detecting directory listings (Apache, TomCat, Python, ASP.NET) and provides flexible installation options for Kali Linux, MacOS, and Windows.
What's inside feroxbuster
- Feroxbuster can be installed on Windows using several methods: downloading the ZIP from GitHub releases, using Winget, or using Chocolatey.
Install feroxbuster on Linux and MacOS
mainYou can install feroxbuster using the provided installation script. You can choose to install it to a specific directory or the current working directory.Install feroxbuster on Kali Linux
mainOn Kali Linux, the preferred installation method is via the official repositories. This adds a
ferox-config.tomlfile in/etc/feroxbuster/, enables command completion for bash, fish, and zsh, and includes a man page entry.sudo apt update && sudo apt install -y feroxbusterInstall feroxbuster on MacOS via Homebrew
mainUse Homebrew to install feroxbuster on MacOS.
brew install feroxbusterUpdate feroxbuster
mainTo update feroxbuster to the latest version, use the built-in
--updateflag../feroxbuster --updateAutomatic 404 response pattern detection
mainFeroxbuster can automatically detect and filter out 404-like (or other non-target) responses by analyzing patterns in non-existent URLs.
How it works:
- It sends multiple requests to non-existent paths (using unique UUID-based strings) across different methods and extensions.
- It examines the responses for similarities in status code, content length, word count, and line count.
- If a consistent pattern is found, it creates a
WildcardFilterto exclude these responses from future scan results. - It may also create a
SimilarityFilteras a fallback.
Note: This feature is bypassed if the
--dont-filterconfiguration is enabled.Configure wordlist sources
mainFeroxbuster can load wordlists from local files or remote URLs.
- Local Wordlist: Provide a path to a file. If the primary wordlist is not found, the tool attempts to use a
SECONDARY_WORDLISTif it exists. - Remote Wordlist: If the wordlist path starts with
http, feroxbuster will attempt to download the wordlist to a file named after the last segment of the URL before scanning.
Note: Leading forward-slashes in wordlist entries (e.g.,
/word) are automatically trimmed to ensure correct URL construction (e.g.,http://target.com/wordinstead ofhttp://target.com//word).- Local Wordlist: Provide a path to a file. If the primary wordlist is not found, the tool attempts to use a
Use scope-aware redirects in ClientConfig
mainWhenredirectsis set totrueinClientConfig, the client uses a custom redirect policy. If thescopefield is populated with a list ofUrls, the client will only follow redirects if the target URL is within that scope (checked viais_in_scope). Ifscopeis empty, it falls back to a default limit of 10 redirects.Set a time limit for scans
mainThe
--time-limitoption allows you to restrict how long a scan runs.In standard mode, a dedicated thread is spawned to enforce this limit. In
--parallelmode, the time limit is enforced within each individual child process to ensure each sub-scan respects the constraint.Resume a previous scan
mainUsing the
--resume-fromflag allows feroxbuster to pick up where a previous scan left off. The tool will:- Populate the
FeroxScansobject with previously seen scans from the provided file. - Load existing statistics to maintain progress bar accuracy.
- Display known responses and completed bars for the resumed targets.
- Populate the
Cancel active scans by ID
mainYou can cancel specific active scans using the
corcancelcommand. You can specify individual IDs, ranges, or comma-separated lists.- Single ID:
c 3 - Range:
c 1-4 - List:
c 1,3,5 - Mixed:
c 1-4,8,9-13 - Force Cancel: Append
-fto bypass confirmation for specific IDs (e.g.,c -f 3).
- Single ID:
Update feroxbuster via CLI
mainFeroxbuster includes a built-in mechanism to check for and install updates. If theupdate_applogic is triggered (typically via a specific flag or internal check), it will attempt to update the binary from the GitHub repository.