標籤: Cloudflare Workers

  • Cloudflare 邊緣 TCP/gRPC 打造 AI 推理網路

    Cloudflare 邊緣 TCP/gRPC 打造 AI 推理網路

    📌 本文重點

    • Cloudflare 邊緣現支援原生入站 TCP/gRPC
    • 可在邊緣直接跑 gRPC 推理、RAG 與微服務
    • 相較 K8s,全球互動式 AI 延遲與成本更優
    • 可作為既有 gRPC/K8s 架構的前置 Edge layer

    Cloudflare 開放 Workers/Containers 入站 TCP + gRPC,直接解掉幾個很實際的痛點:AI 推理只能走 HTTP/JSON、無法沿用現有 gRPC 微服務、邊緣節點難以做長連線與串流推理。現在你可以在 Cloudflare 邊緣跑 原生 gRPC 推理服務、RAG 檢索節點與微服務 Mesh,延遲更低、成本更像 CDN,而不是像傳統 K8s 叢集那樣重。


    重點說明

    1. 邊緣執行模型:Workers vs Containers

    Cloudflare 現在有兩種主要邊緣運行模式:

    • Workers:類似 serverless JavaScript/TypeScript 執行環境
    • 適合:輕量 API 轉接、認證、路由、簡單推理管線
    • 過去:只支援 HTTP/S,你必須把 gRPC 轉成 HTTP JSON,再打到後端
    • 現在:支援 入站 TCP/gRPC,可直接在邊緣 terminate gRPC

    • Containers(Cloudflare Workers AI / Cloudflare Containers):執行打包好的映像

    • 適合:完整推理服務、向量檢索、Python/Go gRPC server
    • 行為更接近傳統 Pod,但由 Cloudflare 在全球 PoP 管理

    這次更新的核心是:兩者都能收 TCP/gRPC 流量,你可以在邊緣直接跑 grpc-gogrpc-python 的 server,不必再把邊緣當純 HTTP 反向代理。

    💡 關鍵: Workers 與 Containers 現在都能直接處理入站 TCP/gRPC,等於在 Cloudflare 邊緣即可部署完整 gRPC 微服務與 AI 推理節點。

    2. 入站 TCP/gRPC 開放後能做什麼?

    從開發者視角,幾個立刻有用的場景:

    • AI 推理服務在邊緣
    • 在每個區域部署輕量 gRPC 推理節點,靠 Anycast + 邊緣路由 讓使用者打到最近 PoP
    • 使用串流 gRPC (Server streaming) 傳回 token,體感延遲大幅下降

    • RAG 檢索節點

    • 在邊緣跑向量查詢服務(Faiss/pgvector/自家引擎),gRPC 介面
    • 利用 Cloudflare 的 colo 分布,把索引按地理或租戶分片

    • 沿用既有 gRPC 微服務

    • 以前你要在前面加 API Gateway/Ingress,把 gRPC 轉 HTTP 或 terminate TLS
    • 現在可以在邊緣直接 terminate gRPC,後面用 TCP/gRPC 轉發到 origin 或在邊緣直接處理

    實際好處:

    • 延遲:請求在使用者附近的 PoP 就完成認證、路由,甚至整個推理
    • 成本模型:按使用計費、無需維護多個 K8s cluster,只維護映像與 Workers code
    • 協議相容性:不用再為「Cloudflare 只懂 HTTP」寫一層轉換邏輯

    💡 關鍵: 對互動式 AI 與全球用戶服務,邊緣 gRPC 推理能在不改協議的前提下顯著降低體感延遲與基礎設施維運成本。

    3. 與 Kubernetes + Ingress 的比較

    假設你現在有一套標準架構:Cloud LB → Ingress (Envoy/NGINX) → gRPC microservices / AI inference pods

    用 Cloudflare 邊緣替代部分角色時,可以這樣看:

    • 延遲
    • K8s:流量通常集中在幾個 region(us-east, ap-southeast),跨區通訊不可避免
    • Cloudflare:請求先到最近 PoP,如果推理在邊緣完成,RTT 直接以「使用者到 PoP」為主

    • 成本

    • K8s:你要付 cluster 固定成本(control plane + node),再加 LB、egress 等
    • Cloudflare:付 Workers/Containers 執行 + 帶寬,沒有 cluster idle 成本,對 burst 型推理更友善

    • 可觀測性

    • K8s:你掌握 Pod metric、sidecar tracing,能非常細緻
    • Cloudflare:以 request-level logs/metrics 為主,容器內的應用層 metric 要自己上報(例如推到 Prometheus/Grafana Cloud)

    結論:

    • 全球服務、互動式 AI(chat、copilot),邊緣方案延遲優勢很明顯
    • 重度內網 microservices mesh,K8s 還是比較好管理細粒度通訊與觀測

    💡 關鍵: 邊緣 gRPC 更適合面向外部用戶的全球互動式 AI;內部複雜微服務 Mesh 則仍以 K8s 為主,再用 Cloudflare 當前置入口。


    實作範例

    以下用簡化的範例示意:在 Cloudflare 邊緣部署一個 gRPC AI 推理 API,前面 Workers 做零信任與路由,後面 Container 跑真正的 gRPC server。

    1. Terraform:宣告 TCP/gRPC 入口與 Workers Route

    # cloudflare.tf
    provider "cloudflare" {
      api_token = var.cloudflare_api_token
    }
    
    resource "cloudflare_account" "this" {
      name = "my-ai-edge-account"
    }
    
    # 建立域名與 gRPC 入口
    resource "cloudflare_zone" "ai_api" {
      name = "ai.example.com"
    }
    
    # 開啟 gRPC(HTTP/2 + TCP)入口
    resource "cloudflare_worker_route" "grpc_route" {
      zone_id     = cloudflare_zone.ai_api.id
      pattern     = "ai.example.com/*"
      script      = cloudflare_worker_script.grpc_edge.name
    }
    
    resource "cloudflare_worker_script" "grpc_edge" {
      name    = "grpc-edge-worker"
      content = file("./dist/grpc-edge-worker.js")
    }
    

    這裡的關鍵是 route 指到 Workers script,Cloudflare 會依協議分流;當客戶端用 gRPC over TLS 打 ai.example.com,會由對應的 PoP 進入 Worker。

    2. Workers:在邊緣處理 TCP/gRPC 連線與零信任

    Cloudflare 新增了類似 TCP sockets API 的能力(以下為概念化程式碼,實際 API 名稱以官方為準):

    // grpc-edge-worker.js
    export default {
      async fetch(request, env, ctx) {
        // HTTP 入口:可用來做健康檢查、簡單 REST 包裝
        return new Response("OK", { status: 200 });
      },
    
      async tcp(conn, env, ctx) {
        // conn: 表示入站 TCP 連線(含 TLS 已由 Cloudflare terminate)
    
        // 1. 零信任:檢查 mTLS 或 JWT(假設從 Cloudflare Access 傳入 header)
        const identity = await verifyZeroTrust(conn, env);
        if (!identity.valid) {
          await conn.close();
          return;
        }
    
        // 2. 將 TCP 流量轉發到邊緣 Container 中的 gRPC server
        const backendConn = await env.AI_GRPC_ORIGIN.connect({
          host: "ai-grpc.internal", // 邊緣 Container 的內部 host
          port: 50051,
        });
    
        // 3. 做簡單的連線鏡射(pipe)
        conn.pipeTo(backendConn.writable, { preventClose: false });
        backendConn.readable.pipeTo(conn.writable, { preventClose: false });
      },
    };
    
    async function verifyZeroTrust(conn, env) {
      // 範例:檢查 Cloudflare Access JWT 或 mTLS client cert
      // 回傳 { valid: true/false }
      return { valid: true };
    }
    

    重點:

    • tcp(conn, env, ctx) 代表邊緣上對入站 TCP 的 handler
    • 你可以在這裡做 零信任驗證、租戶路由、限流,再把流量交給後面的 gRPC server
    • 後面的 server 可以跑在 Cloudflare Containers,也可以指到你自己的 origin(例如 GCP/K8s)

    3. Container:gRPC AI 推理服務

    假設你在 Cloudflare Container 裡跑一個簡化的 Python gRPC server:

    # inference_server.py
    import grpc
    from concurrent import futures
    from proto import inference_pb2, inference_pb2_grpc
    
    class InferenceServicer(inference_pb2_grpc.InferenceServiceServicer):
        def StreamChat(self, request, context):
            # request.prompt, request.user_id
            for token in run_llm_stream(request.prompt):
                yield inference_pb2.ChatToken(token=token)
    
        def Embed(self, request, context):
            vec = embed_text(request.text)
            return inference_pb2.Embedding(vector=vec)
    
    def serve():
        server = grpc.server(futures.ThreadPoolExecutor(max_workers=8))
        inference_pb2_grpc.add_InferenceServiceServicer_to_server(
            InferenceServicer(), server
        )
        server.add_insecure_port("[::]:50051")
        server.start()
        server.wait_for_termination()
    
    if __name__ == "__main__":
        serve()
    

    你只需要把這個映像部署在 Cloudflare Containers,並與前面的 Worker 透過內部 TCP 相接。


    建議與注意事項

    1. TLS / 零信任設計

    • 對外:讓 Cloudflare 統一做 TLS 終結(TLS termination),使用 Cloudflare Access/ZT 控制身份
    • 對內:邊緣 Worker 與 Container/Origin 之間建議使用 mTLS,防止橫向移動
    • 若你已有 API Gateway(Kong/Envoy),可把 Cloudflare 當 前置 Edge layer,只保留 Gateway 在核心 region 接收來自邊緣的 gRPC

    2. 連線壽命與狀態管理

    • gRPC streaming 本質是長連線,要注意:
    • Worker 執行時間限制:確保 Cloudflare 的執行模型允許長時間 pipe,必要時把邏輯放到 Container
    • 斷線重試:在客戶端設計 token-based resume(例如 cursor 或 offset),避免整個對話因 PoP 切換中斷

    • 状態建議:

    • 對話狀態 / session 放在外部儲存(KV、Durable Objects、Redis),不要綁在單一 PoP

    3. Origin 的擴展策略

    • 若推理服務仍在自家 K8s:
    • 用 Cloudflare 邊緣做 全局入口與零信任,後面依租戶或地域分流到不同 cluster
    • 注意 跨 region 帶寬成本:邊緣到 origin 的流量可能集中在幾個 region

    • 若全面搬到 Cloudflare Containers:

    • 建議 按地區部署多個副本,配合 Workers 做地理路由
    • 用外部 observability stack(例如 OpenTelemetry + Tempo/Loki)把邊緣 metric 拉回統一平台

    4. 常見坑與避雷

    • 連線數上限
    • 高併發 gRPC streaming 會吃 connection slot,要確認 Cloudflare 帳號/方案的限制
    • 建議在 Workers 做 client-side throttling 或 queue,避免瞬間打爆 Container

    • 冷啟動

    • Workers 冷啟動通常比 Lambda 類服務快,但 Container 啟動仍有延遲
    • 對延遲敏感的推理 API:

      • 預熱核心路由(例如每 PoP 保留最常用模型的 warm instance)
      • 使用簡單的 health probe 定期打模型,維持容器活躍
    • 與現有 API Gateway 串接

    • 遷移策略:先把 外部客戶端改打 Cloudflare 邊緣 gRPC 入口,由 Workers 轉發到原 API Gateway
    • 等確定運作穩定,再逐步把認證、限流移到邊緣

    5. 一個可落地的「邊緣 AI API」樣板

    總結一個可直接採用的樣板架構:

    1. Domain & TLSai.example.com 由 Cloudflare 管理,開啟 TLS、gRPC 支援
    2. Edge Worker
    3. 實作 tcp() handler
    4. 做零信任/租戶識別/流量路由(ex: enterprise vs free)
    5. Edge Containers
    6. 多區部署 AI 推理 gRPC server + RAG 檢索
    7. 共享外部向量庫或依地區分片
    8. Observability
    9. 邊緣 logs/metrics 推到集中式平台
    10. gRPC tracing 使用 OpenTelemetry,將 trace context 從 Worker 轉接到 Container
    11. 漸進式遷移
    12. 先讓 5–10% 流量經邊緣 gRPC 入口,觀察延遲與錯誤率
    13. 穩定後再逐步將 region LB 退場,讓 Cloudflare 成為主要入口

    關鍵結論

    如果你的 AI 產品面向全球使用者、有既有 gRPC 微服務、又不想維護多套 K8s 邊緣集群,Cloudflare 邊緣 入站 TCP/gRPC 是一個能在短期內帶來 延遲優化 + 架構簡化 的實際選項,值得在下一版推理網路設計中優先評估。


    🚀 你現在可以做的事

    • 到 Cloudflare Docs 搜尋「Workers TCP gRPC」了解最新 API 與限制
    • 把現有一個 gRPC 推理服務包成 Container,嘗試部署到 Cloudflare Containers 並透過 Worker 轉發
    • 在現有架構前加一個試驗性 ai-edge.example.com 網域,先導入 5–10% gRPC 流量觀察延遲與穩定性
  • Cloudflare AI 一鍵開站實戰指南

    Cloudflare AI 一鍵開站實戰指南

    📌 本文重點

    • Cloudflare + AI Agent 把建站流程變成一條指令
    • Agent 幫你自動處理帳號、網域、DNS 與部署
    • 透過細分工具與沙盒權限控制降低風險

    用一句話講清楚:這套 Cloudflare + AI Agent 的做法,就是讓「註冊帳號、買網域、設 DNS、部署前端/反向代理」整包變成一條指令搞定的自動流程。

    參考:Cloudflare 官方示範 AI Agent 如何創建帳號、購買網域並部署專案:https://blog.cloudflare.com/agents-stripe-projects/


    核心功能:AI 幫你做掉的「雲端雜事」

    把這個 Agent 想成會上 Cloudflare 幫你跑腿的「小助理」,它擅長三件事:


    1. 自動開帳號與綁付款

    能做什麼

    • 依照你的輸入,幫你在 Cloudflare 建新帳號或登入既有帳號
    • 透過 API 綁定 Stripe 等付款方式(在 Cloudflare 文中是 demo Stripe)

    你可以立刻做的事

    • 先準備一組「測試用帳號 + 測試信用卡」(例如:Stripe test mode)
    • 在 Agent 的設定檔裡,只給它測試環境的 API Key,避免直接動到正式金流

    2. 自動買網域 + DNS 設定

    能做什麼

    • 搜尋可用網域,根據你描述的站點主題幫你推薦(如:blog、landing page)
    • 幫你在 Cloudflare Registrar 購買網域
    • 自動建立對應 DNS 記錄(A、CNAME、TXT 等)

    你可以立刻做的事

    • 先選一個你願意「當實驗品」的便宜網域(.dev、.xyz)
    • 把「搜尋網域」「購買網域」拆成兩個獨立步驟,先讓 Agent 只做搜尋與列出候選,購買時再由你點選確認

    3. 一鍵部署 Pages / Workers / 反向代理

    能做什麼

    • 建立 Cloudflare Pages 專案,從 GitHub/GitLab 拉前端程式碼並自動部署
    • 建立 Workers 當 API gateway 或反向代理,轉發到你的後端
    • 將網域 CNAME / A 設到對應的 Pages 或 Workers,整站自動串起來

    你可以立刻做的事

    • 先準備一個最簡單的範例 repo:只有 index.html 的靜態站
    • 在 Agent 裡把「部署 Pages」設計成可重複執行的腳本,之後要開新站只換 repo URL 與網域即可

    適合誰用:幾個實際場景


    1. 產品團隊:十個 Landing Page 反覆 A/B test

    • 你只需要寫清楚:產品描述、目標市場、想測的方案數
    • Agent 幫你:
    • 從模板庫挑版型
    • 幫你生成靜態文案 + 分版本
    • 各建一個 Pages 專案 + 子網域(如 v1.、v2.、v3)

    2. 個人開發者:接案每次都要幫客戶開新站

    • 預先寫好「開新客戶站」腳本:
    • 建 Cloudflare 帳號 + Project
    • 關聯 Git repo
    • 設 DNS + SSL
    • 真正接案時,只要把客戶資訊填進表單,Agent 幫你跑完流程

    3. 小團隊 SRE / DevOps:想把「開新環境」變成自助服務

    • 把目前手動 run 的 Terraform / CLI 流程,包成幾個固定步驟
    • 用 Agent 把這些步驟串成「對話式自助開環境」,讓工程師只回答幾個問題就能有 dev / staging 站

    怎麼設計安全的 Agent 流程與權限

    這類 Agent 一旦拿到金流與 DNS 權限,風險就很實際,所以要先設計好「它能做什麼」與「什麼一定要人按確認」。

    💡 關鍵: 把高風險操作拆成小工具並加人類確認,是在維持自動化效率下控管金流與 DNS 風險的核心做法。


    步驟 1:把任務拆成幾個明確能力(tools)

    建議至少拆:

    1. search_domains:搜尋可用網域
    2. purchase_domain:購買指定網域
    3. create_cf_account:建立 Cloudflare 帳號
    4. deploy_pages_project:建立 + 部署 Pages
    5. create_worker_and_route:建立 Worker 並設定路由
    6. update_dns_record:新增 / 修改 DNS

    每個能力對應一個 API client 或 script,Agent 只能呼叫這些「包裝好」的函式,不直接拿到 raw API key。


    步驟 2:為每個能力標示「是否需要人類確認」

    一個簡單實作方式:在工具定義中加一個 flag:

    {
      "name": "purchase_domain",
      "human_approval_required": true,
      "max_amount": 20
    }
    

    然後在你的 Agent orchestrator 裡:

    • 若工具標示 human_approval_required,就把呼叫參數(例如網域名稱、價格)顯示在後台或發 Slack/Email
    • 只有當你點「批准」後,才真的讓後端執行這個工具

    步驟 3:使用「細分 API Key」與沙盒環境

    實務上避免「一把鑰匙開全公司」。

    • Cloudflare:
    • 建一個 專門給 Agent 用的 Account,只能管特定 zone
    • 使用 Scoped API Tokens,只開啟 DNS / Workers / Pages 所需權限
    • 金流(如 Stripe):
    • 一開始只給 test mode key
    • 等流程穩定後,再引入正式金流 + 嚴格人類審批

    實際腳本示範:從一句話需求到站點上線

    下面是一條「可複製」的流程。假設你在自建的 Agent 平台上,給模型這個任務:

    幫我開一個介紹 AI 工具評測的個人網站,用最便宜的可用網域,前端用現成靜態模板,掛在 Cloudflare Pages,上線後回報網址與部署細節。

    可以拆成以下幾步(你在 orchestrator 裡實作):


    1. 理解需求(LLM 自己完成)

    • 抽取:主題(AI 工具評測)、語言(繁中)、預算(便宜網域)、託管方式(Pages)

    2. 搜尋網域(需人確認)

    • Agent 呼叫 search_domains,傳入關鍵字:ai-tool-review, aitoolnotes
    • 回傳候選清單(名稱 + 價格)
    • 顯示在 UI 讓你勾選要買哪一個

    3. 購買網域(強制人類確認)

    • 你勾選後,才允許 Agent 呼叫 purchase_domain
    • 成功後記錄網域 ID,存入任務上下文

    4. 部署 Cloudflare Pages

    • 先由 Agent 幫你選模板+生成內容
    • 基於 GitHub 上某個 starter template(設定在系統 prompt 裡)
    • 產生 index.html 內容(標題、關於我、最新評測文章列表 placeholder)
    • 呼叫 deploy_pages_project
    • repo_url: 你預先準備好的 template repo
    • build_command: “npm run build” 或空字串(純靜態)
    • output_dir: dist / build

    5. 設定 DNS 與路由

    • Pages 部署完成後會有一個預設子網域
    • Agent 呼叫 update_dns_record
    • 把剛買的網域的 @www CNAME 指到 Pages 網址

    6. 回報結果

    • Agent 最後整理:
    • 站點網址
    • 使用的網域價格
    • Pages 專案名稱與部署歷史連結
    • 你可以點進去檢查,如果沒問題,下次只要換一句需求就能複製整套流程

    想看 Cloudflare 官方更進階的案例(含 Stripe、Workers 整合),可參考:https://blog.cloudflare.com/agents-stripe-projects/


    實務風險與如何加上「人類確認」

    在 Reddit / Medium 上已經有很多討論,尤其是當 Agent 直接碰資料庫或金流時,風險會被放大。像 Vishesh Rawal 就分析了 AI Agent 連 PostgreSQL 時,因為連線被占住 6 秒而不是 5ms,讓連線池吞吐量掉了 1200 倍:https://medium.com/@visheshrawal/what-really-happens-inside-your-database-when-an-ai-agent-starts-querying-6d5254aeaa78

    💡 關鍵: AI Agent 對基礎設施與資料庫的「慢操作」,可能把吞吐量放大到原本的 1/1200,必須用節流與審批機制保護系統。

    對於 Cloudflare 這種「基礎設施類操作」,建議至少做三件事:


    1. 所有「花錢」的操作都要人工二次確認

    • 買網域、綁定正式金流、升級付費方案
    • 透過:Email、Slack bot、後台 Dashboard 的 Approve 按鈕

    2. 所有「改路由」的操作都要記錄審計

    • Log:誰下指令、Agent 呼叫了哪些工具、前後 DNS / Routing 差異
    • 發生事故時可以回溯,避免「Agent 胡亂改設定但找不到原因」

    3. 分環境:先在「沙盒帳號」驗證流程

    • 先在一個完全獨立的 Cloudflare 帳號跑完整流程
    • 確認行為符合預期後,才把相同腳本接到正式帳號,但權限再縮一級

    最低成本實驗指南:用現成工具在沙盒重現自動部署

    如果你想在一個週末內實際玩到這套「一鍵開站」流程,可以照這個極簡路線走:


    步驟 1:準備一個 Cloudflare 沙盒帳號

    1. 用新的 email 註冊一個 Cloudflare 帳號
    2. 建立一個 API Token
    3. Template 選「Edit Cloudflare Workers」或「Edit Cloudflare Pages」
    4. Scope 只給某一兩個 zone(或一開始先不管 zone,只玩免費二級網域)

    步驟 2:選一個可以自訂 Tools 的 Agent 平台

    你可以用以下任一種方式:

    • 開源 / 自架:如基於 LangChain、LlamaIndex 或自寫 Python + OpenAI API
    • 商用平台:選一個支援「自訂工具 / Actions」的聊天式 Agent 介面

    關鍵是:你要能把「call Cloudflare API」包成一個工具,給模型呼叫。


    步驟 3:先做「最小可用流程」

    在沙盒帳號裡,先只讓 Agent 做兩件事:

    1. 建立一個 Cloudflare Pages 專案(用你現成的 GitHub 靜態站 repo)
    2. 回報部署網址給你

    這代表你只需要實作一個工具:deploy_pages_project,以及一個很簡單的 system prompt:

    你是一個幫助使用者在 Cloudflare Pages 部署靜態網站的助理。
    使用者只會提供 GitHub repo 連結與專案說明。
    你應該:
    1. 確認使用者需求
    2. 呼叫 deploy_pages_project 工具
    3. 回報部署後的網址與任何錯誤訊息。
    不要購買網域,只使用預設的 Cloudflare Pages 網址。
    

    等這條 pipeline 穩定後,再逐步加入:搜尋網域 → DNS 設定 → Workers 反向代理 → 網域購買(最後才加)。


    快速整理:這套做法的價值

    • 把「開新站」變成一條指令:從建帳號、買網域到部署,都由 Agent 操作 Cloudflare 完成
    • 可複製的腳本化流程:不同產品/客戶只改描述與 repo,其餘通用
    • 安全可控:透過細分工具、Scoped Token、人工審批,把風險鎖在沙盒與少數關鍵節點

    💡 關鍵: 先用 Pages 自動部署當起點,再逐步接入網域、Workers 與金流,是導入 Cloudflare Agent 化的漸進路線。

    如果你手上已經有穩定的 Git 部署流程,下一步就可以試著讓 Agent 幫你「接手 Cloudflare 那一段」,從最簡單的 Pages 自動部署開始,慢慢走向真正的一鍵開站。

    🚀 你現在可以做的事

    • 在 Cloudflare 開一個沙盒帳號並建立專用 Scoped API Token
    • 準備一個只含 index.html 的 GitHub 靜態站 repo,作為 Pages 測試專案
    • 在任一支援自訂 Tools 的 Agent 平台上實作 deploy_pages_project,跑通最小可用一鍵部署流程