Building 70 Projects ranging from beginner to advanced so anyone can β learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company π
ββββββββββββββ βββββββ ββββββββ ββββββ βββββββ βββββββ ββββ βββ
ββββββββββββββββ ββββββββββββββββββββββββββββββββββββββββββββββ βββ
βββ βββββββ ββββββββββββββ βββββββββββ βββ βββββββββ βββ
βββ βββββββ ββββββββββββββ βββββββββββ βββ βββββββββββββ
ββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββββββ ββββββ
βββββββββββββββ βββββββ βββββββββββ βββ βββββββ βββββββ βββ βββββ
Command and Control beacon and server with XOR-encoded WebSocket protocol, 10 MITRE ATT&CK mapped commands, and a real-time operator dashboard.
This is a quick overview β security theory, architecture, and full walkthroughs are in the learn modules.
What It Does
- WebSocket-based C2 protocol with XOR + Base64 encoding and shared-key authentication
- 10 beacon commands mapped to MITRE ATT&CK: shell, sysinfo, proclist, upload, download, screenshot, keylog, persist, sleep
- Real-time operator dashboard showing connected beacons with live heartbeat tracking
- Terminal-style session page with command history, tab autocomplete, and inline screenshot rendering
- Per-beacon async task queues with SQLite persistence and full task history
- Exponential backoff reconnection with configurable sleep interval and jitter
Quick Start
docker compose -f dev.compose.yml up -d
Visit http://localhost:47430 to open the operator dashboard.
Run a beacon in a separate terminal:
just beacon
[!TIP] This project uses
justas a command runner. Typejustto see all available commands.Install:
curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin
Stack
Backend: FastAPI, aiosqlite, Pydantic, uvicorn
Frontend: React 19, TypeScript, Vite, Zustand, Zod
Beacon: asyncio, websockets, psutil, pynput, mss
Learn
This project includes step-by-step learning materials covering security theory, architecture, and implementation.
| Module | Topic |
|---|---|
| 00 - Overview | Prerequisites and quick start |
| 01 - Concepts | C2 frameworks, MITRE ATT&CK, and detection |
| 02 - Architecture | Protocol design and data flow |
| 03 - Implementation | Code walkthrough |
| 04 - Challenges | Extension ideas and exercises |
License
AGPL 3.0