1
4
mirror of https://github.com/yunginnanet/HellPot synced 2024-07-01 02:00:48 +00:00
HellPot/README.md
2017-08-27 14:53:21 -04:00

32 lines
1.6 KiB
Markdown

# Heffalump [![GoDoc](https://godoc.org/github.com/carlmjohnson/heffalump?status.svg)](https://godoc.org/github.com/carlmjohnson/heffalump) [![Go Report Card](https://goreportcard.com/badge/github.com/carlmjohnson/heffalump)](https://goreportcard.com/report/github.com/carlmjohnson/heffalump)
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](http://www.gutenberg.org/files/27771/27771-h/27771-h.htm), one of A. A. Milne's most beloved and most public domain works.
![Exploding Heffalump](exploding-heffalump.gif)
Live example: <a href="https://heffalump.herokuapp.com" rel="nofollow">Do not follow this link.</a> It will flood your browser's memory and likely cause a crash.
## Installation
First install [Go](http://golang.org).
If you just want to install the binary to your current directory and don't care about the source code, run
```shell
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 "/")
```