Show HN: Z-Jail – 7つの防御レイヤーとゼロ依存性を持つ130KBのLinuxサンドボックス-C99
Show HN: Z-Jail – A 130 KB Linux sandbox-C99 with 7 defense layers and zero deps (github.com)
要約
Z-Jailは、Linux上でネイティブコードを実行するための多層サンドボックスで、外部依存性がなく、約130KBのPIEバイナリです。7つの独立した防御レイヤー(名前空間、pivot_root、機能、NO_NEW_PRIVS、seccomp-BPF、監査、そして真理判定エンジン)を備えており、最小限のリソースで高いセキュリティを提供します。CIパイプラインやCTFチャレンジ、軽量なコード評価など、コンテナランタイムを必要としない防御が必要な場合に最適です。
全文翻訳
Z-Jail
Linux上でのネイティブコード実行のためのマルチレイヤーサンドボックス。
7つの順序付けられた分離レイヤー — 外部依存関係なし、約81KiBの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-Jail | Firecracker | gVisor | bwrap | nsjail | |
|---|---|---|---|---|---|
| 外部依存関係 | ゼロ | libc, seccomp | Goランタイム | libc | libc, protobuf |
| バイナリサイズ | 約81KiB | 20MiB超 | 40MiB超 | 約70KiB | 約1MiB |
| VM分離 | いいえ | はい (microVM) | いいえ (サンドボックス) | いいえ | いいえ |
| seccompホワイトリスト | はい | いいえ | はい | オプション | はい |
| コンテンツハッシュ | はい | いいえ | いいえ | いいえ | いいえ |
| Audit JSON | はい | いいえ | はい | いいえ | 部分的 |
| ビルドの複雑さ | 1回のmake | 複雑 | 複雑 | 簡単 | 中程度 |
Z-Jailは、bwrap(最小限、デフォルトでseccompなし)とnsjail(多機能、重い依存関係)の間のニッチを埋めます。これは、コンテナランタイムを導入せずに防御を深める必要があるCIパイプライン、CTFジャイルチャレンジ、および軽量コード評価のために設計されています。
アーキテクチャ
データフロー
flowchart LR
CLI[CLI引数] --> P[引数解析]
P --> C{名前空間のクローン}
C -->|子プロセス| CR[子プロセス実行]
C -->|親プロセス| W[waitpid]
CR --> RL[rlimit設定]
RL --> FD[fd >= 3をクローズ]
FD --> DUMP[PR_SET_DUMPABLE=0]
DUMP --> PV[pivot_root]
PV --> NNP[PR_SET_NO_NEW_PRIVS]
NNP --> CAP[ケーパビリティ削除]
CAP --> SC[seccomp-BPF]
SC --> SIG[親プロセスにシグナル送信]
SIG --> EX[ターゲットexecve]
W --> A[監査JSON]
A --> EXIT[終了]
ロード中
レイヤーの順序
各レイヤーは、後続のレイヤーが先行するレイヤーによって取り消されないように順序付けられています。
- setrlimit — 最初にCPU、アドレス空間、ファイル数、プロセス数を制限します。
- fd scrub — レポートパイプ以外のすべての継承されたfdを閉じます。
- PR_SET_DUMPABLE=0 — コアダンプを無効にし、
/proc/self/memをロックダウンします。 - pivot_root — ホストファイルシステムからデタッチします。古いルートは遅延アンマウントされます。
- PR_SET_NO_NEW_PRIVS — この時点以降、setuidバイナリ、ファイルケーパビリティ、またはLSM遷移による権限昇格を防ぎます。
- drop_caps — すべてのケーパビリティをゼロにし、securebitsをロックします。
- seccomp-BPF — システムコールをホワイトリストのみに制限します。
- signal parent — サンドボックスの準備ができたことを親プロセスに伝えます。
- execve — プロセスをターゲットバイナリに置き換えます。
sequenceDiagram
participant P as 親
participant C as 子
P->>C: clone (NEWNS|NEWPID|NEWNET|NEWIPC|NEWUTS)
Note over C: setrlimit(CPU, AS, NOFILE, NPROC)
Note over C: close(すべてのfd > 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(すべてゼロ) + securebits
Note over C: seccomp(SECCOMP_MODE_FILTER, ホワイトリスト)
C->>P: write(パイプ, ready=1)
Note over C: execve(ターゲット)
P->>P: waitpid
P->>P: 監査JSONを書き込む
ロード中
レイヤー
Z-Jailは、execveの前に子プロセスで7つの順序付けられた分離メカニズムを適用します。各メカニズムは、後続のステップが先行するステップによって取り消されないように選択されています。親プロセスは5つの名前空間(マウント、PID、ネットワーク、IPC、UTS)を要求してclone()で子プロセスを作成し、その後、子プロセスは以下のパイプラインを実行します。
1. リソース制限
setrlimitは、ゲストによって影響されるコードが実行される前に、CPU時間、アドレス空間、オープンファイル数、およびプロセス数を制限し、フォーク爆弾やメモリ枯渇を防ぎます。
2. ファイルディスクリプタのクリーニング
親のレポートパイプを除き、継承されたすべてのディスクリプタは閉じられ、漏洩したハンドルがexecveを越えて伝播するのを防ぎます。
3. Dumpabilityオフ
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. Capabilityドロップ
ユーザーIDとグループIDは、CAP_SETUIDがまだ保持されている間に変更されます。その後、capsetですべてのケーパビリティセットがゼロになり、securebitsがロックされるため、ケーパビリティを再度有効にすることはできません。
7. seccomp-BPF (whitelist-v1)
ホワイトリストフィルタがインストールされ、ホワイトリストにない呼び出しは終了させられます。許可されるシステムコールは24個です。
| システムコール | 番号 | 注釈 |
|---|---|---|
read | 0 | 標準入力 |
write | 1 | 標準出力/標準エラー出力 + レポートパイプ |
openat | 257 | ファイルアクセス(openではない) |
close | 3 | — |
lseek | 8 | — |
brk | 12 | ヒープ管理 |
mmap | 9 | 引数制限: flags == 0x22 のみ(MAP_PRIVATE |
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 | — |
最後の9つ(arch_prctlからpread64)は、mainの前に最新の静的リンクされたglibcプログラムが必要とするCランタイム起動コールです。BPFフィルタは動的に生成されます。各ホワイトリストエントリに対して、ジャンプチェーンが出力され、システムコールが一致する場合は許可し、一致しない場合はKILLにフォールスルーします。アーキテクチャは最初にチェックされます(AUDIT_ARCH_X86_64)。
3つの引数レベルのルールがポリシーの意図を維持します。
mmapはflags == MAP_PRIVATE|ANONYMOUS (0x22)かつPROT_EXECがクリアされている場合にのみ制約されます。mprotectはPROT_EXECが設定されないように制限され(W^Xを強制)、prlimit64はNULLのnew_limit引数に制限され、64ビット全体がチェックされます(ゲストは制限を読み取ることはできますが、引き上げることはできません)。
フィルタは、ルート権限なしでテストケースを実際のprctl(PR_SET_SECCOMP)に対してフォーク+execするスタンドアロンテスト(tests/seccomp_filter_test.c、9/9パス)によって独立して検証されます。
監査レコード
子プロセスが終了した後、親プロセスはバージョン管理されたスキーマ(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=<ディレクトリ> [--seccomp-enforce] [--self-hash=<16進数>]
[--quiet] [--verbose] -- <プログラム> [引数...]
| フラグ | 説明 |
|---|---|
--root=<ディレクトリ> | サンドボックスのルートディレクトリ(必須) |
--seccomp-enforce | seccomp-BPFシステムコールホワイトリストを有効にする |
--self-hash=<16進数> | バイナリが期待されるBLAKE2b-256ハッシュと一致するか検証する |
--quiet | 監査出力を抑制する |
--no-audit | 監査ファイルの作成を完全に無効にする |
--verbose | デバッグログを有効にする |
--version | ビルドIDを表示する(Z-Jail/v1+dev) |
--help | 使用方法を表示して終了する |
例
# すべての保護機能で静的バイナリを実行する
sudo z_jail --root=./roots --seccomp-enforce -- bin/hello_static
# バイナリ整合性検証付きで実行する
sudo z_jail --root=./roots --seccomp-enforce \
--self-hash=$(b2sum -l 256 z_jail | cut -c1-64) -- bin/program
# クワイエットモード(監査JSONなし)
sudo z_jail --root=./roots --quiet -- bin/program
# 監査ファイルの作成を完全に無効にする
sudo z_jail --root=./roots --no-audit -- bin/program
終了コード
| コード | 意味 |
|---|---|
| 0 | 子プロセスが正常終了(判定: DETERMINISTIC) |
| 1 | 子プロセスがシグナルで終了(判定: REJECT) |
| 2 | Self-hash: 無効な16進数文字列またはファイルが読み取れない |
| 3 | Self-hash: 不一致(バイナリが改ざんされた) |
| 101 | 子プロセスセットアップエラー(rlimitなど) |
| 102 | 子プロセスseccompフィルタのインストールに失敗 |
| 103 | 子プロセスexecveに失敗(バイナリが見つからない、実行権限がない) |
| 104 | 子プロセスpivot_rootに失敗 |
| 105 | 子プロセスケーパビリティドロップに失敗 |
| 125 | 名前空間作成に失敗(rootで実行?カーネルサポート?) |
ビルドとインストール
要件
- Linuxカーネル ≥ 5.4 (名前空間、seccomp-BPF、pivot_root)
- GCC ≥ 11 (11.4, 13.2, 15.2でテスト済み)
- 外部ライブラリなし — 標準Cツールチェーンのみ
コマンド
make # z_jailをビルド(約81KiBのストリップなしPIEバイナリ)
make install # /usr/local/bin + manページにインストール
make clean # ビルド成果物を削除
make dist # リリースtarballを作成
make check # スモークテスト(--version + --help)
バイナリは、-fstack-protector-strong, -D_FORTIFY_SOURCE=2, フルRELRO, および -z now を使用して、Position Independent Executableとしてビルドされます。
コンパイル時オプション
make CC=clang CFLAGS="-O3 -march=native" # カスタムコンパイラ/フラグ
テスト
クイックテスト(root不要)
# seccompフィルタロジック(9つのテスト)
tests/build/seccomp_filter_test
# BLAKE2b既知値テスト
tests/build/blake2b_known
これらはrootを必要とせず、100ミリ秒未満で実行されます。
フルテストスイート
make -C tests setup # ペイロードとテストルートをビルド
sudo bash tests/run_tests.sh # 18シナリオ(インデックス0〜17)
名前空間作成のためにrootが必要です。テストスイートは以下をカバーしています。
| # | シナリオ | タイプ | テスト内容 |
|---|---|---|---|
| 0 | blake2b_regress | 既知値 | BLAKE2b実装の正確性 |
| 1 | seccomp_filter | スタンドアロンBPF | BPFフィルタロジックの9つのサブテスト |
| 2 | hello_static | OK | 基本的な静的バイナリ実行 |
| 3 | hello_dynamic | killed | 動的バイナリが拒否される(W^Xがld.soのPROT_EXECをブロック) |
| 4 | execve_replacement | OK | 起動時のポリシー準拠の単一execve |
| 5 | fd_inherited_read | OK | 標準入力/標準出力が正しく継承される |
| 6 | mmap_bad_flags | killed | MAP_SHAREDでのmmapがブロックされる |
| 7 | mmap_good_allowed | OK | MAP_PRIVATE |
| 8 | mmap_prot_exec | killed | PROT_EXECでのmmapがブロックされる |
| 9 | mmap_self_modify | killed | 自己変更コードがブロックされる |
| 10 | ptrace | killed | ptraceがブロックされる |
| 11 | socket | killed | ソケット作成がブロックされる |
| 12 | chroot_escape | killed | chrootシステムコールがブロックされる |
| 13 | double_chroot | killed | 二重chrootがブロックされる |
| 14 | mount_replay | killed | mountシステムコールがブロックされる |
| 15 | cpu_exhaust | killed | fork爆弾がRLIMIT_NPROC(CPUではない)で制限される |
| 16 | signal_parent | killed | 親プロセスへのシグナルがブロックされる |
| 17 | self_hash | OK | バイナリ整合性検証 |
パフォーマンス
ネイティブUbuntu 26.04 LTS(カーネル7.0.0、Intel i7-11800H、4 vCPU、3.8GiB RAM)で測定、各ツール50サンプル、均一なワークロード(exit_group(0)を本体とするスタンドアロン静的バイナリ)、getrusageハーネスでタイミングを取った。同じハードウェアでのWSL2実行もdocs/BENCHMARKS.mdに報告されています。
| メトリック | 値 |
|---|---|
| バイナリサイズ | 約81KiB(ストリップなし)(約33KiB(ストリップ済み)) |
| 平均サンドボックスレイテンシ | 2.31 ± 0.56 ms (95% CI [2.16, 2.47]) |
| ピークRSS | 1.61 MiB |
| コード行数(コア) | 約800 |
直接比較(同じホスト、同じ方法論)
| ツール | レイテンシ平均 ± sd | ピークRSS | デフォルトseccomp |
|---|---|---|---|
| Z-Jail | 2.31 ± 0.56 ms | 1.61 MiB | はい |
| bwrap | 3.35 ± 0.60 ms | 2.32 MiB | いいえ |
| nsjail | 6.28 ± 1.48 ms | 7.86 MiB | はい |
テストされた条件下では、Z-Jailは3つのプロセスレベルサンドボックスの中で最小の常駐メモリと最低のレイテンシを持っています。Bubblewrapはデフォルトでseccompフィルタを実行せず、セットアップ作業も少ないですが、ここではわずかに遅いです。Z-Jailはseccompホワイトリストをインストールし、ケーパビリティをドロップし、実行ごとにpivot_rootを実行します。gVisor(runsc)はWSL2カーネルでセグメンテーション違反を起こし(docs/BENCHMARKS.md参照)、そこで測定できませんでした。FirecrackerはmicroVM(VMコールドブート、別のメトリック)で分離し、フォークから実行までのテーブルからは除外されています。これらは単一ホストの数値です — 相対的なものとして扱ってください。
注: 以前に文書化された数値(約8ms、約4MiB、約130KiB)は不正確であり、このコードベースとは一致しません。上記の数値は現在の
makeビルドで再測定されました。ベンチマーク中に発見されたマウント伝播バグはsrc/sandbox.c(バインドマウント前のMS_REC|MS_PRIVATE)で修正されました。再帰的なリモウントが測定されたレイテンシの一部を占めています。
脅威モデル
対象範囲
- 信頼されていないペイロードによる任意のネイティブコード実行
chroot,mount,ptrace,socket,process_vm_writevを介したエスケープ- フォーク爆弾、CPU枯渇(
RLIMIT_CPU)、メモリ枯渇(RLIMIT_AS) execveを越えるファイルディスクリプタの漏洩setuid/ 動的リンカ /LD_PRELOADによるエスカレーション- seccompフィルタの削除またはケーパビリティの再有効化
対象外
- 許可されたシステムコールサーフェスの外にあるカーネルゼロデイ
- ハードウェアサイドチャネル(Spectre, Meltdown)
- 共有
/proc,/sysマウントを介した共存VMのエスケープ CLONE_NEWNET+ ブロックされたsocketを超えるネットワークエグレス- 同胞サンドボックスのリソース枯渇(cgroupサポートが必要)
仮定
- ホストカーネルは変更されていないLinux ≥ 5.4であること
clone(CLONE_NEWNS|CLONE_NEWPID|...)が成功すること(CAP_SYS_ADMINが必要)- ターゲットバイナリは静的リンクされている必要がある(動的バイナリは、ライブラリが
--rootにステージングされていても、W^Xによって拒否される) --self-hash=<16進数>が本番環境のデプロイメントで構成されていること
ドキュメント
| ファイル | 説明 |
|---|---|
README.md | このファイル |
docs/ARCHITECTURE.md | アーキテクチャ概要 |
docs/SANDBOX.md | レイヤーごとのサンドボックス内部構造 |
docs/SECCOMP.md | seccomp-BPFホワイトリスト設計 |
docs/AUDIT_SCHEMA.md | 監査JSONスキーマリファレンス |
docs/THREAT_MODEL.md | セキュリティ上の仮定と範囲 |
docs/BLAKE2B.md | BLAKE2b実装の詳細 |
docs/BENCHMARKS.md | パフォーマンスベンチマーク |
docs/BUILD.md | ビルド手順 |
docs/adr/ | アーキテクチャ決定記録(4件) |
man/z_jail.1 | マニュアルページ |
SECURITY.md | セキュリティポリシーと報告 |
CONTRIBUTING.md | 貢献方法 |
CHANGELOG.md | リリース履歴 |
ROADMAP.md | 将来計画 |
TODO.md | 既知のギャップと計画中の作業 |
ロードマップ
v1.1.0 (現在)
- 7つの順序付けられた分離レイヤー
- BLAKE2b-256コンテンツフィンガープリント
append_only追跡とfdatasync耐久性を持つ監査JSON出力- seccomp-BPFジャンプオフセット検証(オーバーフロー時にクローズして失敗)
- 監査ファイル作成を無効にする
--no-auditフラグ - 自己完結型バイナリのための
STATIC=1ビルドオプション - 18のテストシナリオ(インデックス0〜17)+ 9つのseccomp単体チェック
- マニュアルページ、補完(bash, zsh, fish)
- seccomp耐久性ベンチマーク
v2 (計画中)
- 外部seccompポリシーファイル(JSONまたはBPFソース)
- サンドボックスインスタンスごとのカスタム名前空間フラグ
- CLI経由で設定可能なシステムコールホワイトリスト
- CI統合のためのパフォーマンスプロファイリングフック
- リリース署名(minisign/signify)
- ファズ統合(oss-fuzz / libFuzzer)
ステータス
ライセンス
MIT — 全文はLICENSEを参照してください。
Z-JailはWSL2(Kali Linux, GCC 15.2.0)でビルドされ、Linux 5.4+をターゲットとしています。 Division-36がメンテナンスしています。問題はissue trackerに報告してください。