Network access

import asyncio
import urllib.request

from boxlite import SimpleBox

async def main() -> None:
    try:
        # ports=[(host_port, guest_port)]: forward host port 18789 to sandbox port 18789
        async with SimpleBox(
            image="python:alpine",
            name="port-forward-demo",
            ports=[(18789, 18789)],
            reuse_existing=True,
        ) as box:
            print(f"Box started: {box.id}")

            # the service must bind to 0.0.0.0 (not 127.0.0.1):
            # gvproxy forwards host traffic to the sandbox NIC (192.168.127.2), not the sandbox loopback.
            await box.exec(
                "sh", "-c",
                "nohup python -m http.server 18789 --bind 0.0.0.0 > /dev/null 2>&1 &",
            )
            await asyncio.sleep(1)  # wait for the service to come up

            # access from the host
            with urllib.request.urlopen("http://127.0.0.1:18789/", timeout=5) as resp:
                print(f"Host -> guest: HTTP {resp.status}")
    except Exception as exc:  # startup failure / port in use / no virtualization, etc.
        print(f"Failed: {type(exc).__name__}: {exc}")

if __name__ == "__main__":
    asyncio.run(main())

import asyncio

import boxlite
from boxlite import NetworkSpec, SimpleBox

async def main() -> None:
    try:
        # only example.com may be resolved/accessed; all other hosts are sinkholed to 0.0.0.0
        async with SimpleBox(
            image="alpine:latest",
            network=NetworkSpec(mode="enabled", allow_net=["example.com"]),
        ) as box:
            # allowed host -> resolves to a real IP
            allowed = await box.exec("nslookup", "example.com")
            print(f"example.com  exit={allowed.exit_code} (allowed)")

            # disallowed host -> resolves to 0.0.0.0 (blocked)
            blocked = await box.exec("nslookup", "github.com")
            print(f"github.com   exit={blocked.exit_code}")
            print("sinkholed:", "0.0.0.0" in blocked.stdout)
    except Exception as exc:
        print(f"Failed: {type(exc).__name__}: {exc}")

if __name__ == "__main__":
    asyncio.run(main())

// npm install @boxlite-ai/boxlite  (note the package name)
import { SimpleBox } from "@boxlite-ai/boxlite";

async function main(): Promise<void> {
  try {
    // port forwarding: ports is an array of objects { hostPort, guestPort, protocol? }
    // egress allowlist: network = { mode: "enabled", allowNet: [...] }
    const box = new SimpleBox({
      image: "python:alpine",
      name: "net-demo-node",
      reuseExisting: true,
      ports: [{ hostPort: 18790, guestPort: 18790 }],
      network: { mode: "enabled", allowNet: ["example.com"] },
    });

    // likewise must bind to 0.0.0.0
    await box.exec("sh", [
      "-c",
      "nohup python -m http.server 18790 --bind 0.0.0.0 > /dev/null 2>&1 &",
    ]);

    const r = await box.exec("nslookup", ["example.com"]);
    console.log(`example.com exitCode=${r.exitCode}`);

    await box.stop();
  } catch (err) {
    console.error("Failed:", err instanceof Error ? err.message : err);
  }
}

main();