Exploration is a modular Command and Control framework for red team operations.
This repository contains:
- C++ TeamServer
- Python Client
- Release packaging for Windows assets from C2Implant
- Release packaging for Linux assets from C2LinuxImplant
The TeamServer manages listeners and sessions. The Python Client talks to the TeamServer through gRPC.
Supported listener channels:
TCPSMBHTTPHTTPS
protocol/ .proto source and generated gRPC build rules
teamServer/ TeamServer runtime and gRPC implementation
C2Client/ Python client package and UI
core/ shared C++ components
packaging/ release bundle assembly and validation
integration/ runtime staging and integration tests
docs/ build, release, CI/CD, and integration notes
Download the latest release:
wget -q $(wget -q -O - 'https://api.github.com/repos/maxDcb/C2TeamServer/releases/latest' | jq -r '.assets[] | select(.name=="Release.tar.gz").browser_download_url') -O ./C2TeamServer.tar.gz
mkdir C2TeamServer
tar xf C2TeamServer.tar.gz -C C2TeamServer --strip-components 1Start the TeamServer:
cd C2TeamServer/TeamServer
./TeamServerInstall and run the client:
cd C2TeamServer/Client
python -m venv .venv
. .venv/bin/activate
pip install .
export C2_CERT_PATH="$PWD/../TeamServer/server.crt"
c2client --ip 127.0.0.1 --port 50051docker build -t exploration-teamserver .
docker run --rm -it \
--name exploration-teamserver \
-p 50051:50051 \
-p 80:80 \
-p 443:443 \
-p 8443:8443 \
exploration-teamserverUse a local release bundle:
docker run --rm -it \
-v "$PWD/Release:/opt/teamserver/Release:ro" \
-p 50051:50051 \
exploration-teamserver- Part 0: Setup and basic usage
- Part 1: TeamServer and architecture
- Part 2: GUI and operator workflows
- Part 3: Beacons and listeners
- Part 4: Modules