Home

Awesome

Filebuster

An extremely fast and flexible web fuzzer

What is it?

Filebuster is a HTTP fuzzer / content discovery script with loads of features and built to be easy to use and fast! It uses one of the fastest HTTP classes in the world (of PERL) - Furl::HTTP. Also the thread modelling is optimized to run as fast as possible.

Features

It packs a ton of features like:

Filebuster is updated often. New features will be added regularly.

Running the Perl script

Perl version 5.10 or higher is required

FileBuster resources a lot of features to third party libraries. However they can be easily installed with the following command:

cpan -T install YAML Furl Benchmark Net::DNS::Lite List::MoreUtils IO::Socket::SSL URI::Escape HTML::Entities IO::Socket::Socks::Wrapper URI::URL Cache::LRU IO::Async::Timer::Periodic IO::Async::Loop

The -T option will make the installation much quicker but if you run into problems, remove it to allow CPAN to perform the tests per package.

Installation

Filebuster is a Perl script so no installation is necessary. However, the best way of using Filebuster is by creating a soft link on a directory that is included in the path. For example:

ln -s /path/to/filebuster.pl /usr/local/bin/filebuster

Then you will be able to use it system wide

Packaged Binary

Because installing all the dependencies is sometimes not possible, I'm providing a pre-packed binary with all the dependencies built in. It works even on slim Linux distributions. This was achieved by using Perl Packer pp. I've integrated this step in the repo so the packaged version will be automatically built when a new version is released. You can download the latest version from the Releases section.

If you want to pack it yourself, check out the Action's workflow steps and you will find there all the commands you need to run.

Syntax

On the most basic form, Filebuster can be run just using the following syntax:

filebuster -u http://yoursite/ 

If you want to fuzz the final part of the URL, then you don't need to using the tag {fuzz} to indicate where to inject.

The wordlist parameter (-w) is not mandatory as from version 0.9.1. If not specified, Filebuster will attempt to find and load the "Fast" wordlist automatically.

Most common arguments

For the complete syntax help with examples, just run filebuster --help.

A more complex example:

filebuster -u http://yoursite/{fuzz}.jsp -w /path/to/wordlist.txt -t 3 -x http://127.0.0.1:8080 --hs "Error"

This would allow you to fuzz a website with 3 threads to find JSP pages, using a local proxy and hiding all responses with "Error" in the body.

Running in docker

You'll need to start by building the container:

docker build -t filebuster .

Afterwards, you can run it like this:

docker run -ti --init --rm filebuster -u http://yoursite/

If you need to use custom wordlists, remember to map the file, e.g.:

docker run -ti --init --rm -v /path/to/wordlist.txt:/filebuster/mywordlist.txt filebuster -u http://yoursite/ -w /filebuster/mywordlist.txt

You can create an alias in your shell, and make it (almost) seamless:

alias filebuster="docker run -ti --init --rm filebuster"

You can now just run it:

filebuster -u http://yoursite/

Wordlists

I've created some wordlists based on different sources around the web together with my own custom payloads that I've came across during my pentests and research. You can find them on the wordlists directory. If you need more wordlists, you should check out the great SecLists repository.

Contribute

If you have any issues or suggestions feel free to get in touch.