Cloudflare Container Isolator - Docker-based code execution server
npm install @sandboxxjs/cloudflare-isolatorDocker-based code execution server for SandboX.
A standalone HTTP server (compiled to binary) that executes code in Docker containers.
Used by CloudflareContainerIsolator in sandboxjs.
``bash
npm install @sandboxxjs/cloudflare-isolator
$3
`typescript
import { createSandbox } from "@sandboxxjs/sandbox";const sandbox = createSandbox({
runtime: "node",
isolator: "cloudflare", // Automatically starts cloudflare-isolator
});
`API
$3
Execute code in Docker container.
Request:
`json
{
"code": "console.log('hello')",
"runtime": "node",
"env": { "NODE_ENV": "production" },
"timeout": 30000
}
`Response:
`json
{
"success": true,
"stdout": "hello",
"stderr": "",
"exitCode": 0,
"metadata": {
"executionTime": 450,
"timestamp": "2026-01-15T19:00:00.000Z"
}
}
`$3
Health check.
Response:
`json
{
"status": "ok",
"runtime": "bun"
}
`Deployment to Cloudflare
`bash
Deploy to Cloudflare Workers + Containers
cd services/cloudflare-isolator
bun run deploy
`Supported Runtimes
-
node - Node.js 22
- python - Python 3.11
- bash` - Alpine Linux- Docker (for local execution)
- Cloudflare account (for cloud deployment)
MIT