        ● Notice //GitHub (@shehzade) is temporarily suspended pending an automated false-positive review. All tools are hosted on this Code Mirror and available on request (contact); GitHub links will return once reinstated.
      

Multi-protocol network egress assessment and DLP verification framework featuring automated L4 sweeps, corporate proxy traversal, and covert protocol smuggling across 20+ channels.

$ git clone https://shehzade.io/repos/contraband.git Copy

Source ZIP (1.93 MB)

Code 174 Commits 1

← Back to directory

2.1 KB

Raw

Installation and Build Reference

Contraband requires Go 1.22+ and compiles cleanly with CGO_ENABLED=0 across Linux, macOS, and Windows.

1. Quick Build (Host Binary)

To build the unified contraband binary and dedicated standalone binaries for the local host architecture:

BASH

git clone https://github.com/shehzade/contraband.git
cd contraband
make build

This compiles:

bin/contraband: Unified multi-tool binary containing all subcommands (client, server, sweep, listen, soak, report).
bin/contraband-client: Dedicated client binary stripped for lightweight deployment.
bin/contraband-server: Dedicated server binary for reflection and live dashboard services.

2. Cross-Compilation Matrix

To generate statically linked binaries for all target architectures:

BASH

make build-all

Output File	Target OS	Architecture	Notes
`contraband-linux-amd64`	Linux	x86_64 / AMD64	Static ELF, eBPF redirector capable
`contraband-linux-arm64`	Linux	AArch64 / ARM64	AWS Graviton, Raspberry Pi
`contraband-darwin-amd64`	macOS	Intel x86_64	Native POSIX socket engine
`contraband-darwin-arm64`	macOS	Apple Silicon (M1/M2/M3)	Native macOS arm64
`contraband-windows-amd64.exe`	Windows	x86_64	Native Win32 / SChannel proxy support
`contraband-windows-arm64.exe`	Windows	ARM64	Surface Pro / WoA native

3. Direct Go Build Commands

If you do not have make installed:

BASH

# Unified binary
CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/contraband ./cmd/contraband

# Standalone Client
CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/contraband-client ./cmd/contraband-client

# Standalone Server
CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/contraband-server ./cmd/contraband-server

4. Verification

Verify build purity and version:

BASH

./bin/contraband version
file ./bin/contraband-client

Output should confirm statically linked execution without external .so or .dll runtime dependencies.

1	# Installation and Build Reference
2
3	Contraband requires Go 1.22+ and compiles cleanly with `CGO_ENABLED=0` across Linux, macOS, and Windows.
4
5	---
6
7	## 1. Quick Build (Host Binary)
8
9	To build the unified `contraband` binary and dedicated standalone binaries for the local host architecture:
10
11	```bash
12	git clone https://github.com/shehzade/contraband.git
13	cd contraband
14	make build
15	```
16
17	This compiles:
18	- `bin/contraband`: Unified multi-tool binary containing all subcommands (`client`, `server`, `sweep`, `listen`, `soak`, `report`).
19	- `bin/contraband-client`: Dedicated client binary stripped for lightweight deployment.
20	- `bin/contraband-server`: Dedicated server binary for reflection and live dashboard services.
21
22	---
23
24	## 2. Cross-Compilation Matrix
25
26	To generate statically linked binaries for all target architectures:
27
28	```bash
29	make build-all
30	```
31
32	\| Output File \| Target OS \| Architecture \| Notes \|
33	\| :--- \| :--- \| :--- \| :--- \|
34	\| `contraband-linux-amd64` \| Linux \| x86_64 / AMD64 \| Static ELF, eBPF redirector capable \|
35	\| `contraband-linux-arm64` \| Linux \| AArch64 / ARM64 \| AWS Graviton, Raspberry Pi \|
36	\| `contraband-darwin-amd64` \| macOS \| Intel x86_64 \| Native POSIX socket engine \|
37	\| `contraband-darwin-arm64` \| macOS \| Apple Silicon (M1/M2/M3) \| Native macOS arm64 \|
38	\| `contraband-windows-amd64.exe` \| Windows \| x86_64 \| Native Win32 / SChannel proxy support \|
39	\| `contraband-windows-arm64.exe` \| Windows \| ARM64 \| Surface Pro / WoA native \|
40
41	---
42
43	## 3. Direct Go Build Commands
44
45	If you do not have `make` installed:
46
47	```bash
48	# Unified binary
49	CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/contraband ./cmd/contraband
50
51	# Standalone Client
52	CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/contraband-client ./cmd/contraband-client
53
54	# Standalone Server
55	CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/contraband-server ./cmd/contraband-server
56	```
57
58	---
59
60	## 4. Verification
61
62	Verify build purity and version:
63
64	```bash
65	./bin/contraband version
66	file ./bin/contraband-client
67	```
68
69	Output should confirm statically linked execution without external `.so` or `.dll` runtime dependencies.

# Installation and Build Reference

Contraband requires Go 1.22+ and compiles cleanly with `CGO_ENABLED=0` across Linux, macOS, and Windows.

---

## 1. Quick Build (Host Binary)

To build the unified `contraband` binary and dedicated standalone binaries for the local host architecture:

```bash
git clone https://github.com/shehzade/contraband.git
cd contraband
make build
```

This compiles:
- `bin/contraband`: Unified multi-tool binary containing all subcommands (`client`, `server`, `sweep`, `listen`, `soak`, `report`).
- `bin/contraband-client`: Dedicated client binary stripped for lightweight deployment.
- `bin/contraband-server`: Dedicated server binary for reflection and live dashboard services.

---

## 2. Cross-Compilation Matrix

To generate statically linked binaries for all target architectures:

```bash
make build-all
```

| Output File | Target OS | Architecture | Notes |
| :--- | :--- | :--- | :--- |
| `contraband-linux-amd64` | Linux | x86_64 / AMD64 | Static ELF, eBPF redirector capable |
| `contraband-linux-arm64` | Linux | AArch64 / ARM64 | AWS Graviton, Raspberry Pi |
| `contraband-darwin-amd64` | macOS | Intel x86_64 | Native POSIX socket engine |
| `contraband-darwin-arm64` | macOS | Apple Silicon (M1/M2/M3) | Native macOS arm64 |
| `contraband-windows-amd64.exe` | Windows | x86_64 | Native Win32 / SChannel proxy support |
| `contraband-windows-arm64.exe` | Windows | ARM64 | Surface Pro / WoA native |

---

## 3. Direct Go Build Commands

If you do not have `make` installed:

```bash
# Unified binary
CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/contraband ./cmd/contraband

# Standalone Client
CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/contraband-client ./cmd/contraband-client

# Standalone Server
CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o bin/contraband-server ./cmd/contraband-server
```

---

## 4. Verification

Verify build purity and version:

```bash
./bin/contraband version
file ./bin/contraband-client
```

Output should confirm statically linked execution without external `.so` or `.dll` runtime dependencies.