AIアプリ開発に必須！安全なサンドボックス環境を一発構築 — OpenSandbox

アーキテクチャ・仕組み

OpenSandboxは以下の主要コンポーネントで構成されています：

• サーバー: Python FastAPIベースのサンドボックスライフサイクル管理サーバー
• execd: サンドボックス内部で動作する実行デーモン（コマンド実行・ファイル操作を担当）
• Ingress Gateway: 複数のルーティング戦略を持つ統合型トラフィック入口プロキシ
• Egress Control: サンドボックスごとのネットワーク外向き通信制御

対応SDK（多言語対応）

対応ランタイム

• Docker: ローカル環境での実行に対応
• Kubernetes: 大規模分散スケジューリング用の高性能ランタイム

セキュリティ・隔離機能

サンドボックスワークロードとホスト間の強力な隔離をサポート：

• gVisor: Googleが開発したアプリケーションカーネルによるコンテナ隔離
• Kata Containers: 軽量VMベースのコンテナ隔離
• Firecracker microVM: AWSが開発したマイクロVM技術による隔離

主要な機能一覧

• サンドボックスのライフサイクル管理（作成・起動・停止・削除）
• シェルコマンドの実行
• ファイルの読み書き操作
• Code Interpreter（Pythonコードの実行と結果取得）
• ネットワークポリシー制御（Ingress/Egress）
• OpenAPI仕様に基づくサンドボックスプロトコル（カスタムランタイム拡張可能）

対応シナリオと実例

• Coding Agent: Claude Code、Gemini CLI、Codex CLI、Kimi CLI、iFLow CLI
• ブラウザ自動化: Headless Chromium、Playwright
• デスクトップ環境: VNCアクセス、VS Code Web（code-server）
• 機械学習: DQN CartPoleの強化学習トレーニング例
• フレームワーク連携: LangGraph、Google ADK、Nullclaw、OpenClaw
• Kubernetes連携: kubernetes-sigs/agent-sandbox

ロードマップ（2026年3月予定）

• クライアント側サンドボックス接続プール（ミリ秒レベルでの環境取得）
• Go SDK
• 永続ボリュームのマウントサポート
• PC上で直接動作する軽量ローカルサンドボックス
• セキュアコンテナ対応の強化
• セルフホストKubernetesクラスターのデプロイメントガイド

ライセンス

Apache License 2.0（商用利用可能なオープンソースライセンス）

プロジェクト構成

サンドボックスサーバーのインストールと起動

前提条件: Docker、Python 3.10以上

# 1. サーバーをインストール
uv pip install opensandbox-server

# 2. 設定ファイルを生成
opensandbox-server init-config ~/.sandbox.toml --example docker

# 3. サーバーを起動
opensandbox-server

Code Interpreter SDKのインストールと実行

# Code Interpreter SDKをインストール
uv pip install opensandbox-code-interpreter

import asyncio
from datetime import timedelta
from code_interpreter import CodeInterpreter, SupportedLanguage
from opensandbox import Sandbox

async def main() -> None:
    sandbox = await Sandbox.create(
        "opensandbox/code-interpreter:v1.0.1",
        entrypoint=["/opt/opensandbox/code-interpreter.sh"],
        timeout=timedelta(minutes=10),
    )
    async with sandbox:
        execution = await sandbox.commands.run("echo 'Hello OpenSandbox!'")
        print(execution.logs.stdout[0].text)
    await sandbox.kill()

asyncio.run(main())