네임스페이스, pivot_root, seccomp-bpf, capability 드롭 및 증거 기반 평결 엔진(Truthimatics Public Version)을 결합하여 안전하고 감사 가능한 코드 실행을 제공하는 가볍고 다층적인 Linux 샌드박스입니다.
Linux에서 네이티브 코드 실행을 위한 다중 계층 샌드박스.
7개의 순차적 격리 계층 — 외부 의존성 없음, ~81 KiB PIE 바이너리.
┌──────────────────────────────────────────────────────┐
│ 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 런타임 | libc | libc, protobuf |
| 바이너리 크기 | ~81 KiB | 20+ MiB | 40+ MiB | ~70 KiB | ~1 MiB |
| VM 격리 | 아니오 | 예 (microVM) | 아니오 (샌드박스) | 아니오 | 아니오 |
| seccomp 화이트리스트 | 예 | 아니오 | 예 | 선택 사항 | 예 |
| 콘텐츠 해싱 | 예 | 아니오 | 아니오 | 아니오 | 아니오 |
| 감사 JSON | 예 | 아니오 | 예 | 아니오 | 부분적 |
| 빌드 복잡도 | make 한 번 | 복잡 | 복잡 | 간단 | 보통 |
Z-Jail은 bwrap(최소 기능, 기본적으로 seccomp 없음)과 nsjail(기능 풍부, 무거운 의존성) 사이의 틈새를 채웁니다. 컨테이너 런타임을 끌어들이지 않고도 심층 방어가 필요한 CI 파이프라인, CTF jail 챌린지, 경량 코드 평가를 위해 설계되었습니다.
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 이전에 자식 프로세스에서 일곱 가지의 순차적 격리 메커니즘을 적용하며, 각 단계는 이전 단계를 다시 실행해도 되돌릴 수 없도록 선택되었다.
부모는 다섯 개의 네임스페이스(mount, PID, network, IPC, UTS)를 요청하여 clone()으로 자식을 생성하고, 그런 다음 자식은 다음 파이프라인을 실행한다:
setrlimit은 게스트의 영향을 받는 코드가 실행되기 전에 CPU 시간, 주소 공간, 열린 파일, 프로세스 수를 제한하여 포크 폭탄과 메모리 고갈을 억제한다.
부모 보고 파이프를 제외한 모든 상속된 디스크립터가 닫혀, 유출된 핸들이 execve를 넘어 전달되는 것을 방지한다.
PR_SET_DUMPABLE=0은 코어 덤프를 비활성화하고 /proc/self/mem 접근을 제한한다.
pivot_root마운트 네임스페이스의 루트가 제공된 루트 디렉터리로 교체된다:
디렉터리는 자기 자신에 바인드 마운트되고, pivot_root가 마운트 트리를 교체하며,
프로세스는 새 루트로 chdir하고, 이전 루트는 지연 분리(lazy detach)되어
제거된다. 이는 이전 루트가 단순히 숨겨지는 것이 아니라 마운트 해제되므로 chroot(2)보다 엄격히 더 강력하다.
NO_NEW_PRIVSPR_SET_NO_NEW_PRIVS는 setuid 바이너리, 파일 capability, 또는 LSM 전환을 통한 이후의 모든 권한 획득을 방지한다. 되돌릴 수 없다.
CAP_SETUID를 여전히 보유한 상태에서 사용자 및 그룹 ID가 변경되고, 그 후
capset이 모든 capability 집합을 0으로 만들고 securebits가 잠기므로,
capability를 다시 활성화할 수 없다.
화이트리스트 필터가 설치되며, 화이트리스트에 없는 호출은 종료된다. 24개 시스템 호출의 허용 목록:
| 시스템 호출 | 번호 | 비고 |
|---|---|---|
read | 0 | stdin |
write | 1 | stdout/stderr + 보고 파이프 |
openat | 257 | 파일 접근 (open 아님) |
close | 3 | — |
lseek | 8 | — |
brk | 12 | 힙 관리 |
mmap | 9 | 인자 제한: flags == 0x22 정확히 (MAP_PRIVATE|MAP_ANONYMOUS) 그리고 prot & PROT_EXEC == 0 |
munmap | 11 | — |
execve | 59 | 시작 시 단일 exec |
exit_group | 231 | 정상 프로세스 종료 |
rt_sigaction | 13 | 시그널 핸들러 |
rt_sigprocmask | 14 | 시그널 마스킹 |
getrandom | 318 | 난수 소스 |
clock_gettime | 228 | 타이밍 |
fstat | 5 | 파일 메타데이터 |
arch_prctl | 158 | TLS 설정 |
mprotect | 10 | 인자 제한: prot & PROT_EXEC == 0 (W^X 유지) |
prlimit64 | 302 | 인자 제한: new_limit == NULL 전체 64비트 (하위 + 상위 워드 모두 0; 읽기 전용) |
readlinkat | 267 | — |
rseq | 334 | glibc 재시작 가능 시퀀스 |
set_robust_list | 273 | glibc 스레드 초기화 |
set_tid_address | 218 | glibc 초기화 |
access | 21 | — |
pread64 | 17 | — |
마지막 아홉 개(arch_prctl .. pread64)는 현대의 정적으로 링크된 glibc 프로그램이 main 이전에 필요로 하는 C 런타임 시작 호출이다. BPF 필터는
동적으로 생성된다: 각 화이트리스트 항목에 대해 점프 체인이 생성되어
시스템 호출이 일치하면 허용하거나, 그렇지 않으면 KILL로 넘어간다. 아키텍처는
먼저 확인된다(AUDIT_ARCH_X86_64).
세 가지 인자 수준 규칙이 정책의 의도를 보존한다:
mmap은 flags == MAP_PRIVATE|MAP_ANONYMOUS (0x22) 및 PROT_EXEC 미설정으로 제한mprotect는 PROT_EXEC이 절대 설정되지 않도록 제한 (W^X 강제)prlimit64는 NULL 새 제한 인자로 제한되며, 전체 64비트로 확인됨 (게스트는 읽을 수 있지만 제한을 올릴 수 없음)필터는 독립적으로 독립형 테스트
(tests/seccomp_filter_test.c, 9/9 통과)에 의해 검증되며, 이 테스트는 root 없이 실제 prctl(PR_SET_SECCOMP)에 대해 테스트 케이스를 fork+execve한다.
자식 프로세스가 종료된 후, 부모 프로세스는 버전이 지정된 스키마(z-jail.audit/v1)를 준수하는 JSON 감사 레코드를 출력합니다. 이 레코드에는 실행 시간, 종료 코드, 판정 필드, 활성 seccomp 필터 이름 및 화이트리스트 크기, 활성화된 네임스페이스, 그리고 부모 프로세스가 계산한 대상 바이너리의 BLAKE2b-256 다이제스트인 content_fingerprint가 포함됩니다. 선택적 --self-hash 플래그를 사용하면 운영자가 예상 다이제스트를 고정하여 결과를 신뢰하기 전에 실행 파일의 변조를 감지할 수 있습니다.
build/audits/<binary-name>.audit.json에 기록됩니다. content_fingerprint는 자식 프로세스가 완료된 후 부모 프로세스가 계산한 대상 바이너리의 정규 BLAKE2b-256 해시입니다(b2sum -l 256으로 재현 가능). 레코드는 prev_hash를 통해 해시 체인을 형성하며, 파일은 모든 경로 구성 요소에서 심볼릭 링크를 따르지 않고 열리며 추가 전용(chattr +a)으로 표시되어 제자리에서 잘리거나 덮어쓸 수 없습니다. docs/AUDIT_SCHEMA.md를 참조하세요.
z_jail --root=<dir> [--seccomp-enforce] [--self-hash=<hex>]
[--quiet] [--verbose] -- <program> [args...]