Paddock：可自托管的 AI 智能体沙箱与 Linux 电脑

Paddock 是干什么的？用通俗的话解释

Paddock 可以理解为“给 AI 智能体配一台专用电脑”的开源软件。你把它安装在自己控制的 VPS 上，再创建一个叫作 Box 的 Linux 环境。Box 里面有项目文件、开发工具和 Ubuntu XFCE 桌面，智能体可以执行命令、编译程序、打开图形应用，并截图检查结果。你既可以把它当作长期保留的工作电脑，也可以只为一次任务创建临时沙箱。

例如，让编程智能体修复一个项目时，它需要的不只是聊天窗口，还需要放代码的目录、安装依赖的地方、运行测试的终端，有时还要打开实际界面。Paddock 负责提供和管理这套执行环境；具体任务仍由你选择的智能体及其模型完成。官网是项目介绍和安装入口，实际使用需要先部署服务器。

从运行代码到检查桌面：智能体能在里面做什么

Box 支持通过 Sysbox 在内部运行 Docker，也提供 SSH、文件传输和桌面访问。Claude Code、Codex、OpenCode、Pi、Prime、Kimi 已预装，但对应服务的登录或模型认证仍需自行配置，预装工具不代表附赠模型额度。

你可以通过 paddock prompt 下发任务，也能直接执行命令、查看后台任务日志。需要检查图形界面时，先用 paddock desktop 打开桌面，再用 exec --desktop 启动应用，最后通过 paddock screenshot 保存截图。这条路径适合查看智能体生成的程序是否真的打开、布局是否符合预期。

除了命令行，Paddock 还有浏览器管理面板、HTTP API，以及 TypeScript 和 Python SDK。个人开发者可以手动管理 Box；已有自动化系统的团队则可以把环境创建和任务执行接进自己的代码。

如何部署，并完成一次项目测试

官方安装指南要求准备 Ubuntu 或 Debian VPS、root 权限、amd64 或 arm64 架构，以及开放的 80、443 端口。还需要一个指向服务器的域名，也可按文档使用 sslip.io 主机名。CPU 和内存应按实际并发工作量安排，不能把“可以创建多个 Box”理解为任意配置都能无限运行。

安装程序会配置服务器及相关组件。安装完成后，打开它输出的一次性所有者设置链接创建账号，再在自己的电脑安装 CLI、登录服务器；文档提供 macOS、Linux 和 Windows 客户端的安装方式。若希望受支持的编程智能体直接管理 Box，还可以安装 Paddock skill。

下面是官方文档支持的一次 Node 项目测试路径：先创建一小时自动停止的 Box，将本地项目放入指定目录，再执行项目测试，最后停止环境。

paddock new --type small --ttl 3600
paddock push current . --to /config/project
paddock exec current -- bash -lc 'cd /config/project && npm test'
paddock stop current

执行后应阅读测试输出，确认通过还是失败。项目需要已有可用的测试脚本和依赖；若尚未安装依赖，需要先在允许访问相应软件源的网络策略下完成安装。上面的 stop 会先保存文件系统快照再停止 Box。临时环境删除前，应通过 pull 取回需要的代码或产物。

网络限制怎么设置，哪些数据仍可能离开服务器

Paddock 提供 allow-all、deny-all 和域名／IPv4 网段允许列表。需要特别注意，新建 Box 默认使用 allow-all；只有主动指定限制策略，才会收紧出站网络。deny-all 阻止新的出站连接，已有连接可能继续完成；云元数据地址在各模式下都会被阻止访问。

实际使用允许列表时，要考虑模型 API、代码仓库和软件包注册表。完全禁网的 Box 无法凭空下载依赖，也无法调用远程模型。自托管意味着执行环境位于你控制的服务器上，但你主动发送给外部模型服务的内容，仍受该服务的数据处理规则约束。不能据此承诺所有数据绝不外传，或保证防住任何沙箱逃逸。

快照回滚、长期工作环境和持久化磁盘

Paddock 支持停止、恢复、fork 和还原快照，适合保留工作进度、从一个环境派生新任务，或在修改出问题时退回之前的文件状态。挂载在 /mnt 下的命名磁盘，可以在 Box 删除后继续保留数据，用来复用缓存、资料和输入文件。

不过，官方快照文档明确说明，快照保存的是文件系统状态，不包含内存、正在运行的进程、Box 内的 /var/lib/docker，也不包含挂载磁盘的数据。因此，“恢复 Box”不等于让程序从暂停时的同一条指令继续运行；磁盘里的重要数据也需要另行规划备份。

开源免费到什么程度，适合哪些人

截至 2026 年 10 月 29 日核实，Paddock 采用 MIT 许可证。已检查的官网和文档未提供 Paddock 托管订阅套餐表。软件开源与运行成本是两个层面：VPS、存储、流量及所接模型服务仍可能产生费用，应按自己选择的服务计算，不能套用一个统一月费。

它适合希望控制编程智能体工作环境、需要桌面检查和快照回滚、并能维护 Linux 服务器的开发者或技术团队。选择前也应计入安装、升级、访问权限和备份的维护投入。

常见问题

Paddock 免费吗？是否开源？

项目以 MIT 许可提供源码，所核实资料没有要求购买软件订阅。但自备服务器和外部 AI 服务的费用不会因此消失，预装智能体也不包含相应模型的免费额度。

可以从 Windows 或 macOS 使用吗？

可以，官方提供这两类系统的 CLI 安装方式。客户端平台和服务器平台要分开看：服务器仍需满足文档规定的 Ubuntu 或 Debian 等 Linux 部署条件。

创建沙箱后就会自动断网吗？

不会，默认是 allow-all。需要明确设置 deny-all 或允许列表，并检查任务所需的模型端点、仓库和依赖下载源是否可达。

官方资源与开发者资料

• Paddock 官方开源仓库：查看源码、实现细节和完整技术参考。
• 版本发布与客户端下载：获取可用二进制文件和版本说明。