CubeSandbox 브라우저 런타임

CubeSandbox에서 browser_use를 위한 단일 프로덕션 이미지 및 템플릿 계약으로, TencentCloud의 다이제스트 고정 sandbox-browser 이미지를 기반으로 합니다. 모든 샌드박스에는 두 가지 워크로드 기능이 모두 포함됩니다:

• UID 1000으로 실행되는 9000 포트의 영구 업스트림 Chromium/CDP와 s6 관리 @playwright/mcp@0.0.79 HTTP 서비스(8931 포트);

• /run/browser-use/runs에 쓰기 가능한 비루트 Run 슈퍼바이저 스토리지와 10000-10001 포트의 Run 소유 헤드리스 Chromium CDP 슬롯 2개.

runtime 타깃에는 RUNTIME_MARKER=sha256:<64자리 소문자 16진수>가 필요합니다. 마커는 /etc/browser-use/runtime-marker에 기록되며 browser_use의 단일 템플릿 ID로 승격된 마커와 일치해야 합니다.

빌드 및 검증

source_digest="$(git archive HEAD | sha256sum | cut -d' ' -f1)"
marker="sha256:$(printf '%s:runtime' "${source_digest}" | sha256sum | cut -d' ' -f1)"

docker build --target runtime --build-arg "RUNTIME_MARKER=${marker}" \
  -t cubesandbox-browser-sandbox .
docker run -d --cap-add=SYS_ADMIN --shm-size=2g --name browser-runtime \
  cubesandbox-browser-sandbox
docker exec --user user browser-runtime browser-sandbox-smoke mcp
docker exec --user user browser-runtime browser-sandbox-smoke run
docker exec --user user browser-runtime browser-sandbox-mcp-smoke

이 절차는 동일한 샌드박스에서 두 개의 동시 Run 소유 Chromium 프로세스가 실행되는 상황에서도 영구 MCP가 유지됨을 증명합니다. SYS_ADMIN은 로컬 Docker에서만 필요하며, Chromium이 샌드박스 네임스페이스를 생성할 수 있도록 하기 위함입니다. CubeSandbox는 배포된 격리를 제공합니다.

의존성과 기본 이미지는 변경 불가능합니다. npm 패키지는 무결성 잠금, Python 검증기 의존성은 해시 잠금, 두 빌드 단계 모두 이미지 다이제스트를 사용하며, 게시 시 SBOM 및 SLSA 출처 증명을 생성하고 Cosign으로 푸시된 다이제스트에 키리스 서명을 수행합니다. Python 잠금 파일은 uv pip compile requirements.in -o requirements.txt --generate-hashes로 재생성합니다.

Related MCP server: agentic-browser-mcp

게시 및 템플릿

워크플로는 ghcr.io/hirotasoshu/cubesandbox-browser-sandbox 아래에 latest, sha-<커밋>, 릴리스 태그를 게시합니다. 승격은 태그를 image@sha256:...로 해석해야 하며, 부동 이미지 참조는 거부됩니다:

scripts/create-template.sh \
  ghcr.io/hirotasoshu/cubesandbox-browser-sandbox@sha256:<digest>

기본 템플릿 별칭은 browser-use-runtime-medium이며, 2 vCPU, 4 GiB RAM, 20 GiB 쓰기 가능 레이어를 제공합니다. envd 49983, 영구 CDP 9000, MCP 8931, Run CDP 슬롯 10000-10001을 노출합니다. Run 포트는 Run이 소유하기 전까지 유휴 상태이므로 시작 프로브는 영구 CDP만 사용합니다.

Cube 트래픽 액세스 토큰이 수신 경계입니다. MCP는 Cube가 트래픽을 전달하기 전에 토큰을 검증하므로 동적 Cube 호스트 이름만 허용합니다. 템플릿 생성 후 공급자 PID 상한과 필수 프라이빗/링크-로컬 이그레스 거부를 구성한 다음 라이브 계약을 실행합니다:

python -m venv .venv
.venv/bin/pip install -r requirements.txt

CUBE_TEMPLATE_ID=<template-id> \
CUBE_RUNTIME_MARKER=sha256:<runtime-marker> \
E2B_API_KEY=<cube-api-key> \
E2B_API_URL=<cube-api-url> \
  .venv/bin/python scripts/verify-template.py

라이브 검사는 보안 샌드박스 하나를 생성하고 두 워크로드를 동시에 검증합니다: 마커 및 파일 API, 공개/비공개 네트워크 정책, 세 브라우저 엔드포인트 모두에서의 인증된 CDP, 트래픽 토큰 거부, 정확한 MCP 도구 정의, MCP 탐색, 안전하지 않은 도구 격리.

최종 승격 권한은 browser_use 공급자 적합성 스위트에 남아 있습니다. 이미지 빌드 성공만으로 프로덕션 모드를 활성화하지 마십시오.

보안

CDP와 Playwright MCP는 브라우저 제어 권한을 부여하며, MCP의 안전하지 않은 도구는 호스트 RCE와 동등합니다. 샌드박스에 애플리케이션 비밀을 주입하지 마십시오. 트래픽 토큰 강제를 활성화된 상태로 유지하고, 변경 불가능한 이미지 및 마커 값만 사용하며, 공급자 PID 한도를 적용하고, 프라이빗/링크-로컬 거부를 요구하십시오.