العودة إلى التحديثات
New releaseJul 27, 2026

Z-Jail v1.1.0

صندوق رمل لينكس خفيف الوزن ومتعدد الطبقات يجمع بين namespaces وpivot_root وseccomp-bpf وإسقاط الصلاحيات، ومحرك قرارات قائم على الأدلة (النسخة العامة من Truthimatics) لتنفيذ كود آمن وقابل للتدقيق.

مشاركة
Z-Jail

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)   │
└──────────────────────────────────────────────────────┘

جدول المحتويات


البدء السريع

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
عزل الآلة الافتراضيةلانعم (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 — تحديد سقف لوحدة المعالجة المركزية، ومساحة العناوين، وعدد الملفات، والعمليات قبل أي شيء آخر
  2. fd scrub — إغلاق جميع واصفات الملفات الموروثة باستثناء أنبوب التقرير
  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 من وقت المعالج ومساحة العنوان والملفات المفتوحة وعدد العمليات قبل تشغيل أي شيفرة تتأثر بالضيف، مما يحدّ من قنابل التفريع (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 استدعاء نظام:

استدعاء النظامالرقمملاحظات
read0stdin
write1stdout/stderr + أنبوب التقرير
openat257الوصول إلى الملفات (وليس open)
close3—
lseek8—
brk12إدارة الكومة
mmap9مقيّد بالوسائط: flags == 0x22 بالضبط (MAP_PRIVATE|MAP_ANONYMOUS) و prot & PROT_EXEC == 0
munmap11—
execve59تنفيذ واحد عند بدء التشغيل
exit_group231خروج نظيف للعملية
rt_sigaction13معالجات الإشارات
rt_sigprocmask14حجب الإشارات
getrandom318مصدر الأرقام العشوائية
clock_gettime228التوقيت
fstat5بيانات وصفية للملف
arch_prctl158إعداد TLS
mprotect10مقيّد بالوسائط: prot & PROT_EXEC == 0 (يحافظ على W^X)
prlimit64302مقيّد بالوسائط: new_limit == NULL كامل 64-بت (الكلمة المنخفضة والعالية كلتاهما صفر؛ للقراءة فقط)
readlinkat267—
rseq334تسلسلات glibc القابلة لإعادة التشغيل
set_robust_list273تهيئة خيوط glibc
set_tid_address218تهيئة glibc
access21—
pread6417—

التسعة الأخيرة (arch_prctl .. pread64) هي استدعاءات بدء تشغيل وقت التشغيل C التي يحتاجها برنامج glibc حديث مرتبط بشكل ثابت قبل main. يُولَّد مرشّح BPF ديناميكياً: لكل إدخال في القائمة البيضاء تُصدر سلسلة قفزات إما تسمح (إذا تطابق استدعاء النظام) أو تمرّ إلى KILL. تُفحص البنية أولاً (AUDIT_ARCH_X86_64).

الفئات