概要
公開日: 2026-05-29
翻訳生成に失敗したため、原文をそのまま保存しています。
原文
Changelog New updates and improvements at Cloudflare. Subscribe to RSS View RSS feeds ← Back to all posts Share sandbox previews through Cloudflare Tunnel May 29, 2026 Agents Sandboxes can expose a service running inside the container on a public preview URL through the sandbox.tunnels namespace. The SDK uses cloudflared inside the sandbox so you can share a running service without configuring exposePort() or a custom domain. By default, sandbox.tunnels.get(port) creates a quick tunnel ↗ on a zero-config *.trycloudflare.com URL — no Cloudflare account, DNS record, or custom domain required. This is perfect for quick development and for .workers.dev deployments. JavaScript TypeScript JavaScript import { getSandbox } from "@cloudflare/sandbox" ; const sandbox = getSandbox ( env . Sandbox , "my-sandbox" ) ; await sandbox . startProcess ( "python -m http.server 8080" ) ; const tunnel = await sandbox . tunnels . get ( 8080 ) ; console . log ( tunnel . url ) ; // → https://random-words-here.trycloudflare.com TypeScript import { getSandbox } from "@cloudflare/sandbox" ; const sandbox = getSandbox ( env . Sandbox , "my-sandbox" ) ; await sandbox . startProcess ( "python -m http.server 8080" ) ; const tunnel = await sandbox . tunnels . get ( 8080 ) ; console . log ( tunnel . url ) ; // → https://random-words-here.trycloudflare.com Named tunnels For more control you can create a named tunnel through sandbox.tunnels.get(port, { name }) . A named tunnel binds a hostname ( <name>.<your-zone> ) backed by a Cloudflare Tunnel and a CNAME record on your zone resulting in something like https://my-app-preview.example.com ↗ . Unlike quick tunnels, which generate a new random URL each time, a named tunnel produces a persistent URL that survives container restarts. This makes named tunnels suitable for production use cases where you want control over the tunnel and it's origin. JavaScript TypeScript JavaScript const tunnel = await sandbox . tunnels . get ( 8080 , { name : "my-app-preview" } ) ; console . log ( tunnel . url ) ; // → https://my-app-preview.example.com TypeScript const tunnel = await sandbox . tunnels . get ( 8080 , { name : "my-app-preview" } ) ; console . log ( tunnel . url ) ; // → https://my-app-preview.example.com Calling sandbox.destroy() tears down the Cloudflare Tunnel and the associated DNS record alongside the container, so you do not leave dangling tunnels or records behind. Upgrade To update to the latest version: npm yarn pnpm bun npm i @cloudflare/sandbox@latest yarn add @cloudflare/sandbox@latest pnpm add @cloudflare/sandbox@latest bun add @cloudflare/sandbox@latest For full API details, refer to the Sandbox tunnels reference . Resources API New to Cloudflare? Directory Sponsorships Open Source Cloudflare Research Support Help Center System Status Compliance GDPR Company cloudflare.com Our team Careers Tools Cloudflare Radar Cloudflare Labs Speed Test Is BGP Safe Yet? Certificate Transparency Community Community forum X Discord YouTube GitHub © 2026 Cloudflare, Inc. Privacy Policy Terms of Use Report Security Issues Trademark Cookie Settings Was this helpful? Yes No