cloudflare-deploy

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Cloudflare Deploy

Cloudflare 部署

Consolidated skill for building on the Cloudflare platform. Use decision trees below to find the right product, then load detailed references.

这是用于在Cloudflare平台上构建项目的综合技能。使用下方的决策树选择合适的产品，然后查看详细参考文档。

Prerequisites

前置条件

When sandboxing blocks the deployment network calls, rerun with
```
sandbox_permissions=require_escalated
```
.
The deployment might take a few minutes. Use appropriate timeout values.

当沙箱阻止部署网络调用时，使用
```
sandbox_permissions=require_escalated
```
重新运行部署命令。
部署可能需要几分钟，请设置合适的超时值。

Authentication (Required Before Deploy)

身份验证（部署前必须完成）

Verify auth before

wrangler deploy

wrangler pages deploy

, or

npm run deploy

bash

npx wrangler whoami    # Shows account if authenticated

Not authenticated? →

references/wrangler/auth.md

Interactive/local:
```
wrangler login
```
(one-time OAuth)
CI/CD: Set
```
CLOUDFLARE_API_TOKEN
```
env var

在执行

wrangler deploy

、

wrangler pages deploy

或

npm run deploy

之前，先验证身份：

bash

npx wrangler whoami    # 已认证的话会显示账户信息

未认证？→ 查看

references/wrangler/auth.md

交互式/本地环境：
```
wrangler login
```
（一次性OAuth认证）
CI/CD环境：设置
```
CLOUDFLARE_API_TOKEN
```
环境变量

Quick Decision Trees

快速决策树

"I need to run code"

"我需要运行代码"

Need to run code?
├─ Serverless functions at the edge → workers/
├─ Full-stack web app with Git deploys → pages/
├─ Stateful coordination/real-time → durable-objects/
├─ Long-running multi-step jobs → workflows/
├─ Run containers → containers/
├─ Multi-tenant (customers deploy code) → workers-for-platforms/
├─ Scheduled tasks (cron) → cron-triggers/
├─ Lightweight edge logic (modify HTTP) → snippets/
├─ Process Worker execution events (logs/observability) → tail-workers/
└─ Optimize latency to backend infrastructure → smart-placement/

需要运行代码？
├─ 边缘无服务器函数 → workers/
├─ 支持Git部署的全栈Web应用 → pages/
├─ 有状态协调/实时服务 → durable-objects/
├─ 长期运行的多步骤任务 → workflows/
├─ 运行容器 → containers/
├─ 多租户（客户部署代码） → workers-for-platforms/
├─ 定时任务（Cron） → cron-triggers/
├─ 轻量级边缘逻辑（修改HTTP请求） → snippets/
├─ 处理Worker执行事件（日志/可观测性） → tail-workers/
└─ 优化后端基础设施的延迟 → smart-placement/

"I need to store data"

"我需要存储数据"

Need storage?
├─ Key-value (config, sessions, cache) → kv/
├─ Relational SQL → d1/ (SQLite) or hyperdrive/ (existing Postgres/MySQL)
├─ Object/file storage (S3-compatible) → r2/
├─ Message queue (async processing) → queues/
├─ Vector embeddings (AI/semantic search) → vectorize/
├─ Strongly-consistent per-entity state → durable-objects/ (DO storage)
├─ Secrets management → secrets-store/
├─ Streaming ETL to R2 → pipelines/
└─ Persistent cache (long-term retention) → cache-reserve/

需要存储数据？
├─ 键值存储（配置、会话、缓存） → kv/
├─ 关系型SQL → d1/（SQLite兼容）或 hyperdrive/（对接现有Postgres/MySQL）
├─ 对象/文件存储（兼容S3） → r2/
├─ 消息队列（异步处理） → queues/
├─ 向量嵌入（AI/语义搜索） → vectorize/
├─ 强一致性的单实体状态存储 → durable-objects/（DO存储）
├─ 密钥管理 → secrets-store/
├─ 流式ETL到R2 → pipelines/
└─ 持久化缓存（长期保留） → cache-reserve/

"I need AI/ML"

"我需要AI/ML能力"

Need AI?
├─ Run inference (LLMs, embeddings, images) → workers-ai/
├─ Vector database for RAG/search → vectorize/
├─ Build stateful AI agents → agents-sdk/
├─ Gateway for any AI provider (caching, routing) → ai-gateway/
└─ AI-powered search widget → ai-search/

需要AI能力？
├─ 运行推理（大语言模型、向量嵌入、图像处理） → workers-ai/
├─ 用于RAG/搜索的向量数据库 → vectorize/
├─ 构建有状态AI代理 → agents-sdk/
├─ 任意AI提供商的网关（缓存、路由） → ai-gateway/
└─ AI驱动的搜索组件 → ai-search/

"I need networking/connectivity"

"我需要网络/连接能力"

Need networking?
├─ Expose local service to internet → tunnel/
├─ TCP/UDP proxy (non-HTTP) → spectrum/
├─ WebRTC TURN server → turn/
├─ Private network connectivity → network-interconnect/
├─ Optimize routing → argo-smart-routing/
├─ Optimize latency to backend (not user) → smart-placement/
└─ Real-time video/audio → realtimekit/ or realtime-sfu/

需要网络能力？
├─ 将本地服务暴露到公网 → tunnel/
├─ TCP/UDP代理（非HTTP） → spectrum/
├─ WebRTC TURN服务器 → turn/
├─ 私有网络连接 → network-interconnect/
├─ 优化路由 → argo-smart-routing/
├─ 优化到后端的延迟（非用户侧） → smart-placement/
└─ 实时音视频 → realtimekit/ 或 realtime-sfu/

"I need security"

"我需要安全能力"

Need security?
├─ Web Application Firewall → waf/
├─ DDoS protection → ddos/
├─ Bot detection/management → bot-management/
├─ API protection → api-shield/
├─ CAPTCHA alternative → turnstile/
└─ Credential leak detection → waf/ (managed ruleset)

需要安全能力？
├─ Web应用防火墙 → waf/
├─ DDoS防护 → ddos/
├─ 机器人检测/管理 → bot-management/
├─ API防护 → api-shield/
├─ CAPTCHA替代方案 → turnstile/
└─ 凭证泄露检测 → waf/（托管规则集）

"I need media/content"

"我需要媒体/内容处理"

Need media?
├─ Image optimization/transformation → images/
├─ Video streaming/encoding → stream/
├─ Browser automation/screenshots → browser-rendering/
└─ Third-party script management → zaraz/

需要媒体能力？
├─ 图片优化/转换 → images/
├─ 视频流/编码 → stream/
├─ 浏览器自动化/截图 → browser-rendering/
└─ 第三方脚本管理 → zaraz/

"I need infrastructure-as-code"

"我需要基础设施即代码（IaC）"

Need IaC? → pulumi/ (Pulumi), terraform/ (Terraform), or api/ (REST API)

需要IaC？ → pulumi/（Pulumi）、terraform/（Terraform）或 api/（REST API）

Product Index

产品索引

Compute & Runtime

计算与运行时

Product	Reference
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/`

产品	参考文档路径
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/`

Storage & Data

存储与数据

Product	Reference
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/`
R2 Data Catalog	`references/r2-data-catalog/`
R2 SQL	`references/r2-sql/`

产品	参考文档路径
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/`
R2 Data Catalog	`references/r2-data-catalog/`
R2 SQL	`references/r2-sql/`

AI & Machine Learning

AI与机器学习

Product	Reference
Workers AI	`references/workers-ai/`
Vectorize	`references/vectorize/`
Agents SDK	`references/agents-sdk/`
AI Gateway	`references/ai-gateway/`
AI Search	`references/ai-search/`

产品	参考文档路径
Workers AI	`references/workers-ai/`
Vectorize	`references/vectorize/`
Agents SDK	`references/agents-sdk/`
AI Gateway	`references/ai-gateway/`
AI Search	`references/ai-search/`

Networking & Connectivity

网络与连接

Product	Reference
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/`

产品	参考文档路径
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/`

Security

安全

Product	Reference
WAF	`references/waf/`
DDoS Protection	`references/ddos/`
Bot Management	`references/bot-management/`
API Shield	`references/api-shield/`
Turnstile	`references/turnstile/`

产品	参考文档路径
WAF	`references/waf/`
DDoS Protection	`references/ddos/`
Bot Management	`references/bot-management/`
API Shield	`references/api-shield/`
Turnstile	`references/turnstile/`

Media & Content

媒体与内容

Product	Reference
Images	`references/images/`
Stream	`references/stream/`
Browser Rendering	`references/browser-rendering/`
Zaraz	`references/zaraz/`

产品	参考文档路径
Images	`references/images/`
Stream	`references/stream/`
Browser Rendering	`references/browser-rendering/`
Zaraz	`references/zaraz/`

Real-Time Communication

实时通信

Product	Reference
RealtimeKit	`references/realtimekit/`
Realtime SFU	`references/realtime-sfu/`

产品	参考文档路径
RealtimeKit	`references/realtimekit/`
Realtime SFU	`references/realtime-sfu/`

Developer Tools

开发者工具

Product	Reference
Wrangler	`references/wrangler/`
Miniflare	`references/miniflare/`
C3	`references/c3/`
Observability	`references/observability/`
Analytics Engine	`references/analytics-engine/`
Web Analytics	`references/web-analytics/`
Sandbox	`references/sandbox/`
Workerd	`references/workerd/`
Workers Playground	`references/workers-playground/`

产品	参考文档路径
Wrangler	`references/wrangler/`
Miniflare	`references/miniflare/`
C3	`references/c3/`
Observability	`references/observability/`
Analytics Engine	`references/analytics-engine/`
Web Analytics	`references/web-analytics/`
Sandbox	`references/sandbox/`
Workerd	`references/workerd/`
Workers Playground	`references/workers-playground/`

Infrastructure as Code

基础设施即代码

Product	Reference
Pulumi	`references/pulumi/`
Terraform	`references/terraform/`
API	`references/api/`

产品	参考文档路径
Pulumi	`references/pulumi/`
Terraform	`references/terraform/`
API	`references/api/`

Other Services

其他服务

Product	Reference
Email Routing	`references/email-routing/`
Email Workers	`references/email-workers/`
Static Assets	`references/static-assets/`
Bindings	`references/bindings/`
Cache Reserve	`references/cache-reserve/`

产品	参考文档路径
Email Routing	`references/email-routing/`
Email Workers	`references/email-workers/`
Static Assets	`references/static-assets/`
Bindings	`references/bindings/`
Cache Reserve	`references/cache-reserve/`

Troubleshooting

故障排除

Escalated Network Access

提升网络权限

If deployment fails due to network issues (timeouts, DNS errors, connection resets), rerun the deploy with escalated permissions (use

sandbox_permissions=require_escalated

). The deploy requires escalated network access when sandbox networking blocks outbound requests.

Example guidance to the user:

The deploy needs escalated network access to deploy to Cloudflare. I can rerun the command with escalated permissions—want me to proceed?

如果部署因网络问题（超时、DNS错误、连接重置）失败，请使用提升的权限重新运行部署（添加参数

sandbox_permissions=require_escalated

）。当沙箱网络阻止出站请求时，部署需要提升的网络权限。

给用户的示例指导：

部署到Cloudflare需要提升网络权限。我可以使用提升的权限重新运行命令——是否继续？