अपडेट पर वापस जाएँ
New releaseJul 27, 2026

Z-Jail v1.1.0

एक हल्का, बहु-परत वाला Linux सैंडबॉक्स जो namespaces, pivot_root, seccomp-bpf, capability dropping, और एक साक्ष्य-आधारित निर्णय इंजन (Truthimatics Public Version) को जोड़ता है — सुरक्षित, ऑडिट योग्य कोड निष्पादन के लिए।

साझा करें
Z-Jail

Z-Jail

लिनक्स पर नेटिव कोड निष्पादन के लिए बहु-स्तरीय सैंडबॉक्स।
सात क्रमबद्ध आइसोलेशन परतें — कोई बाहरी निर्भरता नहीं, ~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 क्यों

मौजूदा सैंडबॉक्सिंग समाधान समझौते करते हैं:

Z-JailFirecrackergVisorbwrapnsjail
बाहरी निर्भरताएँशून्यlibc, seccompGo runtimelibclibc, protobuf
बाइनरी आकार~81 KiB20+ MiB40+ MiB~70 KiB~1 MiB
VM आइसोलेशननहींहाँ (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]

लेयर क्रमण

प्रत्येक लेयर को इस प्रकार क्रमबद्ध किया गया है कि बाद की लेयर को पहले की लेयर द्वारा पूर्ववत नहीं किया जा सके:

  1. setrlimit — किसी भी अन्य चीज़ से पहले CPU, एड्रेस स्पेस, फ़ाइल संख्या, प्रोसेस को सीमित करें
  2. fd scrub — रिपोर्ट पाइप को छोड़कर सभी विरासत में मिले fd बंद करें
  3. PR_SET_DUMPABLE=0 — कोर डंप अक्षम, /proc/self/mem लॉक डाउन
  4. pivot_root — होस्ट फ़ाइलसिस्टम से अलग करें; पुरानी रूट को आलसी रूप से अनमाउंट किया गया
  5. PR_SET_NO_NEW_PRIVS — इस बिंदु के बाद कोई setuid नहीं, कोई capset एस्केलेशन नहीं
  6. drop_caps — सभी क्षमताओं को शून्य करें, securebits लॉक करें
  7. seccomp-BPF — सिसकॉल्स को केवल व्हाइटलिस्ट तक सीमित करें
  8. signal parent — पैरेंट को बताएं कि सैंडबॉक्स तैयार है
  9. execve — प्रोसेस को लक्ष्य बाइनरी से बदलें
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), फिर चाइल्ड निम्नलिखित पाइपलाइन चलाता है:

1. संसाधन सीमाएँ

setrlimit किसी भी अतिथि-प्रभावित कोड के चलने से पहले CPU समय, पता स्थान, खुली फ़ाइलों, और प्रक्रिया गणना पर सीमा लगाता है, जिससे fork बम और मेमोरी की कमी सीमित होती है।

2. फ़ाइल-डिस्क्रिप्टर सफ़ाई

पैरेंट रिपोर्ट पाइप को छोड़कर सभी विरासत में मिले डिस्क्रिप्टर बंद कर दिए जाते हैं, जिससे लीक हुए हैंडल execve को पार करने से रोके जाते हैं।

3. डंपेबिलिटी बंद

PR_SET_DUMPABLE=0 कोर डंप को अक्षम करता है और /proc/self/mem पहुँच को प्रतिबंधित करता है।

4. pivot_root

माउंट नेमस्पेस रूट को दिए गए रूट निर्देशिका से बदल दिया जाता है: निर्देशिका को स्वयं पर बाइंड-माउंट किया जाता है, pivot_root माउंट ट्री की अदला-बदली करता है, प्रक्रिया नए रूट पर chdir करती है, और पुराना रूट आलसी रूप से अलग किया जाता है और हटा दिया जाता है। यह chroot(2) से कड़ाई से अधिक मजबूत है क्योंकि पिछला रूट केवल छिपाया नहीं बल्कि अनमाउंट किया जाता है।

5. NO_NEW_PRIVS

PR_SET_NO_NEW_PRIVS setuid बाइनरी, फ़ाइल क्षमताओं, या LSM ट्रांज़िशन के माध्यम से किसी भी बाद के विशेषाधिकार लाभ को रोकता है। अपरिवर्तनीय।

6. क्षमता हटाना

उपयोगकर्ता और समूह ID तब बदले जाते हैं जब CAP_SETUID अभी भी धारित है, जिसके बाद capset सभी क्षमता सेट को शून्य कर देता है और securebits लॉक हो जाते हैं, इसलिए क्षमताओं को पुनः सक्षम नहीं किया जा सकता।

7. seccomp-BPF (whitelist-v1)

एक whitelist फ़िल्टर स्थापित किया जाता है; गैर-whitelisted कॉल समाप्त कर दिए जाते हैं। 24 सिसकॉल की अनुमति-सूची:

सिसकॉलसंख्याटिप्पणियाँ
read0stdin
write1stdout/stderr + रिपोर्ट पाइप
openat257फ़ाइल पहुँच (open नहीं)
close3—
lseek8—
brk12हीप प्रबंधन
mmap9arg-प्रतिबंधित: flags == 0x22 बिल्कुल (MAP_PRIVATE|MAP_ANONYMOUS) और prot & PROT_EXEC == 0
munmap11—
execve59स्टार्टअप पर एकल exec
exit_group231स्वच्छ प्रक्रिया निकास
rt_sigaction13सिग्नल हैंडलर
rt_sigprocmask14सिग्नल मास्किंग
getrandom318रैंडम संख्या स्रोत
clock_gettime228समय-निर्धारण
fstat5फ़ाइल मेटाडेटा
arch_prctl158TLS सेटअप
mprotect10arg-प्रतिबंधित: prot & PROT_EXEC == 0 (W^X संरक्षित करता है)
prlimit64302arg-प्रतिबंधित: new_limit == NULL पूर्ण 64-बिट (निम्न + उच्च शब्द दोनों शून्य; केवल-पढ़ने योग्य)
readlinkat267—
rseq334glibc पुनःआरंभ करने योग्य अनुक्रम
set_robust_list273glibc थ्रेड इनिट
set_tid_address218glibc इनिट
access21—
pread6417—

श्रेणियाँ