サンドボックスのラボ:信頼できないコードを、名前空間、cgroups、seccomp、gVisor の中で 1 台の専用 Ubuntu VM で動かす
このラボでは、自分が書いていないコード、たとえば AI エージェントが作ったスクリプトや、生徒やお客さんがアップロードしたプログラムを動かす方法を、生徒 1 人ひとりに 1 台の Ubuntu VM の中で教えます。害のない身代わり agent.py が鍵を読み、外へ通信し、プロセスを起動します。生徒は Linux カーネル自身の道具で、それを 1 つずつ囲っていきます。生徒がすべての囲いを一度に入れて書く 1 つのスクリプトは、生徒が見ることのない値を使うチェックが採点します。
生徒のパソコンには何も入れる必要がありません。道具はどれも本物で、Ubuntu のアーカイブから入ります。unshare と setpriv、cgroups v2、libseccomp、bubblewrap、nftables、gVisor の runsc です。最初から最後まで守る側の視点で、囲うのはラボ自身のプログラムだけ、場所は生徒自身のコピーだけです。
生徒が学ぶこと
信頼できないコードに何ができ、カーネルの囲いがそれぞれどの部分を止めるかを学びます。PID、ネットワーク、マウント、UTS、ユーザーの名前空間は、プロセス、ネットワーク、ファイル、root の力を隠します。cgroup はメモリー、CPU、プロセスの制限をかけ、生徒はカーネルが 64 MB でプログラムを止め、20 番目のプロセスを断るところを見ます。seccomp の許可リストは名前のないシステムコールをすべて断り、ケーパビリティは setpriv で落とし、nftables の許可リストはコードがどこへ接続できるかを決め、bubblewrap は 1 つのフォルダーを隠した読み取り専用の見え方を作ります。最後に gVisor が、プログラムのシステムコールに自分のカーネルで答え、Firecracker のマイクロ VM は説明します。
6 つのパート
1 つ目は、何の囲いもないエージェントです。2 つ目は、unshare で手で作る名前空間です。3 つ目は、私たちの短い補助コマンド sbx limit を使う cgroups です。4 つ目は、sbx seccomp を使う seccomp とケーパビリティです。5 つ目は、sbx egress とファイルの許可リストによるネットワーク、bubblewrap によるファイル、runsc による gVisor です。6 つ目は、生徒が書く 1 つのスクリプト run-agent.sh で、秘密、ネットワーク、1 つのフォルダーの外への書き込み、64 MB を超えるメモリー、20 を超えるプロセス、自分の許可リストにないシステムコールを、すべて止める必要があります。ホームフォルダーの README.md が何をするかを伝え、答えは書いてありません。
ブラウザーで動かす
VM ラボは、モジュールの中でラボ課題として設定します。サンプルはラボのページにあります。マシンは小さく、CPU 1 つ、メモリー 1 GB、ディスク 10 GB です。すべて Ubuntu のアーカイブから入るので、そのアーカイブにしか届かない訪問者の VM でも入れられます。
- ラボを追加する. 担当するモジュールで課題を追加し、Ubuntu VM ラボのカードを選びます。ページには compose ファイルの代わりに、マシンの短い説明が表示されます。
- サンプルから始める. ページに、すぐ使えるラボが並びます。Sandboxing を選びます。サンプルを使うと文章が置き換わりますが、元に戻すで自分の文章に戻せます。
- 公開して自分用のコピーを起動する. 公開してから、開始を押します。ラボの setup スクリプトが、VM の初回起動時に bubblewrap、libseccomp、nftables、gVisor を Ubuntu のアーカイブから入れ、補助コマンド sbx、身代わりのエージェント、作業用のファイル、README を書き込みます。数分かかります。
- ターミナルを開く. ターミナルを開き、ホームフォルダーの README.md を読みます。ブラウザーで開くものはなく、ラボはターミナルだけです。
このラボの基本レッスン
Sandboxing Basics は、Ubuntu VM であるこのラボで進める小さなレッスンです。導入、「できる」で書く目標、キーワード、スタート問題、考えごとの確認、よくある間違い、最後の確認があり、各ステップには、コマンドをマシンのターミナルに入力する実行ボタンがあります。生徒はエージェントが鍵を読み、外へ通信するのを見てから、囲いを 1 つずつ立てます。ネットワークなし、メモリーの上限、seccomp の許可リスト、隠したフォルダーです。
レッスンは周りを見て回るだけで、ラボ本来の課題であるすべての囲いを入れたスクリプトは生徒に任せるので、答えは配りません。大学向けモジュール「信頼できないコードと AI が書いたコードのサンドボックス」も、同じラボで進めます。
採点のしくみ
ラボにはチェックがあります。保存したマシンのコピーの上で root として動き、agent.py の代わりに自分のプログラムを置きます。テストごとに生徒の run-agent.sh を 1 回ずつ動かします。プログラムは seccomp フィルターの下でランダムな語を表示し、secrets フォルダーに書いた新しい秘密は決して表示せず、ランダムなポートの待ち受けには決して届かず、ランダムな名前のファイルを許された 1 つのフォルダーにだけ書き、200 MB を持つ前、20 のプロセスを起動する前に止められ、5 つから選んだ危険なシステムコール 1 つを断られなければなりません。チェックが表示した最初の行が理由を伝えます。
- 配る. 課題と同じようにラボを割り当てます。希望すれば期限も付けられます。生徒ごとに専用の VM が付き、授業のあとも残ります。
- チェックを実行する. クラス一覧の生徒の行で、チェックを実行を押します。保存したマシンのコピーを起動し(コピーは保存し直されません)、ラボのチェックスクリプトを root で実行して、合格したか、何を表示したか、いつかを示します。結果は生徒には伝わりません。
- 採点する. チェックが表示した最初の行を読みます。エージェントが秘密を読んだ、ネットワークに届いた、200 MB を持った、断られなかったシステムコールがある、など、何が正しくないかが書いてあります。足りなければ理由を付けて返します。
GitHub の定義
このファイルはラボの定義のすべてで、プラットフォームが実行するものと同じ文章です。サイズ、setup スクリプト、補助コマンド sbx、エージェント、作業用のファイル、README、チェックが入っています。コピーして、制限やエージェントを変えれば、より長いラボが作れます。
このラボを試す、そして費用
無料の個人アカウントで、このラボの基本レッスンに取り組めます。毎月、ほとんどのレッスンに足りる無料クレジットがあり、カードは要りません。クラスで使う場合、学校は最初の365日間、生徒50人まで無料で、その後は生徒1人あたりの年額です。すべてのラボが含まれ、教職員は無料です。
よくある質問
- ラボにライセンスは必要ですか。
- いいえ。bubblewrap、libseccomp、nftables、util-linux、gVisor はオープンソース(LGPL、GPL、Apache-2.0)で、生徒の VM の起動時に Ubuntu のアーカイブから入るので、こちらからは何も配布しません。
- なぜ Firecracker は動かさないのですか。
- Firecracker は、動くマシンの中に /dev/kvm が要りますが、プラットフォームの VM には入れ子の仮想化がありません。レッスンではマイクロ VM を説明し、KVM の要らない gVisor を動かします。
- 生徒が何かを壊すことはありますか。
- 壊せるのは自分のコピーだけです。生徒が囲うのはラボ自身の身代わりで、鍵はデモ用の値、届くネットワークは VM の中だけです。配られたファイルを壊しても、sbx reset で配られたときの状態に戻せます。
- ラボは実際の生徒用 VM で試しましたか。
- setup、すべてのレッスンのコマンド、チェック(ごまかし方ごと)は、VM の代わりの特権付き Ubuntu 26.04 コンテナーで、arm64 のマシン上で動かしました。AppArmor の決まりと amd64 のパッケージがある、起動した生徒用 VM では、授業の前に一度試すことをおすすめします。