用途:在 Cloudflare Workers 上托管静态文件、单页应用(SPA),并构建 API 路由与前端合一的混合 Worker。适用于 React/Vue/Angular SPA、静态站点、Next.js/Vite/Remix 构建产物及混合应用。
主要能力:通过 wrangler.jsonc 的 assets.directory 指定静态目录;not_found_handling 支持 single-page-application(404 回退到 index.html)、404-page(返回 /404.html)与 none;binding 默认 ASSETS,可在 Worker 中用 env.ASSETS.fetch(request) 访问;支持修改请求、指定文件、自定义缓存头;可结合 D1 等绑定处理 /api/* 路由。
必要用法:先创建 public 目录并放入 index.html,例如 mkdir public 与 echo "<h1>Hello World</h1>" > public/index.html。基础配置为 "assets": { "directory": "./public/" };SPA 加 "not_found_handling": "single-page-application"。混合应用需设置 main 指向 Worker 入口,并在 fetch 中先处理 /api/ 再回退 env.ASSETS.fetch(request)。本地用 wrangler dev 测试,部署用 wrangler deploy,Worker 与静态资源作为单一单元上传。
限制:资料未提供收费、价格、平台限制或性能数据;具体配置细节可参考 references/configuration.md、references/frameworks.md、references/testing.md。