# 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 部署

从仓库根目录执行：

```bash
bun run build:docs
bun run --cwd apps/api-docs deploy:pages
```

首次部署前需要完成 `wrangler login`，或在 CI 中配置具备 Pages Write 权限的 `CLOUDFLARE_API_TOKEN`。`wrangler.jsonc` 必须保留 `CAPWORKS_API` Service Binding；如文档包含内部接口，建议在自定义域名前启用 Cloudflare Access。