Eine leichtgewichtige, mehrschichtige Linux-Sandbox, die Namensräume, pivot_root, seccomp-bpf, Capability-Dropping und eine evidenzbasierte Bewertungsengine (Truthimatics Public Version) für sichere, nachvollziehbare Codeausführung kombiniert.
Mehrschichtige Sandbox für die Ausführung nativen Codes unter Linux.
Sieben geordnete Isolationsschichten — keine externen Abhängigkeiten, ~81 KiB PIE-Binary.
┌──────────────────────────────────────────────────────┐
│ Z-Jail │
├──────────────────────────────────────────────────────┤
│ rlimits (CPU, AS, NOFILE, NPROC caps) │
│ Namespaces (mount, pid, net, ipc, uts) │
│ pivot_root (chroot on steroids) │
│ NO_NEW_PRIVS (no privilege escalation) │
│ Capabilities (drop all, lock securebits) │
│ seccomp-BPF (whitelist-v1: 24 syscalls) │
│ Audit (JSON logging + BLAKE2b hashing) │
└──────────────────────────────────────────────────────┘
git clone https://github.com/Division-36/Z-Jail.git
cd Z-Jail
make
sudo ./z_jail --root=/path/to/rootfs --seccomp-enforce -- /bin/ls
Das --root-Verzeichnis sollte ein minimales Dateisystem mit dem Ziel-Binary und seinen Abhängigkeiten enthalten (für statische Binaries reicht das Binary allein aus).
Bestehende Sandboxing-Lösungen gehen Kompromisse ein:
| Z-Jail | Firecracker | gVisor | bwrap | nsjail | |
|---|---|---|---|---|---|
| Externe Abhängigkeiten | keine | libc, seccomp | Go-Runtime | libc | libc, protobuf |
| Binärgröße | ~81 KiB | 20+ MiB | 40+ MiB | ~70 KiB | ~1 MiB |
| VM-Isolation | nein | ja (microVM) | nein (Sandbox) | nein | nein |
| seccomp-Whitelist | ja | nein | ja | optional | ja |
| Content-Hashing | ja | nein | nein | nein | nein |
| Audit-JSON | ja | nein | ja | nein | teilweise |
| Build-Komplexität | ein make | komplex | komplex | trivial | moderat |
Z-Jail füllt die Nische zwischen bwrap (minimal, standardmäßig kein seccomp) und nsjail (funktionsreich, schwere Abhängigkeiten). Es ist für CI-Pipelines, CTF-Jail-Challenges und leichtgewichtige Code-Evaluierung konzipiert, wo du Defence-in-Depth benötigst, ohne eine Container-Runtime einzubinden.
flowchart LR
CLI[CLI args] --> P[parse_args]
P --> C{clone namespaces}
C -->|child| CR[child_run]
C -->|parent| W[waitpid]
CR --> RL[setrlimit]
RL --> FD[close fds >= 3]
FD --> DUMP[PR_SET_DUMPABLE=0]
DUMP --> PV[pivot_root]
PV --> NNP[PR_SET_NO_NEW_PRIVS]
NNP --> CAP[drop capabilities]
CAP --> SC[seccomp-BPF]
SC --> SIG[signal parent]
SIG --> EX[execve target]
W --> A[audit JSON]
A --> EXIT[exit]
Jede Schicht ist so angeordnet, dass eine spätere Schicht nicht durch eine frühere rückgängig gemacht werden kann:
capset-Eskalation nach diesem PunktsequenceDiagram
participant P as Parent
participant C as Child
P->>C: clone (NEWNS|NEWPID|NEWNET|NEWIPC|NEWUTS)
Note over C: setrlimit(CPU, AS, NOFILE, NPROC)
Note over C: close(all fds > 2)
Note over C: PR_SET_DUMPABLE=0
Note over C: pivot_root → chdir("/") → umount -l
Note over C: PR_SET_NO_NEW_PRIVS
Note over C: capset(all zero) + securebits
Note over C: seccomp(SECCOMP_MODE_FILTER, whitelist)
C->>P: write(pipe, ready=1)
Note over C: execve(target)
P->>P: waitpid
P->>P: write audit JSON
Z-Jail wendet sieben geordnete Isolationsmechanismen im Kindprozess vor execve an,
jeder so gewählt, dass ein späterer Schritt nicht durch erneutes Ausführen eines früheren rückgängig gemacht werden kann.
Der Elternprozess erzeugt den Kindprozess mit clone() und fordert fünf Namespaces an
(Mount, PID, Netzwerk, IPC, UTS), anschließend führt der Kindprozess die folgende Pipeline aus:
setrlimit begrenzt CPU-Zeit, Adressraum, offene Dateien und Prozessanzahl,
bevor jeglicher vom Gast beeinflusster Code läuft, und beschränkt Fork-Bomben und Speichererschöpfung.
Alle geerbten Deskriptoren außer der Report-Pipe zum Elternprozess werden geschlossen,
wodurch verhindert wird, dass geleakte Handles execve überqueren.
PR_SET_DUMPABLE=0 deaktiviert Core Dumps und beschränkt den Zugriff auf /proc/self/mem.
pivot_rootDas Root des Mount-Namespace wird durch das übergebene Root-Verzeichnis ersetzt:
Das Verzeichnis wird auf sich selbst bind-gemountet, pivot_root tauscht den Mount-Baum,
der Prozess führt chdir zum neuen Root aus, und das alte Root wird lazy abgehängt
und entfernt. Dies ist strikt stärker als chroot(2), da das vorherige
Root ausgehängt und nicht bloß verborgen wird.
NO_NEW_PRIVSPR_SET_NO_NEW_PRIVS verhindert jeden nachfolgenden Privilegiengewinn durch setuid-
Binaries, Datei-Capabilities oder LSM-Übergänge. Unumkehrbar.
Benutzer- und Gruppen-IDs werden geändert, während CAP_SETUID noch gehalten wird, wonach
capset alle Capability-Sets auf null setzt und die Securebits gesperrt werden, sodass
Capabilities nicht wieder aktiviert werden können.
Ein Whitelist-Filter wird installiert; nicht auf der Whitelist stehende Aufrufe werden beendet. Allow-List von 24 Syscalls: