基于 Linux 微虚拟机的 CLI 工具,用于隔离运行 AI 智能体,支持网络白名单和宿主机侧密钥注入。
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
使用 npm 全局安装该包
npm install -g @anthropic-ai/sandbox-runtime - 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 数据每日更新。
相关项目
647+3 本周37GoMIT更新于 20天前
为 Claude Code 等 AI 编程代理提供沙箱隔离,在原生沙箱或 Docker 中免确认运行,保护本机文件安全。
42932ShellMIT更新于 26天前
用 Go 编写的加密叠加文件系统,通过 FUSE 将密文目录挂载为可读的明文视图。
4658+4 本周304GoMIT更新于 前天
面向 AI 智能体的版本化文件系统,为每个智能体提供可写、可分叉的项目副本,并以去重方式持久保存历史。
2035+122 本周98RustMIT更新于 8小时前
用 Go 编写的应用内核,在用户态拦截 Linux 系统调用来隔离容器,可作为 runsc OCI 运行时使用。
2万+15 本周2031GoApache-2.0更新于 7小时前