GoFlood

(Deprecated Project)

Network stress testing tool written in go. distributed architecture with a controller, lightweight agents, and an optional relay proxy.

been working on this for a lil bit, figured i'd clean it up and release it properly.

<table> <tr> <td><img src="https://github.com/user-attachments/assets/0eb04d6b-4623-4e1c-b7b3-2191c05475c0" width="100%"/></td> <td><img src="https://github.com/user-attachments/assets/92e01376-965f-4802-9aba-f9c5e4621ce9" width="100%"/></td> <td><img src="https://github.com/user-attachments/assets/f5e29468-fdec-4887-94c1-97b33a5ae498" width="100%"/></td> <td><img src="https://github.com/user-attachments/assets/50ab64c5-103f-4d73-bc06-b18c85e61283" width="100%"/></td> </tr> <tr> <td><img src="https://github.com/user-attachments/assets/807fad11-4cb1-4a13-909b-368c2892349b" width="100%"/></td> <td><img src="https://github.com/user-attachments/assets/5c02f075-fcb7-469b-b0c9-fc5724203f4e" width="100%"/></td> <td><img src="https://github.com/user-attachments/assets/52cdac50-7650-40fa-882e-2a524e562d6e" width="100%"/></td> <td><img src="https://github.com/user-attachments/assets/807fad11-4cb1-4a13-909b-368c2892349b" width="100%"/></td> </tr> </table>

whats in here

server/     controller - web dashboard, cli, manages all the agents
agent/      connects back to the server, runs the actual tasks
relay/      tls proxy that sits in front (optional, has its own dashboard)
scripts/    cert generation + build scripts

setup

easiest way:

chmod +x scripts/setup.sh
./scripts/setup.sh

or manually:

1. gen your TLS certs (the setup script does this for you)
2. cp server/config.example.json server/config.json and edit it
3. build + run:

cd server && go build -o goflood . && ./goflood
cd agent && go build -o agent . && ./agent
cd relay && go build -o relay . && ./relay   # optional

server

• web ui on 443 (https), cli on 7001, agents connect on 7002
• role system: Owner > Admin > Pro > Basic
• rate limiting per-ip and per-user
• session management, audit log, the usual

agent

• auto-reconnect with backoff
• challenge-response auth (hmac)
• reports system info (cpu, ram, arch)
• cross-compiled to linux/windows/darwin (arm, mips, x86, x64)

relay

• tls 1.3 proxy, sits between agents and server
• has its own web dashboard with live traffic graphs
• jwt auth, csrf, websocket stats

building agents for multiple platforms

cd agent
chmod +x ../scripts/build_agent.sh
../scripts/build_agent.sh

builds for linux (x86, arm, mips), windows, and macos. uses upx if available.

requirements

• go 1.21+
• openssl (cert gen)
• linux/macos recommended, works on windows too

license

MIT