Repolode
anthropics

anthropics/sandbox-runtime

一个轻量的 CLI 和库,在操作系统层面限制任意进程的文件系统与网络访问,无需容器。

Star
6,425
Fork
562
未关闭 Issue
300
最近提交
8小时前

这是什么?

srt 可以包裹任意命令,例如 AI 智能体、本地 MCP 服务器、bash 命令或其他进程,并限制它们能读写哪些文件、能连接哪些网络。macOS 上它基于 sandbox-exec 与动态生成的 Seatbelt 配置,Linux 上使用 bubblewrap 并隔离网络命名空间,Windows 则以专用本地账户运行进程,并配合 Windows Filtering Platform 做出站限制。

网络默认全部禁止,允许的流量经由宿主机上的 HTTP 和 SOCKS5 代理转发,由代理执行域名白名单与黑名单。文件系统读取采用先拒绝、再放行的规则,写入则只允许明确列出的路径。两个平台默认都禁止访问 Unix 套接字。

它既可以作为 `srt` 命令行工具使用,也可以作为 TypeScript 库通过 SandboxManager 引入,并支持配置文件、macOS 上的违规事件监控等功能。

核心功能

  • 01对任意进程树限制文件系统的读取与写入
  • 02通过宿主机代理执行域名白名单和黑名单
  • 03macOS 使用 sandbox-exec,Linux 使用 bubblewrap
  • 04默认禁止访问 Unix 套接字
  • 05同时提供命令行工具和 TypeScript 库接口

适用场景

  • 为 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 等系统原语,在 Linux 上需要安装 bubblewrap。
  • Windows 支持存在文档中列出的已知限制,涉及进程令牌和系统服务。

收录于专题

标签

常见问题

sandbox-runtime 是什么?
一个轻量的 CLI 和库,在操作系统层面限制任意进程的文件系统与网络访问,无需容器。 srt 可以包裹任意命令,例如 AI 智能体、本地 MCP 服务器、bash 命令或其他进程,并限制它们能读写哪些文件、能连接哪些网络。macOS 上它基于 sandbox-exec 与动态生成的 Seatbelt 配置,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

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目