Repolode
jingkaihe

jingkaihe/matchlock

네트워크 허용 목록과 호스트 측 시크릿 주입을 지원하는 Linux 기반 CLI로, AI 에이전트를 임시 microVM에서 실행합니다.

스타
647
포크
37
열린 이슈
3
마지막 커밋
20일 전

어떤 프로젝트인가요?

Matchlock은 AI 에이전트를 폐기 가능한 microVM 안에서 실행하는 명령줄 도구입니다. 각 샌드박스는 1초 이내에 부팅되는 완전한 Linux 환경이므로, 에이전트가 호스트 머신에 영향을 주지 않고 패키지를 설치하고 파일을 작성할 수 있습니다. 실행이 끝나면 VM은 폐기되며, 볼륨 오버레이 마운트는 격리된 스냅샷으로 생성되어 이후 사라집니다.

--allow-host 또는 --secret을 지정하면 기본적으로 네트워크 접근이 제한되어, 명시적으로 나열한 호스트에만 연결할 수 있습니다. 시크릿은 호스트의 TLS MITM 프록시를 통해 주입되므로 샌드박스에는 플레이스홀더 값만 보이고 실제 자격 증명은 VM에 들어가지 않습니다. 또한 장시간 실행되는 샌드박스와 포트 포워딩, VM 내부에서 BuildKit을 통한 Dockerfile 기반 이미지 빌드, Go·Python·TypeScript SDK도 지원합니다.

Linux에서는 KVM을, Apple Silicon을 탑재한 macOS에서는 해당 환경을 사용해 실행되며 두 플랫폼에서 동일한 CLI를 사용할 수 있습니다. 이 프로젝트는 실험 단계로 표시되어 있으며, 호환성을 깨는 변경이 있을 수 있습니다.

핵심 기능

  • 011초 이내에 부팅되는 임시 microVM에서 에이전트를 실행합니다.
  • 02네트워크 접근을 허용 목록으로 제한해 나열된 호스트에만 연결할 수 있습니다.
  • 03호스트 측 TLS MITM 프록시를 통해 API 키를 주입해 시크릿이 VM에 들어가지 않도록 합니다.
  • 04exec, attach, 포트 포워딩을 지원하는 장시간 실행 샌드박스를 제공합니다.
  • 05VM 내부에서 BuildKit을 사용해 Dockerfile 기반 이미지를 빌드합니다.
  • 06Go, Python, TypeScript SDK를 제공합니다.

활용 사례

  • 호스트 머신을 노출하지 않고 AI 코딩 에이전트가 임의의 코드를 실행하도록 합니다.
  • 키를 샌드박스 안에 두지 않고 에이전트 코드에서 서드파티 LLM API를 호출합니다.
  • 송신 트래픽이 제한된 폐기 가능한 Linux 환경에서 신뢰할 수 없는 스크립트를 실행합니다.
  • SDK를 통해 격리된 코드 실행 기능을 애플리케이션에 통합합니다.

빠른 시작

  1. 1

    Homebrew 저장소를 탭합니다

    brew tap jingkaihe/essentials
  2. 2

    Homebrew로 matchlock을 설치합니다

    brew install matchlock
  3. 3

    임시 microVM에서 테스트 명령을 실행합니다

    matchlock run --image alpine:latest cat /etc/os-release

사용 전 알아둘 점

  • 이 프로젝트는 실험 단계이며 호환성을 깨뜨리는 변경이 있을 수 있습니다.
  • KVM을 사용하는 Linux와 Apple Silicon 기반 macOS만 지원합니다.
  • Linux에서는 호스트 설정을 위해 sudo matchlock setup linux를 실행해야 할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

matchlock은(는) 무엇인가요?
네트워크 허용 목록과 호스트 측 시크릿 주입을 지원하는 Linux 기반 CLI로, AI 에이전트를 임시 microVM에서 실행합니다. Matchlock은 AI 에이전트를 폐기 가능한 microVM 안에서 실행하는 명령줄 도구입니다. 각 샌드박스는 1초 이내에 부팅되는 완전한 Linux 환경이므로, 에이전트가 호스트 머신에 영향을 주지 않고 패키지를 설치하고 파일을 작성할 수 있습니다. 실행이 끝나면 VM은 폐기되며, 볼륨 오버레이 마운트는 격리된 스냅샷으로 생성되어 이후 사라집니다.
matchlock은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
matchlock은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
matchlock은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. matchlock의 마지막 커밋은 2026년 10월 4일입니다.
matchlock은(는) 어디에 사용할 수 있나요?
호스트 머신을 노출하지 않고 AI 코딩 에이전트가 임의의 코드를 실행하도록 합니다. 키를 샌드박스 안에 두지 않고 에이전트 코드에서 서드파티 LLM API를 호출합니다. 송신 트래픽이 제한된 폐기 가능한 Linux 환경에서 신뢰할 수 없는 스크립트를 실행합니다. SDK를 통해 격리된 코드 실행 기능을 애플리케이션에 통합합니다.
matchlock는 어떻게 설치하나요?
Homebrew 저장소를 탭합니다: brew tap jingkaihe/essentials Homebrew로 matchlock을 설치합니다: brew install matchlock 임시 microVM에서 테스트 명령을 실행합니다: matchlock run --image alpine:latest cat /etc/os-release
matchlock은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jingkaihe/matchlock

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트