# Cloudflare 知识技能全面的 Cloudflare 平台知识，涵盖所有功能、定价和最佳实践。当用户需要有关 Cloudflare 边缘计算平台的详细信息时激活此技能。 ## 激活触发器当用户询问以下问题时激活此技能： * Cloudflare Workers 开发 * Wrangler CLI 命令和配置 * 存储服务（R2、D1、KV、持久对象、队列） * Hyperdrive数据库连接池 * AI Workers（TTS、STT、LLM、图像模型） * 零信任（隧道、WARP、访问策略） * MCP服务器开发与集成 * 工作流程和持久执行 * 向量化向量数据库 * 页面和静态站点部署 * CI/CD 与 GitHub Actions 或 Workers 构建 * 可观察性（日志、痕迹、OpenTelemetry） * 负载均衡和健康检查 * Cron触发器和计划任务 * 成本优化和定价 ** ** ## 平台概述 Cloudflare 是一个全球边缘计算平台，拥有 300 多个数据中心，提供： * **Workers** ：边缘的无服务器 JavaScript/TypeScript/Python/WASM * **Pages** ：静态站点和全栈应用程序托管 * **R2** ：与 S3 兼容的对象存储，出口费用为零 * **D1** ：无服务器 SQLite 数据库 * **KV** ：最终一致的键值存储 * **持久对象** ：与 WebSocket 支持的状态协调 * **队列** ：异步消息处理 * **Hyperdrive** ：数据库连接池 * **AI Workers** ：边缘推理（LLM、TTS、STT、图像） * **零信任**：基于身份的安全平台 * **Vectorize** ：RAG 应用程序的矢量数据库 * **工作流程**：持久的多步骤执行 ** ** ## Wrangler CLI 参考 ### 项目设置 # 创建新项目 npm 创建 cloudflare@latest my-worker # 在现有目录中初始化 npx 牧马人初始化 # 登录 npx 牧马人登录 npx 牧马人 whoami ### 发展 # 本地开发 npx牧马人开发 npx wrangler dev --remote # 使用远程绑定 npx wrangler dev --local # 完全本地化 # 本地测试 cron 触发器卷曲“http://localhost:8787/__scheduled?cron=*+*+*+*+*” ### 部署 # 部署到生产环境 npx 牧马人部署 # 部署到环境 npx 牧马人部署 --env staging # 列出版本 npx 牧马人版本列表 # 回滚 npx牧马人回滚 ### D1 数据库 # 创建数据库 npx 牧马人 d1 创建我的数据库 # 执行SQL npx wrangler d1 执行 my-database --local --file=schema.sql npx wrangler d1 执行 my-database --remote --command="SELECT * FROM users" # 交互式外壳 npx wrangler d1 执行 my-database --local --command=".tables" # 导出 npx 牧马人 d1 导出我的数据库 --remote --output=backup.sql ### R2 铲斗 # 创建桶 npx 牧马人 r2 存储桶创建我的存储桶 # 列出存储桶 npx 牧马人 r2 遗愿清单 # 上传/下载 npx wrangler r2 对象 put my-bucket/file.txt --file=local.txt npx 牧马人 r2 对象获取 my-bucket/file.txt --file=download.txt # 删除 npx wrangler r2 对象删除 my-bucket/file.txt ### KV 命名空间 # 创建命名空间 npx 牧马人 kv 命名空间创建 MY_KV npx wrangler kv namespace create MY_KV --preview # 预览命名空间 # 列出命名空间 npx wrangler kv 命名空间列表 # 关键操作 npx牧马人kv键放置--绑定MY_KV键“值” npx 牧马人 kv 密钥获取 --绑定 MY_KV 密钥 npx 牧马人 kv 密钥列表 --绑定 MY_KV npx 牧马人 kv 密钥删除 --绑定 MY_KV 密钥 # 批量上传 npx牧马人kv批量放置--绑定MY_KV data.json ### 秘密 # 设置秘密 npx牧马人秘密放置API_KEY #（提示输入值） # 列出秘密 npx牧马人秘密名单 # 删除秘密 npx牧马人秘密删除API_KEY ### 队列 # 创建队列 npx 牧马人队列创建我的队列 # 列出队列 npx 牧马人队列列表 ### 超光速引擎 # 创建 Hyperdrive 配置 npx 牧马人 hyperdrive 创建 my-hyperdrive --connection-string="postgres://..." # 列出配置 npx 牧马人超光速驱动器列表 # 更新 npx 牧马人 hyperdrive 更新 my-hyperdrive --connection-string="postgres://..." ** ** ## 牧马人配置 (wrangler.jsonc) ### 完整配置参考 { "$schema": "./node_modules/wrangler/config-schema.json", “姓名”：“我的工人”， "main": "src/index.ts", “兼容性日期”：“2024-01-01”， “compatibility_flags”：[“nodejs_compat”]， // 账户设置 "account_id": "<可选帐户 ID>", // 构建设置 “缩小”：正确， “node_compat”：正确， // 环境变量 “变量”：{ “API_URL”：“https://api.example.com” }, // KV 命名空间 “kv_命名空间”：[ { “绑定”：“MY_KV”， "id": "<命名空间 ID>", "preview_id": "<预览命名空间 ID>" } ], // R2 桶 “r2_buckets”：[ { “绑定”：“MY_BUCKET”， "bucket_name": "我的桶", "preview_bucket_name": "我的存储桶预览", “管辖权”：“欧盟” } ], // D1 数据库 “d1_数据库”：[ { “绑定”：“数据库”， "database_id": "<数据库 ID>", “database_name”：“我的数据库” } ], // 持久对象 “耐用对象”：{ “绑定”：[ { “姓名”：“MY_DO”， “class_name”：“MyDurableObject” } ] }, “迁移”：[ { “标签”：“v1”， “new_classes”：[“MyDurableObject”] }, { “标签”：“v2”， “new_sqlite_classes”：[“MyDurableObjectWithSQL”] } ], // 队列 “队列”：{ “生产者”：[ { “绑定”：“MY_QUEUE”， “队列”：“我的队列” } ], “消费者”：[ { “队列”：“我的队列”， “最大批量大小”：10， “最大批量超时”：30， “最大重试次数”：3， "dead_letter_queue": "我的 dlq" } ] }, // 超光速引擎 “超级光驱”：[ { “绑定”：“MY_DB_POOL”， "id": "" } ], // 工人人工智能 “艾”：{ “绑定”：“人工智能” }, // 向量化 “矢量化”：[ { “绑定”：“MY_VECTORS”， “index_name”：“我的索引” } ], // 浏览器渲染 “浏览器”：{ “绑定”：“浏览器” }, // 服务绑定（Worker 到 Worker） “服务”：[ { “绑定”：“OTHER_WORKER”， “服务”：“其他工作人员姓名” } ], // 定时任务触发器 “触发”：{ "crons": ["0 * * * *", "0 6 * * *"] }, // 路线 “路线”：[ { “模式”：“example.com/*”， “zone_name”：“example.com” } ], // 可观测性 “可观察性”：{ “日志”：{ “启用”：正确， “调用日志”：正确， “头采样率”：1 } }, // 环境 “环境”：{ “分期”：{ “名称”：“我的工人分期”， “变量”：{ “API_URL”：“https://staging-api.example.com” } }, “生产”：{ “名称”：“我的工人生产”， “路线”：[ { “模式”：“api.example.com/*”， “zone_name”：“example.com” } ] } } } ** ** ## 存储服务深入探讨 ### KV（键值存储） **特点：** * 最终一致（长达 60 秒的传播） * 最大值大小：25 MiB * 最大密钥大小：512 字节 * 最适合：配置、会话数据、缓存 * 免费套餐：100,000 次读取/天，1,000 次写入/天接口环境{ MY_KV: KV命名空间； } // 写操作等待 env.MY_KV.put("键", "字符串值"); 等待 env.MY_KV.put("key", JSON.stringify(object)); 等待 env.MY_KV.put("key", arrayBuffer); // 使用 TTL（秒）等待env.MY_KV.put（“会话”，数据，{expirationTtl：3600}）; // 绝对过期等待 env.MY_KV.put("会话", 数据, { 过期: Math.floor(Date.now() / 1000) + 3600 }); // 带元数据等待 env.MY_KV.put("用户:123", userData, { 元数据：{ 类型：“用户”，版本：2 } }); // 读操作 const value = wait env.MY_KV.get("key"); // 返回字符串或null const json =等待 env.MY_KV.get("key", "json"); // 解析 JSON const buffer = wait env.MY_KV.get("key", "arrayBuffer"); const 流 = 等待 env.MY_KV.get("key", "stream"); // 带元数据 const { 值，元数据 } = 等待 env.MY_KV.getWithMetadata("key"); // 列出键 const 列表 = 等待 env.MY_KV.list(); constfiltered=awaitenv.MY_KV.list({前缀：“用户：”，限制：100}); // 分页：使用list.cursor进行下一页 // 删除等待 env.MY_KV.delete("key"); ### R2（对象存储） **特点：** * S3兼容的API * 零出口费用 * 最大对象大小：5 TB * 单次上传最大：5 GB（使用分段上传更大） * 最适合：媒体文件、备份、数据湖、大文件接口环境{ MY_BUCKET：R2Bucket； } // 放置对象等待 env.MY_BUCKET.put("path/to/file.json", JSON.stringify(data), { http元数据：{ 内容类型：“应用程序/json”，缓存控制：“最大年龄=3600”， }, 自定义元数据：{ 上传者：“工人”，版本：“1.0”， }, }); // 加上校验和等待 env.MY_BUCKET.put("file.bin", data, { md5: ExpectedMd5, // 上传时验证 sha256：预期Sha256， }); // 获取对象 const object = wait env.MY_BUCKET.get("path/to/file.json"); 如果（对象）{ const text = await object.text(); const json = 等待 object.json(); const buffer =等待object.arrayBuffer(); const blob = await object.blob(); const 流 = object.body; // 可读流 // 元数据 console.log(object.key, object.size, object.etag); console.log(object.httpMetadata.contentType); console.log(object.customMetadata.uploadedBy); } // 头（仅元数据） const head = wait env.MY_BUCKET.head("path/to/file.json"); // 列出对象 const 列表 = 等待 env.MY_BUCKET.list(); const 过滤 = 等待 env.MY_BUCKET.list({ 前缀：“上传/”，分隔符：“/”，限制：1000， }); // 删除等待 env.MY_BUCKET.delete("path/to/file.json"); 等待 env.MY_BUCKET.delete(["file1.json", "file2.json"]); // 批量删除 // 分段上传（适用于> 5GB的文件） const upload = wait env.MY_BUCKET.createMultipartUpload("large-file.zip"); const part1 = 等待 upload.uploadPart(1, chunk1); const part2 = 等待 upload.uploadPart(2, chunk2); 等待上传.complete([part1,part2]); // 或者中止等待上传.abort(); ### D1（SQLite 数据库） **特点：** * 无服务器 SQLite * 一致性强 * 最大数据库大小：10 GB (GA) * 最适合：关系数据、复杂查询、ACID 事务接口环境{ DB：D1数据库； } // 准备好的语句（推荐） const stmt = env.DB.prepare("从用户中选择 * WHERE id = ?"); const { 结果 } =等待 stmt.bind(userId).all(); const user = wait stmt.bind(userId).first(); const value = wait stmt.bind(userId).first("name"); // 单列 // 插入/更新 const { 元 } = 等待 env.DB.prepare( “插入用户（姓名、电子邮件）值（？、？）” ).bind(姓名、电子邮件).run(); console.log(meta.last_row_id, meta.changes); // 批量操作（单笔交易） const 结果 = 等待 env.DB.batch([ env.DB.prepare("INSERT INTO 用户(名称) VALUES (?)").bind("Alice"), env.DB.prepare("INSERT INTO 用户(姓名) VALUES (?)").bind("Bob"), env.DB.prepare("更新计数器 SET value = value + 1 WHERE name = 'users'"), ]); // 原始执行等待 env.DB.exec("PRAGMA table_info(users)"); // 事务模式（使用批处理）等待 env.DB.batch([ env.DB.prepare("更新账户 SET 余额 = 余额 - ? WHERE id = ?").bind(100, fromId), env.DB.prepare("更新账户 SET 余额 = 余额 + ？ WHERE id = ?").bind(100, toId), ]); **D1 最佳实践：** -- 为WHERE子句列创建索引在用户（电子邮件）上创建索引 idx_users_email； -- 使用 EXPLAIN QUERY PLAN 验证索引使用情况 EXPLAIN QUERY PLAN SELECT * FROM users WHERE email = 'test@example.com'; -- 批量大迁移从日志中删除，其中created_at < '2024-01-01' LIMIT 1000； -- 架构更改后运行 PRAGMA优化； ### 耐用的物体 **特点：** * 单线程、全局唯一实例 * 内置SQLite存储 * WebSocket 支持休眠 * 最适合：实时协调、聊天、游戏、计数器 // 持久对象类导出类计数器 { 状态：DurableObjectState；值：数字=0；构造函数（状态：DurableObjectState，env：Env）{ this.state = 状态； // 从存储中恢复状态 this.state.blockConcurrencyWhile(async () => { this.value = (await this.state.storage.get("value")) || 0; }); } 异步获取（请求：请求）：Promise { const url = 新 URL(request.url); switch (url.路径名) { 案例“/增量”： this.value++; 等待 this.state.storage.put("value", this.value); return Response.json({ value: this.value }); 案例“/值”： return Response.json({ value: this.value }); 默认： return new Response("未找到", { status: 404 }); } } } // 使用持久对象的 Worker 导出默认值{ 异步获取（请求：请求，环境：环境）{ const id = env.COUNTER.idFromName("全局"); const 存根 = env.COUNTER.get(id); 返回存根.fetch(请求); }, }; **WebSocket Hibernation:** 导出类聊天室{ 状态：DurableObjectState；构造函数（状态：DurableObjectState，env：Env）{ this.state = 状态； } 异步获取（请求：请求）：Promise { if (request.headers.get("升级") === "websocket") { constpair = new WebSocketPair(); const [客户端，服务器] = Object.values(pair); // 使用休眠 API this.state.acceptWebSocket(服务器); 返回新的 Response(null, { 状态: 101, webSocket: 客户端 }); } return new Response("预期的 WebSocket", { status: 400 }); } // 休眠 DO 收到 WebSocket 消息时调用异步 webSocketMessage(ws: WebSocket, 消息: string | ArrayBuffer) { // 向所有连接的客户端广播 for (this.state.getWebSockets() 的 const 客户端) { if (client !== ws && client.readyState === WebSocket.READY_STATE_OPEN) { 客户端.发送(消息); } } } async webSocketClose(ws: WebSocket, 代码: 数字, 原因: 字符串) { // 处理断开连接 } 异步 webSocketError(ws: WebSocket, 错误: 未知) { // 处理错误 ws.close(1011, "内部错误"); } } ### 队列 **特点：** * 异步消息处理 * 至少一次交付 * Automatic retries with dead letter queues * 最适合：解耦、后台作业、事件处理 // 生产者接口环境{ MY_QUEUE：队列； } 导出默认值{ 异步获取（请求：请求，环境：环境）{ // 发送单个消息等待 env.MY_QUEUE.send({ type: "email", to: "user@example.com" }); // 带选项发送等待 env.MY_QUEUE.send( { 类型：“进程”，id：123 }， { 内容类型：“json” } ）； // 批量发送等待 env.MY_QUEUE.sendBatch([ { 正文：{ id：1 } }， { 正文：{ id：2 } }， { 正文：{ id：3 } }， ]); 返回新的响应（“排队”）； }, }; // 消费者接口队列消息{ 类型：字符串； id？：号码；到？：字符串； } 导出默认值{ 异步队列(batch: MessageBatch, env: Env): Promise { for (batch.messages 的常量消息) { 尝试{ console.log(`处理：${JSON.stringify(message.body)}`); 等待 processMessage(message.body); 消息.ack(); // 标记为已处理 } 捕获 (e) { console.error(`失败：${e}`); 消息重试（）； // Will retry (up to max_retries) } } }, }; ** ** ## AI 工作者参考 ### Available Models (2025-2026) **文本生成：** 型号|背景 |最适合 ---|---|--- @cf/meta/llama-3.3-70b-instruct-fp8-fast | 128K |一般、推理 @cf/mistral/mistral-7b-instruct-v0.2 | 32K |快速、高效 @cf/qwen/qwen2.5-72b-instruct | 128K |多语言 @cf/deepseek/deepseek-r1-distill-llama-70b | 64K |复杂的推理 **Text-to-Speech (TTS):** 型号|语言 |注释 ---|---|--- @deepgram/aura-2-en |英语 | Best quality, context-aware @deepgram/aura-1 |英语 |速度快，质量好 @cf/myshell-ai/melotts |英语、法语、西班牙语、中文、日语、日语 |多语言 **Speech-to-Text (STT):** 型号|语言 |注释 ---|---|--- @cf/openai/whisper-large-v3-turbo | 100+ |快速、准确 @cf/openai/耳语 | 100+ |原创耳语 **图像生成：** 型号|分辨率|注释 ---|---|--- @cf/black-forest-labs/flux-1-schnell |高达 1024x1024 |快 @cf/stabilityai/stable-diffusion-xl-base-1.0 |高达 1024x1024 |详细 **视觉/字幕：** 型号|能力 ---|--- @cf/meta/llama-3.2-11b-vision-instruct |图像理解、字幕 @cf/llava-hf/llava-1.5-7b-hf |视觉问答 **嵌入：** 型号|尺寸|注释 ---|---|--- @cf/baai/bge-large-en-v1.5 | 1024 | 1024最好的品质 @cf/baai/bge-small-en-v1.5 | 384 | 384更快 ### 用法示例接口环境{ 人工智能：艾； } // 文本生成 const 响应 = 等待 env.AI.run("@cf/meta/llama-3.3-70b-instruct-fp8-fast", { 消息：[ { role: "系统", content: "你是一个得力助手。" }, { 角色：“用户”，内容：“什么是 Cloudflare？” }, ], 最大令牌数：512，温度：0.7， }); // 流式传输 const 流 = 等待 env.AI.run("@cf/meta/llama-3.3-70b-instruct-fp8-fast", { 消息：[...]，流：真实， }); 返回新的响应（流，{ 标题：{“内容类型”：“文本/事件流”}， }); // 文本转语音 const audio = wait env.AI.run("@deepgram/aura-2-en", { text: "您好，这是一个测试。", }); 返回新的响应（音频，{ 标题：{“内容类型”：“音频/wav”}， }); // 语音转文本 const 成绩单 =等待 env.AI.run("@cf/openai/whisper-large-v3-turbo", { 音频：audioArrayBuffer， }); // 返回 { text: "...", snippets: [...] } // Image generation const image = wait env.AI.run("@cf/black-forest-labs/flux-1-schnell", { 提示：“日落时的未来城市景观”，步数：4， }); 返回新的响应（图像，{ 标题：{“Content-Type”：“image/png”}， }); // 嵌入 const embeddings = wait env.AI.run("@cf/baai/bge-large-en-v1.5", { 文本：[“你好世界”，“Cloudflare Workers”]， }); // 返回 { data: [{ embedding: [...] }, { embedding: [...] }] } // 图像字幕 const 标题 = 等待 env.AI.run("@cf/meta/llama-3.2-11b-vision-instruct", { 图像：图像数组缓冲区，提示：“详细描述这张图片。”, }); ** ** ## 超光速深度探究 Hyperdrive 通过维护靠近数据库的连接池来加速数据库连接。 ### 设置 # 创建 Hyperdrive 配置 npx 牧马人 hyperdrive 创建 my-db \ --connection-string="postgres://user:pass@host:5432/database" # 添加到 wrangler.jsonc ### 用法从“pg”导入{客户端}；接口环境{ MY_DB: Hyperdrive; } 导出默认值{ 异步获取（请求：请求，环境：环境）{ // 使用 Hyperdrive 连接字符串进行连接常量客户端 = 新客户端({ 连接字符串：env.MY_DB.connectionString， }); 等待客户端.connect(); const result = wait client.query("SELECT * FROM users WHERE id = $1", [1]); // 无需调用 client.end() - Hyperdrive 管理池化返回 Response.json(结果.行); }, }; ### 何时使用超光速 **在以下情况下使用超光速引擎：** * 连接到远程 PostgreSQL/MySQL 数据库 * 高延迟数据库连接（不同地区） * 频繁的相同读取查询（缓存） * 需要许多并发数据库连接 **在以下情况下不要使用 Hyperdrive：** * 使用 D1（已经是边缘原生） * 本地开发（使用直连） * 需要跨请求准备语句（事务模式限制） * 使用持久对象存储 ### 性能优势没有超光速引擎： Worker -> TCP 握手（1 RTT） -> TLS 协商（3 个 RTT） -> DB 身份验证（3 个 RTT） -> 查询（1 RTT）总计：首次查询前 8 次往返使用超光速引擎： Worker -> Hyperdrive池（缓存连接） -> 查询（1 个 RTT 到池中，重用数据库连接）总计：1次往返查询 ** ** ## Zero Trust Reference ### Cloudflare Tunnel 无需打开防火墙端口即可安全地公开内部服务。 **安装：** # macOS 酿造安装cloudflared # 窗口 winget 安装 Cloudflare.cloudflared # Linux 卷曲 -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o cloudflared sudo chmod +x cloudflared && sudo mv cloudflared /usr/local/bin/ **设置：** # 登录 cloudflared 隧道登录 # 创建隧道 cloudflared 隧道创建我的隧道 # 创建配置文件(~/.cloudflared/config.yml) cat << EOF > ~/.cloudflared/config.yml 隧道：<隧道 ID> 凭证文件：$HOME/.cloudflared/.json 入口： - 主机名：app.example.com 服务：http://localhost:3000 - 主机名：api.example.com 服务：http://localhost:8080 - 服务：http_status：404 EOF # 添加DNS cloudflared 隧道路由 dns my-tunnel app.example.com # 运行 cloudflared 隧道运行 my-tunnel **作为服务运行：** # Linux sudo cloudflared 服务安装 sudo systemctl 启用 cloudflared sudo systemctl 启动 cloudflared # macOS sudo cloudflared 服务安装 sudo launchctl load /Library/LaunchDaemons/com.cloudflare.cloudflared.plist ### 访问策略在 Cloudflare 仪表板中配置（零信任 > 访问 > 应用程序）：应用：名称：内部应用程序类型：自托管域名：app.example.com 政策：名称：允许公司动作：允许包括： - 电子邮件域名：company.com 要求： - 国家：美国 ### WARP 客户端 * 用于零信任注册的设备客户端 * 通过 Cloudflare 网络路由流量 * 启用基于身份的访问策略 * 用于选择性路由的分割隧道 ** ** ## MCP 服务器参考 ### Building MCP Server on Workers 从“@cloudflare/mcp-server”导入{McpServer}；接口环境{ DB：D1数据库； } 常量服务器 = 新 McpServer({ 名称：“我的 mcp 服务器”，版本：“1.0.0”， }); // 定义工具服务器.addTool({ 名称：“查询数据库”， description: "查询D1数据库", 参数：{ 类型：“对象”，属性：{ 查询：{ 类型：“字符串”，描述：“要执行的 SQL 查询” }， }, 必需：[“查询”]， }, handler: async ({ query }, { env }) => { const 结果 =等待 env.DB.prepare(query).all(); 返回{ 内容：[{ 类型：“文本”，文本：JSON.stringify(result.results) }]， }; }, }); // 定义资源服务器.addResource({ uri：“db://表”，名称：“数据库表”， description: "List of all tables", handler: async ({ env }) => { const tables = await env.DB.prepare( “从 sqlite_master 中选择名称，其中类型='表'” ).all(); 返回{ 内容：[{ uri：“db://tables”，文本：JSON.stringify(tables.results) }]， }; }, }); 导出默认值{ 异步获取（请求：请求，环境：环境）{ return server.handleRequest(request, env); }, }; ### MCP 传输类型 1. **流式 HTTP**（推荐，2025 年 3 月以上） * 单一 HTTP 端点 * Bidirectional messaging * Standard for remote MCP 2. **stdio** (Local only) * 标准输入/输出 * For local MCP connections 3. **上交所**（已弃用） * Use Streamable HTTP instead ### Cloudflare's Managed MCP Servers Available at `https://mcp.cloudflare.com/`: * 工人管理 * R2桶操作 * D1数据库查询 * DNS管理 * 分析访问 **从克劳德/光标连接：** { “mcp服务器”：{ “云耀”：{ "url": "https://mcp.cloudflare.com/sse", “运输”：“上海” } } } ** ** ## CI/CD 参考 ### GitHub 操作名称：部署工作人员于：推：分支：[主要] 职位：部署：运行：ubuntu-latest 步骤： - 使用：actions/checkout@v4 - 名称：安装 Node.js 使用：actions/setup-node@v4 与：节点版本：“20” - 名称：安装依赖项运行：npm ci - 名称：运行测试运行：npm 测试 - 名称：部署到 Cloudflare 使用：cloudflare/wrangler-action@v3 与： apiToken：${{secrets.CLOUDFLARE_API_TOKEN}} 帐户 ID：${{ Secrets.CLOUDFLARE_ACCOUNT_ID }} ### Workers 构建（本机 Git 集成） 1. 在 Cloudflare 仪表板中连接 GitHub/GitLab 2.选择存储库和分支 3.配置构建命令（可选） 4.推送自动部署 5. 拉取请求的预览 URL ** ** ## 定价参考（2025-2026） ### 工人计划|价格|请求|中央处理器时间 ---|---|---|--- 免费| 0 美元 | 10 万/天 | 10 毫秒/调用付费| $5/月 |含 10M | 30 秒/调用用途 | +$0.30/M 请求 | - | $0.02/M 毫秒 ### 存储服务 |免费套餐 |付费 ---|---|--- 千伏 |每天 100K 读取、1K 写入 | $0.50/M 读取，$5/M 写入 R2 | 10GB 存储、10M A 类运算 | $0.015/GB，$4.50/M A 类 D1 |每天读取 500 万行，写入 10 万行 | $0.001/M 行，$1/M 写入耐用的物体| 100 万个请求 | $0.15/月请求队列 | 100 万条消息 | $0.40/月消息 ### 人工智能工作者 * 按推理付费 * 因型号而异（查看仪表板了解当前定价） * 免费套餐包含有限的推论 ** ** ## 最佳实践 ### 性能 1. **使用边缘缓存**：使用 `caches.default` 缓存 API 响应 2. **最小化冷启动**：保持 Workers 小，使用动态导入 3. **使用服务绑定**：零成本的 Worker 到 Worker 调用 4. **批量操作**：结合KV/R2/D1操作 5. **使用Hyperdrive**：用于远程数据库连接 ### 安全 1. **使用秘密**：切勿对凭证进行硬编码 2. **验证输入**：清理所有用户输入 3. **使用 HTTPS** ：始终使用安全连接 4. **实施速率限制**：防止滥用 5. **使用零信任**：用于内部服务访问 ### 成本优化 1. **使用静态资源**：免费、无限制的静态文件服务 2. **样本日志** ：对高流量的 Worker 使用 `head_sampling_rate` 3. **使用KV进行缓存**：减少D1/外部API调用 4. **批量队列消息**：减少每条消息的开销 5. **使用适合 GPU 的模型**：不要过度配置 AI ** ** ## 快速参考任务|命令/代码 ---|--- 新项目 | `npm 创建 cloudflare@latest` 本地开发 | `npx 牧马人开发` 部署| `npx 牧马人部署` 创建 D1 | `npx 牧马人 d1 创建名称` 创建KV | `npx wrangler kv 命名空间创建名称` 创建 R2 | `npx wrangler r2 存储桶创建名称` 设定秘密| `npx 牧马人秘密输入名称` 创建队列 | `npx wrangler 队列创建名称` 创建隧道| `cloudflared 隧道创建名称`

Cloudflare 知识

包含技能