เป้าหมาย
สร้าง 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