yunginnanet
/
HellPot
mirror of https://github.com/yunginnanet/HellPot.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
HellPot is a portal to endless suffering meant to punish unruly HTTP bots.
12 Commits 4 Branches 15 Tags 12 MiB
Go 99.9%
Makefile 0.1%
Go to file
Carl Johnson cfeee439d2 Add documentation 2016-12-11 19:15:14 -05:00
heff Add documentation 2016-12-11 19:15:14 -05:00
.gitignore Initial commit 2016-12-09 14:44:49 -05:00
LICENSE Initial commit 2016-12-09 14:44:49 -05:00
README.md README: Fix usage 2016-12-11 18:45:05 -05:00
exploding-heffalump.gif GIF: Loop explosion 2016-12-11 18:55:30 -05:00
heffalump.go CLI: Use options flag, not positional args 2016-12-11 18:24:55 -05:00

README.md

Heffalump GoDoc Go Report Card

Heffalump is an endless honeypot that gives malicious bots nightmares. To use, in your robots.txt tell robots not to go to a certain URL, which heffalump is reverse proxying. Any web agent that does go to the URL will receive an endless stream of random data, which will overflow its memory and/or storage if it doesn't have a max buffer size set or at the very least severely waste its time.

The source of the honeypot data is Once On a Time, one of A. A. Milne's most beloved and most public domain works.

Exploding Heffalump

Installation

First install Go.

If you just want to install the binary to your current directory and don't care about the source code, run

GOBIN=$(pwd) GOPATH=$(mktemp -d) go get github.com/carlmjohnson/heffalump

Usage

Usage of heffalump:

heffalump [opts]

    heffalump serves an endless HTTP honeypot

  -addr string
        Address to serve (default "127.0.0.1:8080")
  -path string
        Path to serve from. Path ending in / serves sub-paths. (default "/")