跳轉至

建立 2026-11-22 更新 2026-11-22

Workers 無伺服器程式

Cloudflare Workers 是在 Cloudflare 全球資料中心執行程式碼的無伺服器(Serverless)平台:你只寫處理請求的函式,Cloudflare 負責在離使用者最近的節點執行它,不用準備主機、不用擔心擴充。Workers 採用 V8 Isolate 技術,幾乎沒有冷啟動延遲。免費方案每日可處理 10 萬次請求,適合 API、Webhook、網址改寫與全端應用。

建立第一個 Worker

需要先安裝 Node.js(建議 LTS 版本)。

npm create cloudflare@latest -- my-worker

建立精靈會詢問專案類型,選 Hello World example → Worker only → TypeScript(或 JavaScript)。完成後:

cd my-worker
npx wrangler dev      # 本機開發,預設 http://localhost:8787
npx wrangler deploy   # 部署到 my-worker.<你的子網域>.workers.dev

Worker 程式長什麼樣?

src/index.ts
export default {
  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
    const url = new URL(request.url);

    if (url.pathname === "/api/time") {
      return Response.json({ now: new Date().toISOString() });
    }

    return new Response("Hello from Cloudflare Workers!", {
      headers: { "content-type": "text/plain; charset=utf-8" },
    });
  },
};
  • request:標準 Web API 的 Request 物件。
  • env:環境變數、Secret 與 KV/D1/R2 等綁定(Bindings)。
  • ctx:可用 ctx.waitUntil() 在回應後繼續執行背景工作。

Workers 使用標準 Web API(fetch、Request、Response、URL),寫法與瀏覽器相近,也能透過相容層使用許多 Node.js API。

設定檔 wrangler.jsonc

wrangler.jsonc
{
  "name": "my-worker",
  "main": "src/index.ts",
  "compatibility_date": "2026-11-01",
  "vars": { "GREETING": "你好" }
}

compatibility_date 決定 Workers 執行環境的行為版本,讓 Cloudflare 更新平台時不會破壞你既有的程式。新專案設成建立當天即可。完整說明見 Wrangler 命令列工具。

如何用 Workers 託管靜態網站?

在設定檔加上 assets,Workers 就會直接提供該目錄的靜態檔案,只有找不到檔案的請求才進入程式:

{
  "name": "my-app",
  "main": "src/index.ts",
  "compatibility_date": "2026-11-01",
  "assets": { "directory": "./dist" }
}

這是 Cloudflare 目前建議新全端專案使用的方式,與 Cloudflare Pages 的比較見該頁。

綁定自訂網域

預設網址是 *.workers.dev。在 Worker 的 Settings → Domains & Routes 可以:

  • Custom Domain:讓整個主機名稱(例如 api.example.com)由 Worker 回應,DNS 與憑證自動建立。
  • Route:讓網站某個路徑(例如 example.com/api/*)交給 Worker 處理,其他路徑照常送到原始主機。

定時執行(Cron Triggers)

{ "triggers": { "crons": ["0 1 * * *"] } }   // 每天 UTC 01:00(台灣 09:00)
export default {
  async scheduled(event: ScheduledController, env: Env, ctx: ExecutionContext) {
    // 例如每天清理過期資料、發送報表
  },
};

免費方案的限制

項目 免費方案
請求數 每日 10 萬次
每次請求 CPU 時間 10 毫秒(等待網路回應不計入)
Worker 數量 100 個

CPU 時間只計算程式實際運算的時間,呼叫外部 API 等待回應不算在內,一般 API 用途很少超過。需要更多時,付費方案每月 5 美元起。

相關資料