Repolode
jingkaihe

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. 1

    添加 Homebrew 软件源

    brew tap jingkaihe/essentials
  2. 2

    使用 Homebrew 安装 matchlock

    brew install matchlock
  3. 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 数据每日更新。

相关项目