Cloudflare 平台技能
在 Cloudflare 平台上构建的综合技能。使用下面的决策树找到合适的产品，然后加载详细的参考文件。
你对 Cloudflare API、类型、限制和定价的了解可能已过时。优先检索而非预训练——本技能中的参考文件是起点，而非事实来源。
检索来源
在引用具体数字、API 签名或配置选项之前，请获取最新信息。不要依赖内置知识或仅凭这些参考文件。
| 来源 |
如何检索 |
用途 |
| Cloudflare 文档 |
cloudflare-docs 搜索工具或 https://developers.cloudflare.com/ |
限制、定价、API 参考、兼容性日期/标志 |
| Workers 类型 |
npm pack @cloudflare/workers-types 或检查 node_modules |
类型签名、绑定形状、处理程序类型 |
| Wrangler 配置模式 |
node_modules/wrangler/config-schema.json |
配置字段、绑定形状、允许的值 |
| 产品变更日志 |
https://developers.cloudflare.com/changelog/ |
限制、功能、弃用的近期变更 |
当参考文件与文档不一致时，以文档为准。这一点对于数字限制、定价层级、类型签名和配置选项尤其重要。
快速决策树
“我需要功能标志”
需要功能标志？
└─ 功能开关、目标规则、百分比发布 → flagship/
├─ 在 Workers 中评估 → Flagship 绑定 (env.FLAGS)
├─ 在 Node.js / 浏览器中评估 → OpenFeature SDK (@cloudflare/flagship)
└─ 通过 API 管理标志 → Flagship REST API
“我需要运行代码”
需要运行代码？
├─ 边缘无服务器函数 → workers/
├─ 全栈 Web 应用（Git 部署） → pages/
├─ 有状态协调/实时 → durable-objects/
├─ 长时间运行的多步骤任务 → workflows/
├─ 运行容器 → containers/
├─ 多租户（客户部署代码） → workers-for-platforms/
├─ 定时任务（cron） → cron-triggers/
├─ 轻量级边缘逻辑（修改 HTTP） → snippets/
├─ 处理 Worker 执行事件（日志/可观测性） → tail-workers/
└─ 优化到后端基础设施的延迟 → smart-placement/
“我需要存储数据”
需要存储？
├─ 键值（配置、会话、缓存） → kv/
├─ 关系型 SQL → d1/ (SQLite) 或 hyperdrive/ (现有 Postgres/MySQL)
├─ 对象/文件存储（S3 兼容） → r2/
├─ 版本化文件树（仓库、构建输出、检查点） → artifacts/
├─ 消息队列（异步处理） → queues/
├─ 向量嵌入（AI/语义搜索） → vectorize/
├─ 强一致性每实体状态 → durable-objects/ (DO 存储)
├─ 密钥管理 → secrets-store/
├─ 流式 ETL 到 R2 → pipelines/
└─ 持久缓存（长期保留） → cache-reserve/
“我需要 AI/ML”
需要 AI？
├─ 运行推理（LLM、嵌入、图像） → workers-ai/
├─ 用于 RAG/搜索的向量数据库 → vectorize/
├─ 构建有状态 AI 代理 → agents-sdk/
├─ 任何 AI 提供商的网关（缓存、路由） → ai-gateway/
└─ AI 驱动的搜索小部件 → ai-search/
“我需要网络/连接”
需要网络？
├─ 将本地服务暴露到互联网 → tunnel/
├─ TCP/UDP 代理（非 HTTP） → spectrum/
├─ WebRTC TURN 服务器 → turn/
├─ 私有网络连接 → network-interconnect/
├─ 优化路由 → argo-smart-routing/
├─ 优化到后端（而非用户）的延迟 → smart-placement/
└─ 实时视频/音频 → realtimekit/ 或 realtime-sfu/
“我需要安全”
需要安全？
├─ Web 应用防火墙 → waf/
├─ DDoS 防护 → ddos/
├─ 机器人检测/管理 → bot-management/
├─ API 保护 → api-shield/
├─ CAPTCHA 替代方案 → turnstile/
└─ 凭证泄露检测 → waf/ (托管规则集)
“我需要媒体/内容”
需要媒体？
├─ 图像优化/转换 → images/
├─ 视频流/编码 → stream/
├─ 浏览器自动化/截图 → browser-rendering/
└─ 第三方脚本管理 → zaraz/
“我需要分析/指标数据”
需要分析？
├─ 查询所有 Cloudflare 产品（HTTP、Workers、DNS 等） → graphql-api/
├─ Workers 中的自定义高基数指标 → analytics-engine/
├─ 客户端（RUM）性能数据 → web-analytics/
├─ Workers 日志和实时调试 → observability/
└─ 原始日志（Logpush 到外部工具） → Cloudflare 文档
“我需要基础设施即代码”
需要 IaC？ → pulumi/ (Pulumi)、terraform/ (Terraform) 或 api/ (REST API)
产品索引
功能标志
| 产品 |
参考 |
| Flagship |
references/flagship/ |
计算与运行时
| 产品 |
参考 |
| Workers |
references/workers/ |
| Pages |
references/pages/ |
| Pages Functions |
references/pages-functions/ |
| Durable Objects |
references/durable-objects/ |
| Workflows |
references/workflows/ |
| Containers |
references/containers/ |
| Workers for Platforms |
references/workers-for-platforms/ |
| Cron Triggers |
references/cron-triggers/ |
| Tail Workers |
references/tail-workers/ |
| Snippets |
references/snippets/ |
| Smart Placement |
references/smart-placement/ |
存储与数据
| 产品 |
参考 |
| KV |
references/kv/ |
| D1 |
references/d1/ |
| R2 |
references/r2/ |
| Artifacts |
references/artifacts/ |
| Queues |
references/queues/ |
| Hyperdrive |
references/hyperdrive/ |
| DO Storage |
references/do-storage/ |
| Secrets Store |
references/secrets-store/ |
| Pipelines |
references/pipelines/ |
| R2 Data Catalog |
references/r2-data-catalog/ |
| R2 SQL |
references/r2-sql/ |
AI 与机器学习
| 产品 |
参考 |
| Workers AI |
references/workers-ai/ |
| Vectorize |
references/vectorize/ |
| Agents SDK |
references/agents-sdk/ |
| AI Gateway |
references/ai-gateway/ |
| AI Search |
references/ai-search/ |
网络与连接
| 产品 |
参考 |
| Tunnel |
references/tunnel/ |
| Spectrum |
references/spectrum/ |
| TURN |
references/turn/ |
| Network Interconnect |
references/network-interconnect/ |
| Argo Smart Routing |
references/argo-smart-routing/ |
| Workers VPC |
references/workers-vpc/ |
安全
| 产品 |
参考 |
| WAF |
references/waf/ |
| DDoS Protection |
references/ddos/ |
| Bot Management |
references/bot-management/ |
| API Shield |
references/api-shield/ |
| Turnstile |
references/turnstile/ |
媒体与内容
| 产品 |
参考 |
| Images |
references/images/ |
| Stream |
references/stream/ |
| Browser Rendering |
references/browser-rendering/ |
| Zaraz |
references/zaraz/ |
实时通信
| 产品 |
参考 |
| RealtimeKit |
references/realtimekit/ |
| Realtime SFU |
references/realtime-sfu/ |
开发者工具
| 产品 |
参考 |
| Wrangler |
references/wrangler/ |
| Miniflare |
references/miniflare/ |
| C3 |
references/c3/ |
| Observability |
references/observability/ |
| GraphQL Analytics API |
references/graphql-api/ |
| Analytics Engine |
references/analytics-engine/ |
| Web Analytics |
references/web-analytics/ |
| Sandbox |
references/sandbox/ |
| Workerd |
references/workerd/ |
| Workers Playground |
references/workers-playground/ |
基础设施即代码
| 产品 |
参考 |
| Pulumi |
references/pulumi/ |
| Terraform |
references/terraform/ |
| API |
references/api/ |
其他服务
| 产品 |
参考 |
| Email Routing |
references/email-routing/ |
| Email Workers |
references/email-workers/ |
| Static Assets |
references/static-assets/ |
| Bindings |
references/bindings/ |
| Cache Reserve |
references/cache-reserve/ |
