صندوق رمل لينكس خفيف الوزن ومتعدد الطبقات يجمع بين namespaces وpivot_root وseccomp-bpf وإسقاط الصلاحيات، ومحرك قرارات قائم على الأدلة (النسخة العامة من Truthimatics) لتنفيذ كود آمن وقابل للتدقيق.
صندوق رمل متعدد الطبقات لتنفيذ الشيفرة الأصلية على Linux.
سبع طبقات عزل مرتبة — بدون تبعيات خارجية، ملف تنفيذي PIE بحجم ~81 KiB.
┌──────────────────────────────────────────────────────┐
│ 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 bombs) واستنزاف الذاكرة.
تُغلق جميع الواصفات الموروثة باستثناء أنبوب تقرير العملية الأم،
مما يمنع تسرّب المقابض عبر execve.
يعطّل PR_SET_DUMPABLE=0 تفريغات النواة (core dumps) ويقيّد الوصول إلى /proc/self/mem.
pivot_rootيُستبدل جذر مساحة اسم التحميل بالدليل الجذري المقدَّم:
يُربط الدليل على نفسه (bind-mount)، ويبدّل pivot_root شجرة التحميل،
وتنتقل العملية بـ chdir إلى الجذر الجديد، ويُفصل الجذر القديم بتأخير
ويُزال. هذا أقوى بشكل صارم من chroot(2) لأن الجذر السابق
يُلغى تحميله بدلاً من مجرد إخفائه.
NO_NEW_PRIVSيمنع PR_SET_NO_NEW_PRIVS أي اكتساب لاحق للامتيازات عبر ثنائيات setuid،
أو قدرات الملفات، أو انتقالات LSM. لا رجعة فيه.
تُغيَّر معرّفات المستخدم والمجموعة بينما لا يزال CAP_SETUID محتفظاً به، وبعد ذلك
تُصفّر capset جميع مجموعات القدرات وتُقفل securebits، بحيث
لا يمكن إعادة تمكين القدرات.
يُثبَّت مرشّح قائمة بيضاء؛ تُنهى الاستدعاءات غير المدرجة في القائمة البيضاء. قائمة السماح المكوّنة من 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 | تنفيذ واحد عند بدء التشغيل |
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-بت (الكلمة المنخفضة والعالية كلتاهما صفر؛ للقراءة فقط) |
readlinkat | 267 | — |
rseq | 334 | تسلسلات glibc القابلة لإعادة التشغيل |
set_robust_list | 273 | تهيئة خيوط glibc |
set_tid_address | 218 | تهيئة glibc |
access | 21 | — |
pread64 | 17 | — |
التسعة الأخيرة (arch_prctl .. pread64) هي استدعاءات بدء تشغيل وقت التشغيل C التي
يحتاجها برنامج glibc حديث مرتبط بشكل ثابت قبل main. يُولَّد مرشّح BPF
ديناميكياً: لكل إدخال في القائمة البيضاء تُصدر سلسلة قفزات
إما تسمح (إذا تطابق استدعاء النظام) أو تمرّ إلى KILL. تُفحص البنية
أولاً (AUDIT_ARCH_X86_64).