Docker Sandboxes

安装 sbx CLI，即可在本地或云端沙箱中运行 AI 编程智能体。使用 sbx 不需要 Docker Desktop 或 Docker Engine。云端沙箱需要 0.45.0 或更高版本，才能使用这些 指南中的工作流。

前置条件 ​

操作系统和处理器的要求适用于 CLI 安装。只有运行本地沙箱才需要配置 hypervisor 和 KVM。有关云端账户的要求，请参阅云端沙箱。

macOS ​

  • macOS Sonoma 14 或更高版本
  • Apple 芯片

Windows ​

  • Windows 11
  • 64 位 Intel 或 AMD 处理器
  • 本地沙箱需要 Windows Hypervisor Platform

要运行本地沙箱，请以管理员权限打开 PowerShell 提示符并启用 Windows Hypervisor Platform：

powershell
Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform -All

Linux ​

  • Ubuntu 24.04 或更高版本
  • 64 位 Intel 或 AMD 处理器，或 64 位 Arm 处理器
  • 运行本地沙箱需要 CPU 支持并启用 KVM 硬件虚拟化，并且你的用户账户属于 kvm 组

如果要在虚拟机或虚拟桌面基础设施环境中运行本地沙箱，该环境必须支持嵌套虚拟化。 云端沙箱不需要这项配置。

对于本地沙箱，请确认 KVM 可用：

console
$ lsmod | grep kvm

配置正确时，输出中会显示 kvm_intel、kvm_amd、kvm_arm64 或 kvm。如果输出 为空，运行 kvm-ok 进行诊断。本地沙箱运行时需要 KVM 才能启动。

把你的用户添加到 kvm 组：

console
$ sudo usermod -aG kvm $USER

退出登录后重新登录，或运行 newgrp kvm，让组变更生效。

在 macOS 上安装 ​

使用 Homebrew 安装 sbx：

console
$ brew trust docker/tap
$ brew install docker/tap/sbx

在 Windows 上安装 ​

为当前用户安装 ​

使用 Windows Package Manager 安装 sbx：

powershell
winget install -h Docker.sbx

WinGet 会把按用户安装的 DockerSandboxes.msi 包安装到 %LOCALAPPDATA%\DockerSandboxes， 并把它的 bin 目录加入你的用户 PATH。你无需管理员权限即可安装。

为所有用户安装 ​

对于由管理员统一部署的场景，请从 Docker Sandboxes 发布页下载 DockerSandboxesMachine.msi。在以管理员权限打开的 PowerShell 提示符中静默安装该包：

powershell
msiexec.exe /i DockerSandboxesMachine.msi /quiet

该全机范围的包会安装到 %ProgramFiles%\DockerSandboxes，并把它的 bin 目录加入 系统 PATH。

如果另一个用户会话中的 sbx 守护进程正在使用已安装的文件，全机范围的升级可能 需要重启 Windows。

在 Ubuntu 上安装 ​

NOTE

Docker 不在 Ubuntu 的衍生发行版（如 Linux Mint 和 Pop!_OS）上测试或支持 Docker Sandboxes。便捷脚本在这些发行版上可能会配置错误的软件包仓库。

你可以随 Docker Engine 一起安装 sbx，也可以只安装 sbx 包。

安装 Docker Engine 和 SBX ​

运行 Docker 便捷脚本并带上 SBX=1，即可同时安装 Docker Engine 和 docker-sbx 包：

console
$ curl -fsSL https://get.docker.com | sudo SBX=1 sh

仅安装 SBX ​

如果只想在宿主机上安装 sbx 而不安装 Docker Engine，请添加 Docker 的 apt 仓库并安装 docker-sbx 包：

console
$ curl -fsSL https://get.docker.com | sudo REPO_ONLY=1 sh
$ sudo apt install docker-sbx

从发布产物安装 ​

如需从软件包或归档文件安装 sbx，请遵循 手动安装说明。 Linux 发布产物的存在并不表示 Docker 对相应的发行版做过测试或提供支持。

登录 ​

登录 Docker：

console
$ sbx login

该命令会打开浏览器进行 Docker OAuth 登录。关于为何需要登录以及 Docker 如何处理 你的数据，请参阅常见问题。

登录后，运行你的第一个本地沙箱或 开始使用云端沙箱。