Repolode
anthropics

anthropics/sandbox-runtime

컨테이너 없이 OS 수준에서 임의의 프로세스의 파일 시스템 및 네트워크 접근을 제한하는 경량 CLI이자 라이브러리입니다.

스타
6,425
포크
562
열린 이슈
300
마지막 커밋
7시간 전

어떤 프로젝트인가요?

srt는 AI 에이전트, 로컬 MCP 서버, bash 명령 또는 다른 프로세스와 같은 임의의 명령을 감싸서 읽기, 쓰기 및 연결할 수 있는 대상을 제한합니다. macOS에서는 생성된 Seatbelt 프로파일과 함께 sandbox-exec를 사용하고, Linux에서는 네트워크 네임스페이스와 함께 bubblewrap을 사용합니다. Windows에서는 전용 로컬 계정으로 프로세스를 실행하고 Windows Filtering Platform 이그레스 펜스를 적용합니다.

네트워크 접근은 기본적으로 차단됩니다. 허용된 트래픽은 호스트의 HTTP 및 SOCKS5 프록시를 거치며, 프록시가 도메인 허용 목록과 차단 목록을 적용합니다. 파일 시스템 규칙은 읽기에 대해 차단 후 허용 모델을, 쓰기에 대해서는 허용 전용 모델을 사용합니다. 두 플랫폼 모두 Unix 소켓 접근은 기본적으로 차단됩니다.

이 패키지는 명령줄에서 `srt`로 사용하거나 SandboxManager가 포함된 TypeScript 라이브러리로 가져와 사용할 수 있습니다. 설정 파일, macOS의 위반 보고, 런타임 설정 채널도 지원합니다.

핵심 기능

  • 01모든 프로세스 트리의 파일 시스템 읽기 및 쓰기를 제한합니다
  • 02호스트 측 프록시를 통해 도메인 허용 목록과 차단 목록을 적용합니다
  • 03macOS에서는 sandbox-exec를, Linux에서는 bubblewrap을 사용합니다
  • 04Unix 소켓 접근을 기본적으로 차단합니다
  • 05CLI와 TypeScript 라이브러리 API를 모두 제공합니다

활용 사례

  • AI 코딩 에이전트가 SSH 키를 읽거나 임의의 호스트에 접속하지 못하도록 샌드박싱합니다
  • 로컬 MCP 서버가 특정 디렉터리와 네트워크 대상에만 접근하도록 제한합니다
  • 신뢰할 수 없는 bash 명령이나 빌드 스크립트를 제한된 접근 권한으로 실행합니다

빠른 시작

  1. 1

    npm으로 패키지를 전역 설치합니다

    npm install -g @anthropic-ai/sandbox-runtime
  2. 2

    샌드박스 내에서 명령을 실행합니다

    srt "curl example.com"

사용 전 알아둘 점

  • 베타 연구 프리뷰이며 API와 구성 형식은 변경될 수 있습니다.
  • macOS의 sandbox-exec, Linux의 bubblewrap 같은 OS 프리미티브에 의존하며, Linux에서는 bubblewrap을 설치해야 합니다.
  • Windows 지원에는 프로세스 토큰 및 시스템 서비스와 관련해 문서화된 알려진 제한 사항이 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

sandbox-runtime은(는) 무엇인가요?
컨테이너 없이 OS 수준에서 임의의 프로세스의 파일 시스템 및 네트워크 접근을 제한하는 경량 CLI이자 라이브러리입니다. srt는 AI 에이전트, 로컬 MCP 서버, bash 명령 또는 다른 프로세스와 같은 임의의 명령을 감싸서 읽기, 쓰기 및 연결할 수 있는 대상을 제한합니다. macOS에서는 생성된 Seatbelt 프로파일과 함께 sandbox-exec를 사용하고, Linux에서는 네트워크 네임스페이스와 함께 bubblewrap을 사용합니다. Windows에서는 전용 로컬 계정으로 프로세스를 실행하고 Windows Filtering Platform 이그레스 펜스를 적용합니다.
sandbox-runtime은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
sandbox-runtime은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
sandbox-runtime은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. sandbox-runtime의 마지막 커밋은 2026년 10월 24일입니다.
sandbox-runtime은(는) 어디에 사용할 수 있나요?
AI 코딩 에이전트가 SSH 키를 읽거나 임의의 호스트에 접속하지 못하도록 샌드박싱합니다 로컬 MCP 서버가 특정 디렉터리와 네트워크 대상에만 접근하도록 제한합니다 신뢰할 수 없는 bash 명령이나 빌드 스크립트를 제한된 접근 권한으로 실행합니다
sandbox-runtime는 어떻게 설치하나요?
npm으로 패키지를 전역 설치합니다: npm install -g @anthropic-ai/sandbox-runtime 샌드박스 내에서 명령을 실행합니다: srt "curl example.com"
sandbox-runtime은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/anthropics/sandbox-runtime

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

관련 프로젝트