개요
@cloudflare/containers는 Workers 코드에서 Cloudflare Containers를 하나의 TypeScript 클래스와 binding으로 다루게 하는 SDK다. 2025년 public beta를 거쳐 2026년 4월 Containers와 Sandboxes가 GA가 되면서, AI 에이전트·CLI·네이티브 의존성이 필요한 workload의 실행 기반이 됐다.
핵심 기능
- Container instance 시작·중지·수면 시간·lifecycle hook과 요청 proxy·WebSocket forwarding.
- host allow/deny 목록, HTTP/HTTPS outbound interception, Worker binding·Durable Object state 연결.
- 여러 인스턴스에 대한 간단한 load balancing과 컨테이너별 네트워크 정책.
- Sandbox SDK가
@cloudflare/containers위에서 실행 환경을 제공하고, 2026-08-09-github-cloudflare-moltworker는 이를 개인 에이전트 배포에 사용한다.
선택 기준과 한계
컨테이너는 Linux 프로세스·패키지·브라우저·Docker-in-Docker가 필요할 때 유용하지만, 단순한 RPC나 짧은 JavaScript 실행에는 Worker isolate/2026-08-09-github-cloudflare-agents가 더 가볍다. README의 API와 비용·동시성 수치는 계속 변하는 beta/GA 제품 문서를 기준으로 확인해야 하며, 이 노트에서는 배포하지 않았다.
출처
- GitHub 저장소 — Apache-2.0/MIT 라이선스 파일.
- Containers/Sandboxes GA changelog — 2026-04-13.
- 2026-08-09-github-cloudflare-sandbox-sdk · moc-cloudflare-open-source