cookiengineer/gobayashi

:construction: Experimental eBPF sandbox tool to analyze and modify malware samples dynamically

2

stars

4

commits

Go

primary language

Jul 27, 2026

updated

README

gobayashi

eBPF-based Linux malware dynamic analysis sandbox. Intercepts system calls, network connections, and DNS requests — allows the analyst to make real-time decisions (allow / block / spoof).

Quick Start

# One-time setup (after every reboot)
sudo ./scripts/setup.sh

# Build
make build

Running Tests

# Unit tests (no root needed, always runs)
make test

# BPF integration tests (requires root after setup.sh)
make test-integration

# Full podman-based test suite (unit + vet + BPF + E2E)
./scripts/podman-test.sh

Manual Daemon + Client

# Terminal 1: start the daemon
sudo ./bin/gobayashid --foreground --verbose

# Terminal 2: analyze a sample
./bin/gobayashi analyze ./samples/bin/fs_probe

# Or ping the daemon
./bin/gobayashi ping

Makefile Targets

CommandWhat it does
make buildCompiles gobayashid + gobayashi
make testUnit tests (~50 tests, ~3s)
make test-bpfBPF kernel tests (needs root)
make test-e2eMalware sample tests (needs root)
make test-allBoth unit + BPF kernel tests
make vetStatic analysis
make samplesBuild C malware samples
make cleanRemove build artifacts
make clean-bpfUnload leftover BPF programs/maps (needs root)

License

AGPL-3.0

Contributors

cookiengineer

4 commits

cookiengineer/gobayashi

:construction: Experimental eBPF sandbox tool to analyze and modify malware samples dynamically

2

stars

4

commits

Go

primary language

Jul 27, 2026

updated

README

gobayashi

eBPF-based Linux malware dynamic analysis sandbox. Intercepts system calls, network connections, and DNS requests — allows the analyst to make real-time decisions (allow / block / spoof).

Quick Start

# One-time setup (after every reboot)
sudo ./scripts/setup.sh

# Build
make build

Running Tests

# Unit tests (no root needed, always runs)
make test

# BPF integration tests (requires root after setup.sh)
make test-integration

# Full podman-based test suite (unit + vet + BPF + E2E)
./scripts/podman-test.sh

Manual Daemon + Client

# Terminal 1: start the daemon
sudo ./bin/gobayashid --foreground --verbose

# Terminal 2: analyze a sample
./bin/gobayashi analyze ./samples/bin/fs_probe

# Or ping the daemon
./bin/gobayashi ping

Makefile Targets

CommandWhat it does
make buildCompiles gobayashid + gobayashi
make testUnit tests (~50 tests, ~3s)
make test-bpfBPF kernel tests (needs root)
make test-e2eMalware sample tests (needs root)
make test-allBoth unit + BPF kernel tests
make vetStatic analysis
make samplesBuild C malware samples
make cleanRemove build artifacts
make clean-bpfUnload leftover BPF programs/maps (needs root)

License

AGPL-3.0

Contributors

cookiengineer

4 commits

Languages

Go

72.3%

Shell

15.6%

C

10.4%

Makefile

1.4%