ระดับ 4c · บทที่ 1/5

Workers พื้นฐาน — fetch handler, wrangler dev/deploy, bindings, secrets และ limits

⏱ 50 นาทีลองในCloudflare ↗

เป้าหมาย

สร้าง Worker ด้วย TypeScript ตั้งแต่ศูนย์ รันในเครื่องด้วย wrangler dev deploy ขึ้น edge ใช้ env (vars, secrets, bindings) อย่างถูกต้องและมี type ครบด้วย wrangler types ดู log สด และรู้ว่า limit ไหนจะชนก่อน

Worker คืออะไรในหนึ่งย่อหน้า

โค้ด JavaScript/TypeScript ที่รันใน V8 isolate บนทุก data center ของ Cloudflare — ไม่มีเซิร์ฟเวอร์ ไม่มี container, cold start แทบเป็นศูนย์ ใช้ Web API มาตรฐาน (fetch, Request, Response, URL, crypto) ไม่ใช่ Node.js เต็มตัว (เปิด nodejs_compat ได้ถ้าต้องใช้ module ของ Node)

โครงของ Worker

export default {
  async fetch(request, env, ctx): Promise<Response> {
    return new Response("hello");
  },
} satisfies ExportedHandler<Env>;
พารามิเตอร์ คืออะไร
request คำขอ HTTP + request.cf (ประเทศ, colo, ASN ฯลฯ)
env ทุกอย่างที่ผูกกับ Worker: vars, secrets, KV, R2, D1, static assets — ไม่มี global config
ctx ctx.waitUntil(promise) ทำงานต่อหลังส่ง response แล้ว (log, analytics)

Handler อื่นในไฟล์เดียวกัน: scheduled (Cron, บท 05), queue (ระดับ 5c)

wrangler.jsonc — หัวใจของโปรเจกต์

key ทำไมสำคัญ
name ชื่อ Worker (เป็นส่วนหนึ่งของ URL *.workers.dev)
main ไฟล์เริ่มต้น
compatibility_date ล็อกพฤติกรรม runtime ณ วันนั้น — Cloudflare แก้ runtime โดยไม่ทำโค้ดเก่าพัง · ตั้งเป็นวันที่สร้างโปรเจกต์ แล้วขยับเองเมื่อพร้อม
compatibility_flags เปิดฟีเจอร์เฉพาะ เช่น nodejs_compat
observability.enabled เปิด Workers Logs เก็บ console.log ให้ค้นในแดชบอร์ด
vars ค่า config ที่ ไม่ลับ (เห็นได้ใน config/แดชบอร์ด)

vars vs secrets

vars secrets
เก็บที่ wrangler.jsonc (อยู่ใน git) Cloudflare (เข้ารหัส) ตั้งด้วย wrangler secret put
ตอน dev อ่านจาก config อ่านจาก .dev.vars (หรือ .env) — ใส่ใน .gitignore
ใช้ใน code env.GREETING env.ADMIN_TOKEN (เหมือนกัน)
ใช้กับ URL, feature flag API key, token, password

wrangler types — type ของ env จาก config จริง

รันหลังแก้ wrangler.jsonc หรือ .dev.vars ทุกครั้ง → สร้าง worker-configuration.d.ts ที่มี interface Env ครบทุก binding + type ของ runtime ตาม compatibility_date → พิมพ์ env. แล้ว editor เติมให้ ถ้าพิมพ์ชื่อ binding ผิด tsc จับได้ทันที

Limits ที่ชนบ่อย

Free Paid
requests 100,000 / วัน ไม่จำกัด (คิดตามใช้)
CPU time ต่อ request 10 ms ค่าเริ่ม 30 s ตั้งได้ถึง 5 นาที
subrequest (fetch ออก) ต่อ request 50 10,000
memory ต่อ isolate 128 MB 128 MB
ขนาด Worker (ไม่บีบอัด) 64 MiB 64 MiB
env vars ต่อ Worker 64 128
  • CPU time ≠ เวลารอ — รอ fetch/DB ไม่นับ CPU · งานที่กิน CPU คือ parse JSON ก้อนใหญ่, crypto, resize รูป
  • เกินโควตา Free → request ได้ error (ไม่มีบิลแอบเพิ่ม) · Paid มีค่าบริการรายเดือนขั้นต่ำ ดูราคาที่ developers.cloudflare.com/workers/platform/pricing

ลองเลย 🧪

ต้องมี Node.js 20+ และ npx wrangler whoami แสดงบัญชีคุณ (ระดับ 2)

ทดลอง A — สร้างโปรเจกต์

cd ~/cloud-ladder        # โฟลเดอร์เดียวกับระดับ 2 (ชื่อ hello-api ไม่ชนกับ hello-edge ของระดับ 2)
npm create cloudflare@latest -- hello-api --type=hello-world --lang=ts --no-deploy --git
cd hello-api

แก้ wrangler.jsonc ให้เป็นแบบนี้ (คง compatibility_date ที่ C3 สร้างให้ไว้ได้)

{
  "$schema": "node_modules/wrangler/config-schema.json",
  "name": "hello-api",
  "main": "src/index.ts",
  "compatibility_date": "2026-09-01",
  "observability": { "enabled": true },
  "vars": { "GREETING": "สวัสดี" }
}

สร้างความลับสำหรับ dev และกันไม่ให้เข้า git

echo 'ADMIN_TOKEN="local-dev-only-token"' > .dev.vars
grep -q '^.dev.vars' .gitignore || echo '.dev.vars*' >> .gitignore
npx wrangler types
grep -A3 "interface Env" worker-configuration.d.ts

ผลที่ควรเห็น (ประมาณนี้):

interface Env {
    GREETING: "สวัสดี";
    ADMIN_TOKEN: string;
}

ทดลอง B — เขียน API เล็กๆ แทนที่ src/index.ts ทั้งไฟล์

const enc = new TextEncoder();

function safeEqual(a: string, b: string): boolean {
  const x = enc.encode(a);
  const y = enc.encode(b);
  return x.byteLength === y.byteLength && crypto.subtle.timingSafeEqual(x, y);
}

export default {
  async fetch(request, env): Promise<Response> {
    const url = new URL(request.url);

    if (url.pathname === "/api/hello") {
      const name = url.searchParams.get("name") ?? "world";
      console.log(JSON.stringify({ event: "hello", name }));
      return Response.json({
        message: `${env.GREETING}, ${name}`,
        colo: request.cf?.colo ?? "local",
        country: request.cf?.country ?? "unknown",
      });
    }

    if (url.pathname === "/api/admin") {
      const auth = request.headers.get("authorization") ?? "";
      // ยังไม่ได้ตั้ง secret → ปฏิเสธเสมอ (กัน "Bearer undefined" ผ่าน)
      if (!env.ADMIN_TOKEN || !safeEqual(auth, `Bearer ${env.ADMIN_TOKEN}`)) {
        return Response.json({ error: "unauthorized" }, { status: 401 });
      }
      return Response.json({ ok: true });
    }

    return Response.json({ error: "not found" }, { status: 404 });
  },
} satisfies ExportedHandler<Env>;
npx tsc --noEmit && npx wrangler dev

เปิดอีก terminal

curl -s "http://localhost:8787/api/hello?name=ต้น"
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8787/api/admin
curl -s -H "Authorization: Bearer local-dev-only-token" http://localhost:8787/api/admin

ผลที่ควรเห็น:

{"message":"สวัสดี, ต้น","colo":"...","country":"..."}
401
{"ok":true}

ทดลอง C — deploy, ตั้ง secret จริง, ดู log สด

npx wrangler deploy
openssl rand -hex 24 | npx wrangler secret put ADMIN_TOKEN
npx wrangler secret list

ผลที่ควรเห็น:

Uploaded hello-api (x.xx sec)
Deployed hello-api triggers (x.xx sec)
  https://hello-api.[your-subdomain].workers.dev
Current Version ID: 1a2b3c4d-...
✨ Success! Uploaded secret ADMIN_TOKEN
[ { "name": "ADMIN_TOKEN", "type": "secret_text" } ]

(ค่าความลับไม่ถูกพิมพ์ออกมา — ถ้าต้องใช้เรียก API ให้ตั้งใหม่แล้วเก็บใน password manager)

npx wrangler tail --format pretty

อีก terminal: curl -s "https://hello-api.[your-subdomain].workers.dev/api/hello?name=edge" → ใน tail เห็น GET .../api/hello?name=edge - Ok และบรรทัด log {"event":"hello","name":"edge"} พร้อม colo เป็นรหัสสนามบินของ data center ที่ใกล้คุณ (เช่น BKK)

ทดลอง D — ย้อนเวอร์ชัน แก้ GREETING เป็น "Hello" แล้ว npx wrangler deploy → npx wrangler deployments list เห็น 2+ รายการ → npx wrangler rollback (ไม่ใส่ ID = ย้อนไปเวอร์ชันก่อนหน้า) → curl อีกครั้งได้ สวัสดี กลับมา

เก็บกวาด (ถ้าไม่ใช้ต่อในบทถัดไป)

npx wrangler delete

ผลที่ควรเห็น: ถามยืนยันแล้ว Successfully deleted hello-api

กับดักที่เจอบ่อย

อาการ สาเหตุ / แก้
env.ADMIN_TOKEN เป็น undefined ตอน dev ไม่มี .dev.vars หรืออยู่ผิดโฟลเดอร์ (ต้องอยู่ข้าง wrangler.jsonc)
TypeScript ไม่รู้จัก env.MY_KV ลืมรัน npx wrangler types หลังเพิ่ม binding
deploy แล้ว vars ที่ตั้งในแดชบอร์ดหาย deploy เขียนทับด้วยค่าใน config → เก็บทุกอย่างใน config หรือใช้ keep_vars: true
Error 1102 / exceeded CPU งานกิน CPU เกิน 10 ms บน Free → ย้ายงานหนักออก หรือใช้ Paid
Too many subrequests วน fetch เกิน 50 ครั้งต่อ request บน Free → รวม request / ใช้ batch API
commit secret ขึ้น git ใส่ .dev.vars* ใน .gitignore ก่อน commit แรก · หลุดแล้วต้อง หมุนค่าใหม่ ไม่ใช่แค่ลบไฟล์
พฤติกรรมเปลี่ยนหลังแก้ compatibility_date อ่าน compatibility flags changelog ก่อนขยับวัน และทดสอบใน dev

สรุปจำง่าย

fetch(request, env, ctx) — ทุกอย่างมาทาง env — ค่าไม่ลับใน vars ค่าลับใน secret put + .dev.vars (gitignore) — แก้ config แล้วรัน wrangler types — CPU 10 ms บน Free นับแค่เวลาคิด ไม่นับเวลารอ — พังแล้ว wrangler rollback