
Tines 详解 3B 工作流每一步的 gVisor 沙箱机制
来源标题:The anatomy of a Tines gVisor sandbox
Tines 披露其 3B 产品为每个工作流步骤分配全新 gVisor 沙箱并在运行后销毁的机制。每个步骤由含 Dockerfile 的目录定义,程序以 stdin/stdout 交互,运行环境被视为不可信,因此镜像与持久化文件需保存在沙箱之外。文中以 Python 步骤为例,演示其通过 volume 保存 SQLite 数据库并调用威胁情报 API。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
从构建镜像到拆除沙箱,我们如何为每个 3B step 提供一个全新的 Linux 环境。
2026 年 11 月 16 日 · Shayon Mukherjee 现场笔记
在 Tines,我们正在构建 3B,让人们与 agent 协作来自动化企业软件。工作流、内部应用和 agent 都由 step 组成,每个 step 是一个目录,里面有一个 Dockerfile 和一个从 stdin 读取、向 stdout 写入的程序。其结果会成为下一个运行内容的输入。
每次运行都会获得一个全新的 Linux 沙箱,包括一个全新的 gVisor 应用内核,之后我们会将其删除,因为即使程序看起来运行成功,我们也必须将其视为不可信。这意味着它的镜像和持久化文件必须在我们丢弃的环境之外存活下来。
一个 step 会运行由其镜像定义的命令,因此同样的设置可以启动编译好的二进制文件、shell 脚本或语言运行时。在我们的示例中,我们将跟随一个用 Python 编写的 step,它在传入的安全告警中查找 IP 地址,并将结果保存在 SQLite 中,以便后续告警可以复用。它需要在 requirements.txt 中包含 requests,需要一个用于其数据库的卷,以及一个用于威胁情报 API 的连接器。下面的 API 主机名仅作示例。
1
2
3
4
5
6
7
8
FROM python:3.13-slim
WORKDIR /app
COPY requirements.txt ./
RUN --mount=type=cache,target=/root/.cache/pip
pip install -r requirements.txt
COPY --link . .
VOLUME ["alerts"]
CMD ["python", "./script.py"]
enrich-alert/script.pypython
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
import json
import sqlite3
import sys
from urllib.parse import quote
import requests
endpoint = "https://api.threatintel.example/v1/ip"
alert = json.load(sys.stdin)
db = sqlite3.connect("/storage/alerts/seen.db")
db.execute(
"CREATE TABLE IF NOT EXISTS seen "
"(address TEXT PRIMARY KEY, verdict TEXT)"
)
enrichment = {}
for address in alert["addresses"]:
row = db.execute(
"SELECT verdict FROM seen WHERE address = ?",
(address,),
).fetchone()
if row is None:
response = requests.get(
f"{endpoint}/{quote(address, safe='')}",
timeout=10,
)
response.raise_for_status()
verdict = response.json()["verdict"]
db.execute(
"INSERT INTO seen VALUES (?, ?)",
(address, verdict),
)
else:
verdict = row[0]
enrichment[address] = verdict
db.commit()
db.close()
alert["enrichment"] = enrichment
print(json.dumps(alert))
在 3B 中,VOLUME ["alerts"] 声明了一个挂载在 /storage/alerts 的持久化卷。该示例省略了缓存过期,因此缓存的判定结果会一直保留在那里,直到被移除。此外还附加了一个用于威胁情报服务的连接器。不过,它的 API key 不会传递给 Python,因为请求在离开沙箱后,会通过紧邻沙箱外部的代理进行认证。
对于普通容器,Linux 会在宿主内核中处理程序的系统调用,并受到命名空间和 seccomp 的限制。我们使用 gVisor 在一个称为 sentry 的进程中处理这些调用。sentry 用 Go 实现 Linux 接口,拥有自己的任务表、虚拟内存系统和文件系统,并且本身是宿主上的一个非特权进程。
因此,当 Python 请求其 PID 时,sentry 已经在其任务表中有了一个。如果 Python 写入管道,那只是改变了 sentry 中的一个缓冲区。对于网络,我们在每个沙箱的独立网络命名空间中使用宿主机的 TCP/IP 栈,因此连接套接字确实需要一次宿主系统调用。sentry 通过 LisaFS 协议向 gofer(gVisor 独立的文件服务器)请求宿主文件,例如 /etc/resolv.conf。我们还使用 seccomp 限制 sentry 可用的宿主系统调用,从而限制其在被攻破时能做的事情。
GUEST
python script.py
image user, no caps
GUEST KERNEL
sentry
Linux, in Go, as a process
HOST PROCESS
gofer
file server
HOST KERNEL
Linux kernel
host syscalls
seccomp allowlist,
namespaces, cgroup
getpid()
from the sentry’s task table
futex(FUTEX_WAIT)
the thread parks in the sentry
write(pipe)
into a sentry pipe buffer
mmap(anonymous)
its own memory manager
backing pages, when needed
openat("/etc/resolv.conf")
a gofer file
LisaFS request
connect(api:443)
a host socket in its netns
its own connect()
unshare(CLONE_NEWNS)
the step’s filter says no
EPERM
the step’s syscall, handled by the sentry
a host syscall or a request to the gofer
sentry 处理该 step 的系统调用。它向 gofer 发送 LisaFS 请求,并在需要时发起自己的宿主系统调用。
我们使用 gVisor 的 systrap 平台进入 sentry,而无需硬件虚拟化。这对我们的自托管产品很有用,因为在客户环境中并不一定能访问 KVM。
程序运行后,我们不再信任其 sentry 并将其删除,因为成功退出并不能证明程序没有利用其内核。因此,下一次执行会获得另一个 sentry,即使同一个 step 再次运行也是如此。
我们每天在我们称为“worker”的多个实例上运行数百万个 step,每个 worker 都有一个名为 sandboxd 的沙箱守护进程(以前称为 gvisord,名字是对 systemd 的一点致敬)。
在启动池之前,sandboxd 会创建自己的用户和网络命名空间,这样它就可以在那里设置接口和路由,而无需对宿主网络拥有这些权限。然后,每个沙箱都会获得一个独立的网络命名空间,连接到守护进程的网络,其 TCP 流量被定向到我们的代理 Pony。
有了这些,sandboxd 会提前准备一个沙箱池,启动 sentry 和 gofer 并设置网络,以便我们的 runner 可以在其中等待命令。runner 以镜像用户的身份启动镜像配置的命令,并降低权限,因此在我们的示例中它会运行 python ./script.py。该槽位会一直占用,直到沙箱被移除,包括它在 sentry 之外使用的资源。
一个 WORKER,N 个槽位
每个点是一个沙箱
任务到达
准备中
启动沙箱
就绪
尚未运行任何 step
运行中
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。