第3章 v0 沙箱(Sandbox)详解
SandboxVM 支持的聊天运行在一个隔离的虚拟机中,该虚拟机托管你的项目文件、运行聊天中看到的实时预览,并代表你执行命令。一个聊天的状态绝不会泄露到另一个聊天中。
什么是沙箱 v0 的沙箱由 Vercel Sandbox 提供支持,这是一个轻量级虚拟机,可以在几秒内运行完整的 Node.js 环境。它取代了旧的基于浏览器的预览方式——后者无法运行服务端代码、API 路由或真实的数据库连接。由于沙箱运行真实的 Node.js 环境,预览的表现与项目部署到 Vercel 后完全一致。
在哪里可以看到沙箱 在 VM 支持的聊天中,沙箱出现在三个地方:
预览标签页:应用在沙箱中的运行效果。沙箱内的 dev server 提供该 URL 的服务。 控制台面板:包含 Logs 标签页(dev server 的输出)和 Terminal 标签页(一个 shell,除了 v0 通过 Bash 工具执行的命令外,你也可以直接在这里运行命令)。 代码查看器:浏览和编辑工作区文件,并添加代码注释作为下一次提示的上下文。参见 Code viewer。
沙箱里运行着什么 每个沙箱都包含:
Node.js,开箱即用支持 pnpm、npm、yarn 和 bun。你可以安装项目所需的任何依赖。 感知框架的 dev server。v0 会检测 Next.js、Vite 以及通用 Node.js 项目,并在正确的端口上启动相应的命令。 来自你已连接 Vercel 项目的环境变量,供你的应用和沙箱中运行的任何 agent 工具使用。
v0 的 Bash 工具和预装的 agent 也是在同样的环境中运行的。
隔离边界 沙箱沿三个维度进行隔离: 边界含义按聊天隔离每个 VM 支持的聊天都有自己的沙箱。文件、环境变量和运行中的进程绝不会跨聊天共享。按用户或团队隔离沙箱归属于聊天的所有者。除非你分享该聊天,否则其他用户无法访问。与生产环境隔离沙箱绝不会与部署的应用在同一台机器上。部署运行在独立的 Vercel 基础设施上,拥有各自的环境变量。
在这些边界之上,Sandbox Network Policy 控制沙箱可以访问哪些外部主机。默认是全部允许。团队所有者可以在团队设置中进行配置。
生命周期 对于 VM 支持的聊天,v0 会在聊天首次需要沙箱时创建一个,例如当你生成需要服务器的代码或导入仓库时。
此后:
文件系统在同一聊天的多次会话之间持久保存。你或 v0 写入的文件在你之后回来时仍然存在。 从沙箱池中获取的沙箱初始有效期为 30 分钟。这是 v0 分配或认领沙箱时设置的初始超时,并不是你能工作的最长时间。 活跃运行中的沙箱会自动延长。状态检查和 agent 的 keep-alive 心跳会在沙箱剩余时间不足五分钟时增加 10 分钟。 沙箱从创建起最多运行 24 小时。自动延长绝不会突破这个绝对上限。 不活跃或已停止的沙箱不会被 keep-alive 复活。在你下次访问或操作时,v0 会在沙箱仍可用时复用它,如果已过期则重新创建。你无需手动启动或停止沙箱。 开启新的 VM 支持的聊天会创建新的沙箱。状态不会从旧聊天延续过来,除非你明确地进行 fork 或导入。
了解 v0 如何在沙箱中运行命令PreviousAgentic featuresNextVercel Integration