Лёгкая многоуровневая Linux-песочница, объединяющая namespaces, pivot_root, seccomp-bpf, сброс capabilities и основанный на доказательствах механизм вынесения вердикта (Truthimatics Public Version) для безопасного и аудируемого выполнения кода.
Многоуровневая песочница для выполнения нативного кода в Linux.
Семь упорядоченных уровней изоляции — без внешних зависимостей, PIE-бинарник размером ~81 КиБ.
┌──────────────────────────────────────────────────────┐
│ 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
Каталог --root должен содержать минимальную файловую систему с целевым бинарным файлом и его зависимостями (для статических бинарных файлов достаточно самого бинарного файла).
Существующие решения для песочниц идут на компромиссы:
| Z-Jail | Firecracker | gVisor | bwrap | nsjail | |
|---|---|---|---|---|---|
| Внешние зависимости | отсутствуют | libc, seccomp | Go runtime | libc | libc, protobuf |
| Размер бинарного файла | ~81 KiB | 20+ MiB | 40+ MiB | ~70 KiB | ~1 MiB |
| Изоляция виртуальной машины | нет | да (microVM) | нет (песочница) | нет | нет |
| Белый список seccomp | да | нет | да | опционально | да |
| Хеширование содержимого | да | нет | нет | нет | нет |
| Аудит JSON | да | нет | да | нет | частично |
| Сложность сборки | один make | сложная | сложная | тривиальная | умеренная |
Z-Jail заполняет нишу между bwrap (минимальный, без seccomp по умолчанию) и nsjail (многофункциональный, с тяжёлыми зависимостями). Он предназначен для CI-конвейеров, CTF-задач с песочницей и лёгкой оценки кода, где нужна эшелонированная защита без привлечения контейнерной среды выполнения.
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]
Каждый слой упорядочен так, чтобы более поздний слой не мог быть отменён более ранним:
capset после этой точкиsequenceDiagram
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 применяет семь упорядоченных механизмов изоляции в дочернем процессе перед execve,
каждый из которых выбран так, чтобы последующий шаг нельзя было отменить повторным выполнением предыдущего.
Родительский процесс создаёт дочерний с помощью clone(), запрашивая пять пространств имён
(mount, PID, network, IPC, UTS), после чего дочерний процесс выполняет следующий конвейер:
setrlimit ограничивает процессорное время, адресное пространство, открытые файлы и количество процессов
до запуска любого кода, на который может повлиять гость, ограничивая fork-бомбы и исчерпание памяти.
Все унаследованные дескрипторы, кроме канала отчёта родителю, закрываются,
предотвращая утечку дескрипторов через execve.
PR_SET_DUMPABLE=0 отключает дампы ядра и ограничивает доступ к /proc/self/mem.
pivot_rootКорень пространства имён монтирования заменяется на предоставленный корневой каталог:
каталог bind-монтируется на самого себя, pivot_root меняет дерево монтирования,
процесс выполняет chdir в новый корень, а старый корень лениво отсоединяется
и удаляется. Это строго сильнее, чем chroot(2), поскольку предыдущий
корень размонтируется, а не просто скрывается.
NO_NEW_PRIVSPR_SET_NO_NEW_PRIVS предотвращает любое последующее повышение привилегий через setuid
бинарники, файловые capabilities или переходы LSM. Необратимо.
Идентификаторы пользователя и группы изменяются, пока CAP_SETUID ещё удерживается, после чего
capset обнуляет все наборы capabilities и securebits блокируются, так что
capabilities невозможно повторно включить.
Устанавливается фильтр белого списка; вызовы, не входящие в белый список, завершаются. Белый список из 24 системных вызовов: