faucet

A simple and lightweight HTTP server, written in C++.


About


If you're reading this, you're either viewing the public example page, or have setup faucet correctly.

faucet is a pretty basic HTTP server for Linux (no Windows support yet), written in c++. It features basic functionality such as:

Directory Listing


faucet has built-in directory listing support, with beautiful styling.
Click the link below to see it in action.

Go to /files Dir listing example

404 custom page


Custom 404 page support? No way...
faucet allows you to specify your own 404 page in the .env file, instead of the default error page.
Click the link below to see it in action.

Go to a non-existent page 404 example

Ratelimits


Hold your horses!
Faucet has a .env option for enabling and configuring requests per second ratelimiting.

There's no link to try this out, just click the refresh button as fast as you can.

Ratelimit example

Trust Score


faucet has a toggleable trust score system, which gives each request an trust score,
assigns that to the IP address (uses the lowest score from past 3 minutes from the IP),
and blocks requests which are under the set threshold.

Want to get blocked? Try setting your user-agent to "curl",
go to honeypot paths like /wp-login.php,
and just spam requests.

Trust score example

I'm a teapot?


WHAT!!! There's no possible way faucet is a teapot! Or is it?

This totally does not lead to a teapot