维护与部署
Cloudflare Pages 部署
Cloudflare Pages 部署
Zudoku 会生成静态 dist 目录；Pages Functions 提供 /proxy/capworks 与 /proxy/openconnector 同源代理，让浏览器 Playground 无需跨域访问 Worker，并避开 Zudoku 自身的 /api/* 文档页面。CapWorks API 通过 Service Binding 转发，OpenConnector 通过服务端 Fetch 转发。
控制台配置
连接这个仓库后使用以下设置：
| 设置 | 值 |
|---|---|
| Root directory | apps/api-docs |
| Build command | bun run build |
| Build output directory | dist |
| Node.js | 26 |
构建脚本会先重新生成全部规范并运行覆盖检查，因此 Pages 不会发布已经漏掉源码路由的文档。
Wrangler 部署
从仓库根目录执行：
Code
首次部署前需要完成 wrangler login，或在 CI 中配置具备 Pages Write 权限的 CLOUDFLARE_API_TOKEN。wrangler.jsonc 必须保留 CAPWORKS_API Service Binding；如文档包含内部接口，建议在自定义域名前启用 Cloudflare Access。
Last modified on