Cloudflare部署

技能文档

---
name: cloudflare-deploy
title: Cloudflare部署
category: 开发工具
description: 使用Workers、Pages及相关平台服务将应用和基础设施部署到Cloudflare。适用于部署、托管、发布或设置Cloudflare项目的场景。触发词：Cloudflare部署、Workers、Pages、边缘计算、wrangler、服务器less。
---

# Cloudflare部署

用于在Cloudflare平台上构建的综合技能。使用下方决策树找到合适的产品，然后加载详细参考文档。

## 前置条件

- 当沙箱阻止部署网络调用时，使用提升权限重新运行。
- 部署可能需要几分钟时间。使用适当的超时值。

## 认证（部署前必须完成）

在执行 `wrangler deploy`、`wrangler pages deploy` 或 `npm run deploy` 前验证认证：

```bash
npx wrangler whoami    # 显示当前认证账户
```

未认证？参考认证文档：
- 交互式/本地：`wrangler login`（一次性OAuth）
- CI/CD：设置 `CLOUDFLARE_API_TOKEN` 环境变量

## 快速决策树

### "我需要运行代码"

```
需要运行代码？
├─ 边缘无服务器函数 → workers/
├─ 带Git部署的全栈Web应用 → 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/
├─ 消息队列（异步处理） → queues/
├─ 向量嵌入（AI/语义搜索） → vectorize/
├─ 强一致性每实体状态 → durable-objects/ (DO存储)
├─ 密钥管理 → secrets-store/
├─ 流式ETL到R2 → pipelines/
└─ 持久缓存（长期保留） → cache-reserve/
```

### "我需要AI/ML"

```
需要AI？
├─ 运行推理（LLM、嵌入、图像） → workers-ai/
├─ RAG/搜索的向量数据库 → vectorize/
├─ 构建有状态AI Agent → 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/
```

### "我需要基础设施即代码"

```
需要IaC？ → pulumi/ (Pulumi), terraform/ (Terraform), 或 api/ (REST API)
```

## 产品索引

### 计算与运行时
| 产品 | 参考路径 |
|------|---------|
| 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/` |
| Queues | `references/queues/` |
| Hyperdrive | `references/hyperdrive/` |
| DO Storage | `references/do-storage/` |
| Secrets Store | `references/secrets-store/` |
| Pipelines | `references/pipelines/` |

### 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/` |

### 安全
| 产品 | 参考路径 |
|------|---------|
| 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/` |

### 开发者工具
| 产品 | 参考路径 |
|------|---------|
| Wrangler | `references/wrangler/` |
| Miniflare | `references/miniflare/` |
| C3 | `references/c3/` |
| Observability | `references/observability/` |

### 基础设施即代码
| 产品 | 参考路径 |
|------|---------|
| Pulumi | `references/pulumi/` |
| Terraform | `references/terraform/` |
| API | `references/api/` |

## 故障排除

### 提升网络权限

如果部署因网络问题失败（超时、DNS错误、连接重置），使用提升权限重新运行部署。当沙箱网络阻止出站请求时，部署需要提升的网络访问权限。

使用说明

# Cloudflare部署

使用Workers、Pages及相关平台服务将应用和基础设施部署到Cloudflare的专业技能。

## 功能特点

- Cloudflare全产品决策树与产品索引
- Workers无服务器函数部署
- Pages全栈Web应用部署
- KV/D1/R2/Queues等存储服务配置
- Workers AI与Vectorize AI服务
- 安全产品（WAF/DDoS/Bot Management）
- 网络与连接（Tunnel/Spectrum/Argo）
- 基础设施即代码（Pulumi/Terraform）

## 适用场景

- 将应用部署到Cloudflare Workers或Pages
- 配置边缘存储（KV/D1/R2）
- 设置Cloudflare安全产品
- 部署AI推理服务
- 配置Tunnel暴露本地服务
- 使用Wrangler进行项目管理

## 使用方法

向当前 Agent 描述你的Cloudflare部署需求，例如：

- "帮我把这个项目部署到Cloudflare Workers"
- "我需要一个KV存储来保存会话数据"
- "如何设置Cloudflare Tunnel暴露本地服务"
- "帮我配置Pages部署一个Next.js应用"
- "如何为我的API设置WAF规则"

## 部署流程

认证验证 → 选择产品 → 配置项目 → 部署上线 → 故障排除

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。