面向 AI 智能体的微虚拟机沙箱,基于写时复制从预热父虚拟机快速 fork 子实例,并支持运行中虚拟机的分支。
jingkaihe/matchlock
基于 Linux 微虚拟机的 CLI 工具,用于隔离运行 AI 智能体,支持网络白名单和宿主机侧密钥注入。
- Star
- 647
- Fork
- 37
- 未关闭 Issue
- 3
- 最近提交
- 20天前
这是什么?
Matchlock 是一个命令行工具,用于在一次性使用的微虚拟机中运行 AI 智能体。每个沙箱都是完整的 Linux 环境,启动时间不到一秒。智能体可以在其中安装软件包、写入文件,而不会影响宿主机。运行结束后虚拟机即被销毁,卷的 overlay 挂载是相互隔离的快照,用完即消失。
使用 --allow-host 或 --secret 参数后,网络默认受限,只有显式允许的主机可以访问。密钥由宿主机上的 TLS MITM 代理在传输过程中注入,沙箱内只能看到占位符,真实凭证不会进入虚拟机。项目还支持长期运行的沙箱、端口转发,以及通过虚拟机内的 BuildKit 从 Dockerfile 构建镜像,并提供 Go、Python 和 TypeScript SDK。
支持 KVM 环境下的 Linux 和 Apple Silicon 上的 macOS,两个平台使用相同的 CLI。项目目前处于实验阶段,接口可能发生破坏性变更。
核心功能
- 01在启动不到一秒的一次性微虚拟机中运行智能体。
- 02网络访问白名单化,只允许列出的主机访问。
- 03通过宿主机侧 TLS MITM 代理注入 API 密钥,密钥不进入虚拟机。
- 04支持长期运行的沙箱,可进行命令执行、进入会话和端口转发。
- 05在虚拟机内使用 BuildKit 从 Dockerfile 构建镜像。
- 06提供 Go、Python 和 TypeScript SDK。
适用场景
- 让 AI 编程智能体执行任意代码,同时不暴露宿主机。
- 在智能体代码中调用第三方大模型 API,且密钥不进入沙箱。
- 在网络出口受限的一次性 Linux 环境中运行不可信脚本。
- 通过 SDK 将隔离的代码执行能力嵌入自己的应用。
快速上手
- 1
添加 Homebrew 软件源
brew tap jingkaihe/essentials - 2
使用 Homebrew 安装 matchlock
brew install matchlock - 3
在临时微虚拟机中运行测试命令
matchlock run --image alpine:latest cat /etc/os-release
使用前须知
- 该项目处于实验阶段,可能有破坏性变更。
- 仅支持带 KVM 的 Linux 和 Apple Silicon 上的 macOS。
- 在 Linux 上,可能需要通过 sudo matchlock setup linux 完成主机配置。
收录于专题
标签
常见问题
- matchlock 是什么?
- 基于 Linux 微虚拟机的 CLI 工具,用于隔离运行 AI 智能体,支持网络白名单和宿主机侧密钥注入。 Matchlock 是一个命令行工具,用于在一次性使用的微虚拟机中运行 AI 智能体。每个沙箱都是完整的 Linux 环境,启动时间不到一秒。智能体可以在其中安装软件包、写入文件,而不会影响宿主机。运行结束后虚拟机即被销毁,卷的 overlay 挂载是相互隔离的快照,用完即消失。
- matchlock 可以免费使用吗?用的什么许可证?
- matchlock 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- matchlock 还在维护吗?
- 活跃维护中。matchlock 最近一次提交是在 2026年10月4日。
- matchlock 适合用来做什么?
- 让 AI 编程智能体执行任意代码,同时不暴露宿主机。 在智能体代码中调用第三方大模型 API,且密钥不进入沙箱。 在网络出口受限的一次性 Linux 环境中运行不可信脚本。 通过 SDK 将隔离的代码执行能力嵌入自己的应用。
- matchlock 怎么安装和运行?
- 添加 Homebrew 软件源: brew tap jingkaihe/essentials 使用 Homebrew 安装 matchlock: brew install matchlock 在临时微虚拟机中运行测试命令: matchlock run --image alpine:latest cat /etc/os-release
- 在哪里获取 matchlock?
- 源代码和安装说明在 GitHub 上:https://github.com/jingkaihe/matchlock
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
基于 Firecracker 微虚拟机的沙箱平台,通过 HTTP API 隔离运行智能体与用户代码。
一个 Linux 命令行工具,可将 Firecracker microVM 的运行资源打包进单个可执行文件,运行时启动虚拟机中的容器。
自托管的基于 Kubernetes 的平台,用轻量虚拟机沙箱安全执行不可信代码,提供 CLI、API 与 Python SDK。
一个轻量的 CLI 和库,在操作系统层面限制任意进程的文件系统与网络访问,无需容器。
基于 OpenVMM 构建、以 Linux 为客户机的超轻量微虚拟机沙箱,用于硬件隔离地运行不可信负载。