Skip to content
KitploitKITPLOIT
工具漏洞利用博客
Log in
提交
工具漏洞利用博客
提交

黑客、渗透测试和网络安全工具,武装您的安全武器库!

Kitploit 是一个黑客、网络安全和渗透测试工具的目录。发现最新的项目更新,查找漏洞、分析系统、自动化测试并加强你的安全。

订阅源联系隐私© 2026 Kitploit

工具目录

分类

查看所有分类
Loading categories
工具/GitHubGitHub/jingkaihe/matchlock
容器安全安全虚拟化网络安全云安全DevSecOps秘密检测API 安全AI 安全
GitHubjingkaihe/matchlock

matchlock

用于AI代理的临时微VM沙箱,支持网络白名单、通过MITM代理注入密钥以及VM级隔离。启动时间不到一秒,支持Go/Python/TypeScript SDK。

查看仓库
61137658天前Kitploit 审核通过
分享

Matchlock

实验性: 本项目仍在积极开发中,可能会有破坏性变更。

Matchlock 是一个 CLI 工具,用于在临时 microVM 中运行 AI 代理——具备网络允许列表、通过 MITM 代理进行密钥注入以及 VM 级隔离。你的密钥永远不会进入 VM。

为什么选择 Matchlock?

AI 代理需要运行代码,但让它们不受限制地访问你的机器是一种风险。Matchlock 让你可以交给代理一个完整的 Linux 环境,它能在不到一秒内启动——隔离且可丢弃。

当你传入 --allow-host 或 --secret 时,Matchlock 会封闭网络——只有发往明确允许的主机的流量才能通过,其他一切都被阻止。当你的代理调用 API 时,真实凭据由主机在传输过程中注入。沙箱只能看到占位符。即使代理被骗去运行恶意内容,你的密钥也不会泄露,数据也无处可去。在内部,代理获得一个完整的 Linux 环境来做它需要做的任何事情。它可以安装软件包、写入文件、把一切弄得一团糟。主机目录永远不会与客户机共享:显式提供输入,并通过客户机文件 API 获取输出。除非你挂载持久块卷,否则客户机本地的更改都是可丢弃的。无论你是在 Linux 服务器还是 MacBook 上,CLI 和行為都相同。

快速开始

系统要求

  • Linux,支持 KVM
  • macOS,运行于 Apple Silicon

安装

完整安装详情请参阅 docs/install.md。

快速安装

下面的脚本会检测操作系统,并在 macOS 上使用 Homebrew 安装 matchlock,在 Debian/RHEL 系 Linux 发行版上使用 rpm/deb 安装

curl -fsSL https://raw.githubusercontent.com/jingkaihe/matchlock/main/scripts/install.sh | bash

# Or install a specific release
curl -fsSL https://raw.githubusercontent.com/jingkaihe/matchlock/main/scripts/install.sh | bash -s -- --version 0.2.4

Homebrew

macOS 和 Linux 均支持基于 Homebrew 的安装:

brew tap jingkaihe/essentials
brew install matchlock

Debian / Ubuntu (.deb)

sudo dpkg -i ./matchlock_<version>_linux_amd64.deb
sudo apt-get install -f
matchlock diagnose

Fedora / RHEL / CentOS Stream (.rpm)

sudo dnf install ./matchlock_<version>_linux_amd64.rpm
matchlock diagnose

如果 matchlock diagnose 报告缺少主机设置,请运行:

sudo matchlock setup linux

要显式注册特定用户,请运行:

sudo matchlock setup user <name>

用法

# Basic
matchlock run --image alpine:latest cat /etc/os-release
matchlock run --image alpine:latest -it sh
matchlock run --image alpine:latest --no-network -- sh -lc 'echo offline'

# Network allowlist
matchlock run --image python:3.12-alpine \
  --allow-host "api.openai.com" python agent.py

# Keep interception enabled even with an empty allowlist,
# so hosts can be added/removed at runtime.
matchlock run --image alpine:latest --rm=false --network-intercept
matchlock allow-list add <vm-id> api.openai.com,api.anthropic.com
matchlock allow-list delete <vm-id> api.openai.com

# Secret injection (never enters the VM)
export ANTHROPIC_API_KEY=sk-xxx
matchlock run --image python:3.12-alpine \
  --secret [email protected] python call_api.py

# Long-lived sandboxes
matchlock run --image alpine:latest --rm=false   # prints VM ID
matchlock run --image nginx:latest -d             # same as above, detached
matchlock exec vm-abc12345 -it sh                # attach to it
matchlock port-forward vm-abc12345 8080:8080     # forward host:8080 -> guest:8080

# Publish ports at startup
matchlock run --image alpine:latest --rm=false -p 8080:8080

# Lifecycle
matchlock list | kill | rm | prune

# Build from Dockerfile (uses BuildKit-in-VM)
matchlock build -f Dockerfile -t myapp:latest .

# Pull a registry image (caches for faster startup)
matchlock pull alpine:latest

# Image management
matchlock image ls                                           # List all images
matchlock image rm myapp:latest                              # Remove a local image
docker save myapp:latest | matchlock image import myapp:latest  # Import from tarball

文件与构建

Matchlock 不支持宿主机目录挂载或文件系统拦截。请使用 matchlock cp、run --copy-in / --copy-out,或 SDK 的复制与文件 API 显式地复制文件进出。文件系统操作在原生客户机存储上进行。如需持久化存储,请使用 matchlock volume 配合 run --disk @name:/guest/path。参见迁移指南。

# Copy ./src in, run the build, and copy the results out
matchlock run --image alpine:latest --copy-in ./src/.:/workspace --copy-out /workspace/dist:./dist -w /workspace -- make

# Copy files to and from a running sandbox
matchlock cp ./src/. vm-abc12345:/workspace
matchlock cp vm-abc12345:/workspace/dist ./dist

matchlock build 在 VM 内运行 BuildKit,并将结果导入本地镜像存储。构建上下文会被复制到 VM 中,并遵循 .dockerignore 和 Dockerfile 专用的忽略文件,因此 --build-disk 必须足够大以容纳它。构建缓存在多次构建之间持久保留,且不与 VM 共享任何主机目录。

SDK

Matchlock 提供 Go、Python 和 TypeScript SDK,用于将沙箱直接嵌入你的应用程序。你可以通过编程方式启动 VM、执行命令、流式传输输出并管理文件。

Go

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/jingkaihe/matchlock/pkg/sdk"
)

func main() {
	ctx := context.Background()

	client, err := sdk.NewClient(sdk.DefaultConfig())
	if err != nil {
		panic(err)
	}
	defer client.Close(0)
	defer client.Remove()

	sandbox := sdk.New("alpine:latest").
		AllowHost("dl-cdn.alpinelinux.org", "api.anthropic.com").
		AddSecret("ANTHROPIC_API_KEY", os.Getenv("ANTHROPIC_API_KEY"), "api.anthropic.com")
	if _, err := client.Launch(sandbox); err != nil {
		panic(err)
	}
	if _, err := client.Exec(ctx, "apk add --no-cache curl"); err != nil {
		panic(err)
	}
	// The VM only ever sees a placeholder - the real key never enters the sandbox
	result, err := client.Exec(ctx, "echo $ANTHROPIC_API_KEY")
	if err != nil {
		panic(err)
	}
	fmt.Print(result.Stdout) // prints "SANDBOX_SECRET_a1b2c3d4..."

	curlCmd := `curl -s --no-buffer https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"claude-haiku-4-5-20251001","max_tokens":1024,"stream":true,
       "messages":[{"role":"user","content":"Explain TCP to me"}]}'`
	if _, err := client.ExecStream(ctx, curlCmd, os.Stdout, os.Stderr); err != nil {
		panic(err)
	}
}

Go SDK 私有 IP 行为(10/8、172.16/12、192.168/16):

  • 默认(未设置):只要发送了网络配置,私有 IP 就会被阻止。
  • 显式阻止:调用 .WithBlockPrivateIPs(true)(或 .BlockPrivateIPs())。
  • 显式允许:调用 .AllowPrivateIPs() 或 .WithBlockPrivateIPs(false)。
sandbox := sdk.New("alpine:latest").
	AllowHost("api.openai.com").
	AddHost("api.internal", "10.0.0.10").
	WithNetworkMTU(1200).
	AllowPrivateIPs() // explicit override: block_private_ips=false

// SDK network interception (request/response mutation, body shaping, SSE data-line transform)
sandbox = sandbox.WithNetworkInterception(&sdk.NetworkInterceptionConfig{
	Rules: []sdk.NetworkHookRule{
		{
			Phase:      sdk.NetworkHookPhaseBefore,
			Action:     sdk.NetworkHookActionMutate,
			Hosts:      []string{"api.openai.com"},
			SetHeaders: map[string]string{"X-Trace-Id": "trace-123"},
		},
		{
			Phase:  sdk.NetworkHookPhaseAfter,
			Action: sdk.NetworkHookActionMutate,
			Hosts:  []string{"api.openai.com"},
			BodyReplacements: []sdk.NetworkBodyTransform{
				{Find: "internal-id", Replace: "redacted"},
			},
		},
	},
})

如果直接使用 client.Create(...)(不通过 builder),请设置:

  • BlockPrivateIPsSet: true
  • BlockPrivateIPs: false(或 true)

对于完全离线的沙箱(无 guest NIC / 无出站流量),请使用:

  • CLI:--no-network
  • Go SDK builder:.WithNoNetwork()
  • Python SDK builder:.with_no_network()
  • TypeScript SDK builder:.withNoNetwork()

Python(PyPI)

pip install matchlock
# or
uv add matchlock
import os
import sys

from matchlock import Client, Sandbox

sandbox = (
    Sandbox("python:3.12-alpine")
    .allow_host(
        "dl-cdn.alpinelinux.org",
        "files.pythonhosted.org", "pypi.org",
        "astral.sh", "github.com", "objects.githubusercontent.com",
        "api.anthropic.com",
    )
    .add_secret(
        "ANTHROPIC_API_KEY", os.environ["ANTHROPIC_API_KEY"], "api.anthropic.com"
    )
)

SCRIPT = """\
# /// script
# requires-python = ">=3.12"
# dependencies = ["anthropic"]
# ///
import anthropic, os

client = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])
with client.messages.stream(
    model="claude-haiku-4-5-20251001",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain TCP/IP."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
print()
"""
下载工具

最受欢迎

查看全部 →

发现我们社区最常用的工具。

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 终极 OSINT 工具包:调查图谱、置信度评分、别名家族、地图、时间线和报告。49 个模块、400+ 个站点,无需 API 密钥。

    696
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock 一键执行应用(CVE-2026-43499)

    499
  • 3

    ARTEX

    baarai/artex

    基于LLM的多智能体自主渗透测试平台,具备规划器/执行器智能体、资产与探索图谱、MITM流量记录以及漏洞复测功能。

    396
  • 4

    redforge

    cybersecurity91/redforge

    浏览器端红队工具包,包含 102 个离线工具,用于侦察、载荷生成、凭据攻击、加密、编码和交战报告。

    340
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AI原生网络安全的行动系统——在这里,意图转化为受治理的执行,证据沉淀为运营记忆,每一次操作都让下一次更出色。

    258
  • 6

    antifox

    antifox-ai/antifox

    AI multi-agent autonomous penetration testing platform that runs recon, attack-surface discovery, exploitation validation and evidence-backed report delivery.

    257

探索所有工具

浏览我们的工具集合

查看所有工具 →