用途:指导使用 cf CLI 与类型化 cloudflare.config.ts 在 Cloudflare 上部署应用与基础设施,适用于部署 Workers、迁移 Wrangler 项目等场景。
主要能力:提供产品决策树(计算、存储、AI、网络、安全、媒体、IaC 等)与对应 references 参考;支持 Workers、KV、D1、R2、Queues、Durable Objects、Workers AI、Vectorize、Tunnel、WAF、Turnstile 等众多产品;包含认证、迁移、配置、CI/CD 与排错指引。
使用方式:需 Node.js 24+ 与 pnpm,安装 npm 包 cf(非 @cloudflare/cf),保持在 devDependencies 并提交 lockfile。部署前用 pnpm exec cf auth whoami 验证认证;本地用 pnpm exec cf auth login,CI 设置 CLOUDFLARE_API_TOKEN 与 CLOUDFLARE_ACCOUNT_ID。运行前先发现命令:pnpm exec cf cli search "create a D1 database"、pnpm exec cf schema d1 create、pnpm exec cf d1 create --help。Wrangler 项目先 cf migrate --dry-run 再 cf migrate。示例命令:pnpm add -D cf @cloudflare/vite-plugin@beta vite typescript;pnpm exec cf kv namespaces create --title CACHE;pnpm exec cf workers types;pnpm exec cf dev;pnpm exec cf deploy --dry-run --secrets-file .env.production;pnpm exec cf deploy --secrets-file .env.production。
限制:检查的 cf beta 未实现实时日志流与旧版 Pages 资源部署,Pages 项目需保持现有部署并规划迁移;自动配置不导入旧绑定;升级时需重新核对帮助与类型。网络受限时部署可能需提升权限。其余细节暂未提供。