Workers 無伺服器程式
Cloudflare Workers 是在 Cloudflare 全球資料中心執行程式碼的無伺服器(Serverless)平台:你只寫處理請求的函式,Cloudflare 負責在離使用者最近的節點執行它,不用準備主機、不用擔心擴充。Workers 採用 V8 Isolate 技術,幾乎沒有冷啟動延遲。免費方案每日可處理 10 萬次請求,適合 API、Webhook、網址改寫與全端應用。
建立第一個 Worker
需要先安裝 Node.js(建議 LTS 版本)。
建立精靈會詢問專案類型,選 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)
export default {
async scheduled(event: ScheduledController, env: Env, ctx: ExecutionContext) {
// 例如每天清理過期資料、發送報表
},
};
免費方案的限制
| 項目 | 免費方案 |
|---|---|
| 請求數 | 每日 10 萬次 |
| 每次請求 CPU 時間 | 10 毫秒(等待網路回應不計入) |
| Worker 數量 | 100 個 |
CPU 時間只計算程式實際運算的時間,呼叫外部 API 等待回應不算在內,一般 API 用途很少超過。需要更多時,付費方案每月 5 美元起。