周三下午,你让一个AI编程代理帮忙改几行代码。它跑起来了,开始读文件、装依赖、执行命令——然后你意识到,它现在能碰你电脑上的任何东西。Docker给出的解法是:别让它待在你的机器里,把它关进一个独立的虚拟机。

打开网易新闻 查看精彩图片

Docker Sandboxes 是一套用来运行自主AI编程代理的隔离 microVM 环境。每个沙箱有自己的内核、Docker 守护进程、文件系统和网络。在沙箱内部,代理拥有包括 sudo 在内的完整权限;在沙箱外部,它只能看到你共享的工作区,以及你的策略允许它访问的网络目标。

管理这些沙箱用的是sbxCLI,不需要 Docker Desktop 或 Docker Engine。同一个 CLI 既能跑笔记本上的本地沙箱,也能跑 Docker 托管的云端沙箱,sbx move命令可以在两者之间搬运沙箱的文件系统。

Docker 在 2026 年 11 月 19 日把品牌重新定位到一句话上:“容器隔离的是工作负载。但代理不是工作负载,代理是行动者。”这次品牌更新的文章本身对产品着墨不多,只把读者引向 Docker Sandboxes 和 Docker AI Governance。

五层隔离,核心是那道虚拟机边界

Docker 的安全模型列了五层:

  • 管理程序隔离:每个沙箱有独立内核,与宿主机不共享内存或进程。
  • 网络隔离:出站 TCP 流量经过宿主机上一个默认拒绝的代理策略,UDP 和 ICMP 默认被阻断。
  • Docker Engine 隔离:代理的容器跑在专属引擎上,碰不到宿主机的守护进程。
  • 工作区隔离:代理能看到什么由你决定——什么都不给、只读挂载仓库、或给工作树的读写权限。
  • 凭证隔离:API 密钥从不进入虚拟机。代理看到的是一个哨兵值,请求离开沙箱后由宿主机代理替换成真实凭证。

被提示注入攻击的代理,没法打印出它从未拥有的密钥。但它仍然可以通过被允许的请求使用这个密钥——所以网络策略和凭证隔离同样重要。

Docker 也把隔离覆盖不到的地方说清楚了。在直接模式下,代理会改动你的真实文件,包括之后会在宿主机上运行的 Git hook、CI 配置和 package.json 脚本。Git hook 不会出现在git diff的输出里,需要单独检查。

支持哪些代理,怎么装

本地沙箱支持的代理包括 Claude Code、Codex、Copilot、Cursor、Devin、Docker Agent、Droid、Kiro、OpenCode,另外还有一个不带代理的 Shell 沙箱用于手动安装。每个代理都从模板镜像启动,比如 Codex 用的是docker/sandbox-templates:codex,默认启动命令是codex --dangerously-bypass-approvals-and-sandbox。Docker 的理由是:microVM、网络策略和凭证隔离已经覆盖了审批提示所保护的东西,会话内也可以重新打开审批。

一个容易让人困惑的安装细节:沙箱不会导入~/.claude或~/.codex这类用户级配置,只接收工作目录里的项目级配置。

以 Ubuntu 为例,安装命令是curl -fsSL https://get.docker.com | sudo SBX=1 sh,之后按启动指南操作:

  1. sbx login登录,每个沙箱都绑定到一个经过验证的 Docker 身份。
  2. 凭证留在宿主机上。Codex 用sbx secret set openai --oauth在浏览器里走 OAuth 流程,令牌保存在操作系统的钥匙串里。
  3. 选一个网络预设。sbx policy init balanced允许 AI 服务和包仓库等常见开发流量,另外两个选项是 deny-all 和 allow-all。
  4. 在项目文件夹里启动代理:sbx run --name my-sandbox claude,或sbx run codex
  5. 观察。sbx ls显示每个沙箱的代理、状态和工作区,直接敲sbx会打开实时控制面板。
  6. 清理。sbx stop my-sandbox保留包和镜像供下次使用;sbx rm my-sandbox删掉里面的一切,宿主机上的工作树原样保留。

网络和文件系统策略

网络策略决定代理能去哪里。先列出规则,再只打开任务需要的地方:sbx policy ls、sbx policy allow network registry.npmjs.org、sbx policy check network api.anthropic.com。sbx policy check会返回 Allowed 或 Denied,让你在代理启动前验证边界。Docker 提醒默认允许列表里含有*.googleapis.com这类宽泛通配符,用不上的要剪掉。

文件系统访问在创建沙箱时设定:直接挂载(sbx run的默认行为)让项目文件夹以读写方式出现在同一绝对路径;复制模式(--clone)把仓库只读挂载,代理在私有副本上工作,适合多个代理处理同一个仓库;不连接模式(不指定路径的sbx create)不共享宿主机的任何东西。面向可复现的团队配置,一个 kit 可以把代理的工具、凭证、网络规则和配置收进一个 YAML 文件。

价格与治理

Docker 的 FAQ 页面说明,sbxCLI 和本地沙箱算力免费,商业用途也算,模型提供商的费用另计。云端沙箱需要 Docker Agentic Platform 订阅,按秒计费。Docker Sandboxes 产品页在 2026 年 11 月 20 日列出的价格是云端沙箱每小时0.07 美元起。云端沙箱默认一小时后到期,且不能挂载宿主机文件夹。组织治理是通过 Docker 销售单独售卖的付费订阅。

Docker AI Governance 是沙箱之上的团队层,Docker 在 11 月 18 日的文章里把它分成三块:沙箱策略,允许或阻止域名、IP 段和端口,控制哪些宿主机路径可以挂载,执行发生在代理和挂载层而不是代理内部;MCP 工具治理,管理员决定哪些 MCP 服务器可以注册、代理可以发起哪些工具调用,策略用 Cedar 编写,未被策略允许的受管请求一律拒绝;审计与可见性,每次策略决策(主体、动作、目标、决策、时间)都有记录,可转发到 SIEM,记录保存的是元数据而不是提示词。

MCP 部分有两个维度。每个沙箱有本地 MCP 网关:用sbx mcp add notion --url https://mcp.notion.com/mcp注册一次服务器,再用--static-mcp notion对单个沙箱开放。本地 stdio 服务器跑在宿主机而不是虚拟机里,所以要当作受信任的宿主机代码对待。面向组织,Docker 售卖 MCP Enterprise Gateway,负责审批服务器、把工具限制到组、记录每次调用。

有一条边界值得记住:代理从沙箱内部直接调用远程 MCP 服务器时,受网络策略约束,而不是 MCP 策略。

在沙箱里用 Apidog CLI 测 API

沙箱让代理改代码而不给你的笔记本带来风险,但代理仍需证明改动对真实 API 有效。先确认沙箱能访问 Apidog 和你的 API,被拒就放行:sbx policy check network api.apidog.com、sbx policy allow network api.apidog.com、sbx policy allow network api.example.com。然后在沙箱内安装并登录:sbx exec -it my-sandbox bash、npm install -g apidog-cli@latest、apidog auth login --with-token、apidog skill install。

Apidog 不在sbx secret set注入的服务之列,所以这个令牌活在虚拟机内部。用一个可以撤销的令牌,完事后用sbx rm删掉沙箱。给代理一条指令,让它为 POST /orders 创建测试用例、断言 201 状态码和响应体里的 id 字段、在指定环境运行并汇总失败。代理会读取负载模式、校验文件、运行场景。网络报错通常意味着允许列表漏了某台主机——那说明沙箱正在履行职责。

几个常见疑问

  • Docker Sandboxes 只是容器吗?不是。它是每个沙箱带独立内核的 microVM,各自运行自己的 Docker Engine,代理可以创建容器而不碰宿主机的守护进程。
  • 免费吗?sbxCLI 和本地算力免费,商业用途也算;云端沙箱每小时 0.07 美元起,模型费用另计,组织治理额外收费。
  • 需要 Docker Desktop 吗?不需要,sbxCLI 可以通过 Homebrew、WinGet 或 Docker 的 Ubuntu 包独立安装。
  • 代理能看到我的 API 密钥吗?OpenAI、Anthropic、GitHub 这类由sbx管理的服务看不到,宿主机代理注入凭证,原始值从不进入虚拟机;你在沙箱里自己装的东西则留在那里。