
Z-Jail v1.1.0
صندوق رمل لينكس خفيف الوزن ومتعدد الطبقات يجمع بين namespaces وpivot_root وseccomp-bpf وإسقاط الصلاحيات، ومحرك قرارات قائم على الأدلة (النسخة العامة من Truthimatics) لتنفيذ كود آمن وقابل للتدقيق.
Z-Jail
صندوق رمل متعدد الطبقات لتنفيذ الشيفرة الأصلية على 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) │
└──────────────────────────────────────────────────────┘
جدول المحتويات
- البدء السريع
- لماذا Z-Jail
- البنية
- الطبقات
- الاستخدام
- البناء والتثبيت
- الاختبار
- الأداء
- نموذج التهديد
- التوثيق
- خارطة الطريق
- الترخيص
البدء السريع
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-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]
ترتيب الطبقات
تُرتَّب كل طبقة بحيث لا يمكن لطبقة لاحقة أن تُلغى بواسطة طبقة سابقة:
- setrlimit — تحديد سقف لوحدة المعالجة المركزية، ومساحة العناوين، وعدد الملفات، والعمليات قبل أي شيء آخر
- fd scrub — إغلاق جميع واصفات الملفات الموروثة باستثناء أنبوب التقرير
- PR_SET_DUMPABLE=0 — تعطيل تفريغ النواة، وتقييد /proc/self/mem
- pivot_root — الانفصال عن نظام ملفات المضيف؛ إلغاء تركيب الجذر القديم بشكل مؤجل
- PR_SET_NO_NEW_PRIVS — لا setuid، ولا تصعيد عبر
capsetبعد هذه النقطة - drop_caps — تصفير جميع القدرات، وقفل securebits
- seccomp-BPF — تقييد استدعاءات النظام على القائمة البيضاء فقط
- signal parent — إبلاغ العملية الأب بأن البيئة المعزولة جاهزة
- 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 من وقت المعالج ومساحة العنوان والملفات المفتوحة وعدد العمليات
قبل تشغيل أي شيفرة تتأثر بالضيف، مما يحدّ من قنابل التفريع (fork bombs) واستنزاف الذاكرة.
2. تنقية واصفات الملفات
تُغلق جميع الواصفات الموروثة باستثناء أنبوب تقرير العملية الأم،
مما يمنع تسرّب المقابض عبر execve.
3. تعطيل قابلية التفريغ
يعطّل PR_SET_DUMPABLE=0 تفريغات النواة (core dumps) ويقيّد الوصول إلى /proc/self/mem.
4. pivot_root
يُستبدل جذر مساحة اسم التحميل بالدليل الجذري المقدَّم:
يُربط الدليل على نفسه (bind-mount)، ويبدّل pivot_root شجرة التحميل،
وتنتقل العملية بـ chdir إلى الجذر الجديد، ويُفصل الجذر القديم بتأخير
ويُزال. هذا أقوى بشكل صارم من chroot(2) لأن الجذر السابق
يُلغى تحميله بدلاً من مجرد إخفائه.
5. NO_NEW_PRIVS
يمنع PR_SET_NO_NEW_PRIVS أي اكتساب لاحق للامتيازات عبر ثنائيات setuid،
أو قدرات الملفات، أو انتقالات LSM. لا رجعة فيه.
6. إسقاط القدرات
تُغيَّر معرّفات المستخدم والمجموعة بينما لا يزال CAP_SETUID محتفظاً به، وبعد ذلك
تُصفّر capset جميع مجموعات القدرات وتُقفل securebits، بحيث
لا يمكن إعادة تمكين القدرات.
7. seccomp-BPF (whitelist-v1)
يُثبَّت مرشّح قائمة بيضاء؛ تُنهى الاستدعاءات غير المدرجة في القائمة البيضاء. قائمة السماح المكوّنة من 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).