Repolode
anthropics

anthropics/sandbox-runtime

コンテナを使わず、OSレベルで任意のプロセスのファイルシステムとネットワークへのアクセスを制限する軽量なCLI兼ライブラリ。

スター
6,425
フォーク
562
未解決の Issue
300
最終コミット
6 時間前

これは何?

srtは、AIエージェント、ローカルMCPサーバー、bashコマンドなどの任意のコマンドやプロセスをラップし、読み取り・書き込み・接続できる対象を制限します。macOSでは、生成したSeatbeltプロファイルを使ってsandbox-execを実行し、Linuxではネットワーク名前空間を備えたbubblewrapを使います。Windowsでは、専用のローカルアカウントでプロセスを実行し、Windows Filtering Platformによる送信トラフィックの制限を適用します。

ネットワークアクセスはデフォルトで拒否されます。許可された通信はホスト上のHTTPプロキシおよびSOCKS5プロキシを経由し、ドメインの許可リストと拒否リストによって制御されます。ファイルシステムのルールは、読み取りには拒否後に許可する方式、書き込みには許可対象のみを認める方式を採用しています。どちらのプラットフォームでも、Unixソケットへのアクセスはデフォルトでブロックされます。

パッケージはコマンドラインから`srt`として利用するほか、TypeScriptライブラリとしてインポートし、SandboxManagerを使うこともできます。また、設定ファイル、macOSでの違反レポート、ランタイム設定用のチャネルにも対応しています。

主な機能

  • 01プロセスツリー全体のファイルシステム読み取り・書き込みを制限
  • 02ホスト側プロキシを通じてドメインの許可リストと拒否リストを適用
  • 03macOSではsandbox-exec、Linuxではbubblewrapを使用
  • 04Unixソケットへのアクセスをデフォルトでブロック
  • 05CLIとTypeScriptライブラリAPIの両方を提供

ユースケース

  • AIコーディングエージェントをサンドボックス化し、SSHキーの読み取りや任意のホストへの接続を防止
  • ローカルMCPサーバーがアクセスできるディレクトリと接続先を限定
  • 信頼できないbashコマンドやビルドスクリプトを、アクセスを制限して実行

クイックスタート

  1. 1

    npmでパッケージをグローバルにインストールする

    npm install -g @anthropic-ai/sandbox-runtime
  2. 2

    サンドボックス内でコマンドを実行する

    srt "curl example.com"

使う前に知っておきたいこと

  • ベータ版の研究プレビューです。APIや設定形式は変更される場合があります。
  • macOSのsandbox-execやLinuxのbubblewrapなど、OSのプリミティブに依存します。Linuxではbubblewrapのインストールが必要です。
  • Windowsでは、プロセストークンとシステムサービスに関する既知の制限がドキュメントに記載されています。

収録されている特集

トピック

よくある質問

sandbox-runtime とは?
コンテナを使わず、OSレベルで任意のプロセスのファイルシステムとネットワークへのアクセスを制限する軽量なCLI兼ライブラリ。 srtは、AIエージェント、ローカルMCPサーバー、bashコマンドなどの任意のコマンドやプロセスをラップし、読み取り・書き込み・接続できる対象を制限します。macOSでは、生成したSeatbeltプロファイルを使ってsandbox-execを実行し、Linuxではネットワーク名前空間を備えたbubblewrapを使います。Windowsでは、専用のローカルアカウントでプロセスを実行し、Windows Filtering Platformによる送信トラフィックの制限を適用します。
sandbox-runtime は無料で使えますか?ライセンスは?
sandbox-runtime は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
sandbox-runtime は今もメンテナンスされていますか?
活発にメンテナンス中。sandbox-runtime の最終コミットは 2026年10月24日 です。
sandbox-runtime は何に使えますか?
AIコーディングエージェントをサンドボックス化し、SSHキーの読み取りや任意のホストへの接続を防止 ローカルMCPサーバーがアクセスできるディレクトリと接続先を限定 信頼できないbashコマンドやビルドスクリプトを、アクセスを制限して実行
sandbox-runtime のインストール方法は?
npmでパッケージをグローバルにインストールする: npm install -g @anthropic-ai/sandbox-runtime サンドボックス内でコマンドを実行する: srt "curl example.com"
sandbox-runtime はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/anthropics/sandbox-runtime

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト