3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Docker SandboxesでAIエージェントを隔離する

3
Posted at

Docker SandboxesでAIエージェントを隔離する

2026年11月18日に、Docker公式の無料セミナー「Docker Sandboxes」を聞いてきました。Dockerやエージェント用のサンドボックスに馴染みがない方向けに、仕組みと導入手順を書いておきます。手順とコマンドは2026年11月19日時点の公式ドキュメントで確認しました。

事例の登壇企業と登壇者は匿名で、発表内容を要約しています。

1. Docker Sandboxesとは

Docker Sandboxesは、AIエージェントの作業環境を起動するツールです。Claude CodeやCodexのようにコードを書いたりコマンドを実行したりするエージェントを、microVMという軽量な仮想マシンの中で動かします。

image.png

サンドボックスごとに専用のファイルシステムとDockerデーモンがあり、ネットワークも独立しています。ホストPCのファイルでエージェントから見えるのは、起動したときのカレントディレクトリだけ。Docker DesktopやDocker Engineは不要で、起動から削除までCLIのsbxで扱えます。

対応エージェントは Claude Code, Codex, Copilot, Cursor, Devin, Docker Agent, Droid, Kiro, OpenCode, Shell です。

2. なぜ必要か

エージェントに毎回確認を求めず実行させる、いわゆるYOLOモードだと作業は速く進みます。ただ、PCで直接動かしていると、作業フォルダの外にあるファイルやAPIキーにも手が届きます。

事例登壇では、非IT出身の開発者から「これ、Yesを押して大丈夫ですか?」と相談された話が出てきました。実行していいかを毎回人が判断するのは難しいので、自動実行を任せるなら、何かあっても影響が広がらないように作業環境を隔離しておくと説明していました。

方式ごとの違いは、セミナーでの整理では以下のとおりです。

方式 隔離の強さ 特徴
PCで直接実行 なし PC内のファイルや鍵に手が届く
コンテナ/ツール付属のサンドボックス 中 隔離の境界が弱めで、ツールごとに設定が分かれる
Docker Sandboxes(microVM) 強 起動が速く、中で専用のDockerコンテナも動かせる

3. ファイルと認証情報、通信の扱い

認証情報と外向きの通信ルールはホスト側で管理します。APIキーやトークンの実体はホストに残り、サンドボックス内には保存されません。ホスト側が許可済みの宛先への通信にだけ鍵を付けます。エージェントは鍵に触れられないため、持ち出せません。

image.png

  • 読み書きできるのは起動時の作業フォルダだけです。元の作業ツリーを触らせないclone modeも使えます。
  • 認証情報はsbx secretか環境変数で明示的に渡します。sbx secret set <service>で登録できます。
  • 外向きのTCP通信は明示的に許可した宛先だけ通ります。許可にはsbx policy allow network <宛先>を使います。

通信ルールや、ある宛先への通信が通るかどうかはホスト側で確認できます。実際にどこへ通信しようとしたかも、ホスト側のログで追えます。

4. 費用

sbx CLIとローカルのサンドボックスは無料で、商用でも使えるので導入しやすいと思います。Cloud sandboxes(--cloud)は従量課金で、AIモデルの利用料は各提供元から別途かかります。組織横断のポリシー管理(AI Governance)は別の有料サブスクリプションです。

5. セミナーの内容

5.1 ある企業での検証

事例登壇では、AIエージェントに作業を任せるPoCが3件紹介されました。

  • Backstageの依存関係を更新しました。新しい通信先を許可するかは人が判断しました。
  • Azureのコストを確認するアプリを、ホストのAzure認証情報を渡さずに修正しました。
  • 既存アプリ3件にBiomeを導入し、通信を制限したまま検証まで終えました。

デモでは、依存パッケージが環境変数の名前を外に送ろうとしたところでホスト側が通信を止め、その記録がログに残りました。

5.2 Docker社の発表

後半はDocker社の発表でした。どのモデルが向いているかは頻繁に変わり、用途による使い分けもあります。発表では、モデルやツールが混在することを前提にしていました。

プロンプトに「触るな」と書いても、指示に反して実行された例が紹介されました。そこで、エージェントに共通する実行環境でルールを強制します。「ブレーキがあるからクルマは速く走れる」という例えが出ていました。

今後の方向性として出ていたのが、宛先に加えて、そのリクエストが何をするのかまで見て判断するポリシーです。同じ宛先への通信でも、読み取りは通して削除は止める、といった使い方です。アプリで何をしようとしているか、その操作が社内でどれくらい重要かを見て、ポリシーと照らし合わせて通すか決めます。

発表の最後には、ノートPCからクラウドまで同じ考え方で動かし、ポリシーを一元管理して監査できるようにする構想が示されました。操作の意味まで見て判断できるよう、ランタイムも拡張できる形にしていくそうです。

6. 所感

会社や情シスに相談するとき、エージェントにどのフォルダを見せ、どこへの通信を許可するかを具体的に説明しやすそうです。

今まではClaude・GPT・Geminiで使うサンドボックスが別々で、設定やルールを個別に管理するのが大変でした。部署ごとに使うモデルが違う会社だと、対応エージェントの実行環境をsbxにそろえられるのは特に助かると思います。

image.png

僕なら、必要なツールや通信先に合わせてプロジェクトごとに環境を作ります。定義を配れば、メンバーが各自のPCで同じ環境を立ち上げられます。

image.png

操作ごとに許可を変える構想が紹介されました。社内で任せられる作業も増えそうです。事例でも、次の段階として社内Kitの配布や、組織でのポリシーと監査ログの管理が挙がっていました。段階を踏んで広げるイメージは持てましたが、うちの会社でどこまでやるかはまだ分かりません。

7. 導入してみる

7.1 動作要件

OS 要件
macOS macOS 14以降、Apple silicon
Windows Windows 11 x64、Windows Hypervisor Platform
Ubuntu Ubuntu 24.04以降、KVM(kvmグループへの所属)

7.2 インストール

OS 手順・コマンド
macOS brew trust docker/tap
brew install docker/tap/sbx
Windows(事前準備) 管理者PowerShellで実行
Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform -All
Windows(導入) winget install -h Docker.sbx
※全ユーザー向けは DockerSandboxesMachine.msi を msiexec.exe /i DockerSandboxesMachine.msi /quiet で実行
Ubuntu(事前準備) KVMの確認とグループ追加
lsmod | grep kvm
sudo usermod -aG kvm $USER
Ubuntu(導入) curl -fsSL https://get.docker.com | sudo REPO_ONLY=1 sh
sudo apt install docker-sbx

7.3 サインインと初回起動

Dockerアカウントでサインインします。実行するとブラウザでDocker OAuthの認証画面が開きます。

sbx login

サインインできたら、プロジェクトのフォルダに移動して起動します。

cd ~/my-project
sbx run --name my-sandbox claude

claudeの部分はcodexなど他の対応エージェントに変更できます。初回起動時にはネットワークポリシーを聞かれます。迷ったときは Balanced で始めると、一般的な開発サービスにはそのまま接続でき、それ以外は承認制になります。より厳しいプリセットは Locked Down です。

対話なしで Balanced を設定する場合は、次のコマンドを使います。

sbx policy init balanced

7.4 認証情報の渡し方

対象 設定方法
Claudeサブスクリプション サンドボックス内で/loginを実行(トークンの扱いは3章参照)
APIキー sbx secret set <service>(例:sbx secret set anthropic)
GitHub sbx secret set github --command 'gh auth token'

7.5 よく使うコマンド一覧

やりたいこと コマンド
TUIダッシュボードを開く sbx
サンドボックスの一覧を見る sbx ls
通信ポリシーの一覧を見る sbx policy ls
通信先を許可する sbx policy allow network registry.npmjs.org
通信の判定結果を確認する sbx policy check network
通信ログを見る sbx policy log
停止する(中身は保持される) sbx stop my-sandbox
削除する(ホストの作業ツリーは影響なし) sbx rm my-sandbox

通信エラーで作業が止まったら、sbx policy logで遮断された宛先を確認できます。人が許可してよいと判断した宛先は、sbx policy allow network <宛先>で通せます。

7.6 チームへ配る

  • Kitsではツール・設定・通信ルールを再利用できる形でまとめて配り、sbx run <agent> --kit <kit名>で起動します。
  • 環境ファイル sbxenv.yaml(実験的)ではプロジェクトのagent / workspace / kits / env / portsを宣言し、sbx env runで起動します。

7.6.1 Kitsの利用と管理

レジストリやGitからKitを指定して起動できます。

sbx run codex --kit docker.io/<NAMESPACE>/company-cli:1.0.0

社内レジストリを使う場合は取得元を設定します。Kitはsbx kit signで署名し、sbx kit verifyで検証できます。配布時に署名を必須にする設定もあります。

sbx settings set kit.allowedSources '["docker.io/", ...]'

sbx settings set kit.requireSignature true

7.6.2 環境ファイル sbxenv.yaml

リポジトリ外に置いてチームで共有し、sbx env runで起動します(起動時にプランを承認します)。

schemaVersion: "1"
name: web-app
agent: claude
workspace: ./web-app
kits:
  - docker.io/sbx/playwright:1.61.1
sbx env run

7.6.3 Cloud sandboxes

--cloudを付けるとクラウド上で実行できます。なお、ローカルとは認証・ポリシー・ライフサイクルが別になります。

8. まとめ

事例登壇の締めくくりは「まずは小さなタスクから」でした。僕が社内で試すなら、依存パッケージの更新やlintの導入、軽いバグ修正あたりをひとつ選んで、sbx run --name my-sandbox claudeでエージェントに任せてみます。

参考(公式ドキュメント)

3
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?