เป้าหมาย
เลือกได้ว่าข้อมูลไหนควรอยู่ KV ไหนควรอยู่ R2 (และไหนควรไป D1 ในบทถัดไป) สร้าง namespace/bucket ด้วย wrangler ผูก binding เขียน Worker ที่อ่าน-เขียนทั้งสองอย่าง และเข้าใจผลของ eventual consistency
เลือกที่เก็บ
| KV | R2 | D1 (บท 04) | |
|---|---|---|---|
| รูปแบบ | key → value (สูงสุด 25 MiB) | object storage (S3-compatible) | SQL (SQLite) |
| เด่น | อ่านเร็วมากทั่วโลก (cache ที่ edge) | ไฟล์ใหญ่, ไม่มีค่า egress | query, join, transaction |
| ความสอดคล้อง | eventual — เขียนแล้วที่อื่นอาจยังเห็นค่าเก่าสักพัก | strong (อ่านหลังเขียนเห็นทันที) | strong ใน DB หลัก |
| เขียน | ช้า/จำกัด: 1 ครั้ง/วินาทีต่อ key | ได้เยอะ | ได้เยอะ (ทีละ DB) |
| เหมาะกับ | config, feature flag, redirect map, cache ผล API, session ที่อ่านเยอะ | รูป, วิดีโอ, backup, ไฟล์ผู้ใช้อัปโหลด, ไฟล์ export | ข้อมูลที่มีความสัมพันธ์, ตัวนับ, รายการคำสั่งซื้อ |
| ไม่เหมาะ | ตัวนับ, ข้อมูลที่ต้องอ่านหลังเขียนทันที | ค้นหาตามเงื่อนไข | ไฟล์ใหญ่ |
ตัวนับยอดวิว/สต็อกสินค้าห้ามใช้ KV — เขียนชนกันหาย + เกิน 1 write/s/key → ใช้ D1 หรือ Durable Objects (ระดับ 5c)
ตัวเลขที่ต้องรู้
| KV | Free |
|---|---|
| อ่าน | 100,000 / วัน |
| เขียน (คนละ key) | 1,000 / วัน |
| เขียน key เดิม | 1 / วินาที (ทุกแพลน) |
cacheTtl ขั้นต่ำ |
30 วินาที |
| R2 (Standard) | ฟรีต่อเดือน | เกินแล้ว |
|---|---|---|
| storage | 10 GB-เดือน | $0.015 / GB-เดือน |
| Class A (เขียน, list) | 1 ล้านครั้ง | คิดตามจำนวน |
| Class B (อ่าน) | 10 ล้านครั้ง | คิดตามจำนวน |
| egress (ดาวน์โหลดออก) | ฟรีเสมอ | ฟรี |
| เทียบ S3: ค่าโอนข้อมูลออกอินเทอร์เน็ตมักเป็นก้อนใหญ่สุดของบิลไฟล์สื่อ — R2 ไม่มีส่วนนี้ (free tier ใช้กับ Standard เท่านั้น ไม่ใช่ Infrequent Access) |
API ที่ใช้บ่อย
// KV
await env.LINKS.get(key); // string | null
await env.LINKS.get(key, { type: "json", cacheTtl: 300 });
await env.LINKS.put(key, value, { expirationTtl: 3600, metadata: { by: "admin" } });
await env.LINKS.list({ prefix: "promo-" }); // { keys, list_complete, cursor }
await env.LINKS.delete(key);
// R2
await env.FILES.put(key, request.body, { httpMetadata: { contentType: "image/png" } });
const obj = await env.FILES.get(key); // R2ObjectBody | null
await env.FILES.head(key); // metadata อย่างเดียว ไม่ดึง body
await env.FILES.list({ prefix: "uploads/", limit: 100 });
await env.FILES.delete(key);ลองเลย 🧪
⚠️ R2 ต้องเปิดใช้ในแดชบอร์ดก่อน (มักต้องผูกวิธีชำระเงินแม้ใช้ไม่เกินโควตาฟรี) — ใช้แค่ไฟล์ทดสอบเล็กๆ และลบทิ้งตอนจบจะไม่มีค่าใช้จ่าย
ทดลอง A — สร้างโปรเจกต์ + KV + R2
cd ~/cloud-ladder
npm create cloudflare@latest -- edge-store --type=hello-world --lang=ts --no-deploy --git
cd edge-store
npx wrangler kv namespace create LINKS
npx wrangler r2 bucket create edge-store-files-[ชื่อเล่นคุณ]ผลที่ควรเห็น (ย่อ):
✨ Success!
... add the following to your configuration file ...
"kv_namespaces": [ { "binding": "LINKS", "id": "f0e1d2c3b4a5..." } ]
✅ Created bucket 'edge-store-files-ton' with default storage class of Standard.wrangler.jsonc (วาง id ที่ได้จริง)
{
"$schema": "node_modules/wrangler/config-schema.json",
"name": "edge-store",
"main": "src/index.ts",
"compatibility_date": "2026-09-01",
"observability": { "enabled": true },
"kv_namespaces": [{ "binding": "LINKS", "id": "[KV_NAMESPACE_ID]" }],
"r2_buckets": [{ "binding": "FILES", "bucket_name": "edge-store-files-[ชื่อเล่นคุณ]" }]
}echo 'ADMIN_TOKEN="local-dev-only-token"' > .dev.vars
grep -q '^.dev.vars' .gitignore || echo '.dev.vars*' >> .gitignore
npx wrangler typesทดลอง B — ลิงก์ย่อ (KV) + อัปโหลดไฟล์ (R2) แทนที่ src/index.ts
const json = (data: unknown, status = 200) => Response.json(data, { status });
function isAdmin(request: Request, env: Env): boolean {
const a = new TextEncoder().encode(request.headers.get("authorization") ?? "");
const b = new TextEncoder().encode(`Bearer ${env.ADMIN_TOKEN}`);
if (!env.ADMIN_TOKEN) return false; // ยังไม่ได้ตั้ง secret → ปฏิเสธเสมอ
return a.byteLength === b.byteLength && crypto.subtle.timingSafeEqual(a, b);
}
export default {
async fetch(request, env): Promise<Response> {
const url = new URL(request.url);
const [, area = "", ...rest] = url.pathname.split("/");
const key = decodeURIComponent(rest.join("/"));
const write = ["PUT", "DELETE"].includes(request.method);
if (write && !isAdmin(request, env)) return json({ error: "unauthorized" }, 401);
// ---------- /s/<slug> : ลิงก์ย่อใน KV ----------
if (area === "s" && key) {
if (request.method === "PUT") {
const target = (await request.text()).trim();
if (!/^https:\/\//.test(target)) return json({ error: "target ต้องขึ้นต้นด้วย https://" }, 400);
await env.LINKS.put(key, target, { metadata: { createdAt: new Date().toISOString() } });
return json({ slug: key, target }, 201);
}
if (request.method === "DELETE") {
await env.LINKS.delete(key);
return json({ deleted: key });
}
const target = await env.LINKS.get(key, { cacheTtl: 60 });
return target ? Response.redirect(target, 302) : json({ error: "ไม่พบลิงก์" }, 404);
}
// ---------- /files/<key> : ไฟล์ใน R2 ----------
if (area === "files") {
if (!key && request.method === "GET") {
const listed = await env.FILES.list({ limit: 50 });
return json(listed.objects.map((o) => ({ key: o.key, size: o.size, uploaded: o.uploaded })));
}
if (request.method === "PUT") {
const obj = await env.FILES.put(key, request.body, {
httpMetadata: { contentType: request.headers.get("content-type") ?? "application/octet-stream" },
});
return json({ key: obj?.key, size: obj?.size, etag: obj?.etag }, 201);
}
if (request.method === "DELETE") {
await env.FILES.delete(key);
return json({ deleted: key });
}
const obj = await env.FILES.get(key);
if (!obj) return json({ error: "ไม่พบไฟล์" }, 404);
const headers = new Headers();
obj.writeHttpMetadata(headers);
headers.set("etag", obj.httpEtag);
headers.set("cache-control", "public, max-age=300");
return new Response(obj.body, { headers });
}
return json({ error: "not found" }, 404);
},
} satisfies ExportedHandler<Env>;npx tsc --noEmit && npx wrangler devอีก terminal (ข้อมูลตอน dev อยู่ในเครื่อง ไม่แตะของจริง)
T="Authorization: Bearer local-dev-only-token"
curl -s -X PUT -H "$T" --data "https://developers.cloudflare.com/kv/" http://localhost:8787/s/kv-docs
curl -sI http://localhost:8787/s/kv-docs | grep -iE "^HTTP|^location"
echo "สวัสดี R2" > hello.txt
curl -s -X PUT -H "$T" -H "Content-Type: text/plain; charset=utf-8" --data-binary @hello.txt http://localhost:8787/files/notes/hello.txt
curl -s http://localhost:8787/files/notes/hello.txt
curl -s http://localhost:8787/files/
curl -s -o /dev/null -w "%{http_code}\n" -X PUT --data "x" http://localhost:8787/files/hack.txtผลที่ควรเห็น:
{"slug":"kv-docs","target":"https://developers.cloudflare.com/kv/"}
HTTP/1.1 302 Found
Location: https://developers.cloudflare.com/kv/
{"key":"notes/hello.txt","size":22,"etag":"..."}
สวัสดี R2
[{"key":"notes/hello.txt","size":22,"uploaded":"2026-10-09T..."}]
401ทดลอง C — ขึ้นของจริง แล้วสังเกต eventual consistency
npx wrangler deploy
openssl rand -hex 24 | tee /dev/tty | npx wrangler secret put ADMIN_TOKEN # จดค่าที่แสดงไว้ใช้ทดสอบ แล้ว clear terminal
npx wrangler kv key put --binding LINKS promo "https://example.com/promo" --remote
npx wrangler kv key get --binding LINKS promo --remote
npx wrangler r2 object put "edge-store-files-[ชื่อเล่นคุณ]/notes/hello.txt" --file hello.txt --content-type "text/plain; charset=utf-8" --remote
curl -sI "https://edge-store.[your-subdomain].workers.dev/s/promo" | grep -i "^location"ผลที่ควรเห็น: https://example.com/promo จาก kv key get และ header location: https://example.com/promo — ถ้าแก้ค่า promo แล้วเรียกทันที บาง request อาจยังได้ค่าเก่า (เพราะ cacheTtl 60 วินาที + การกระจายค่าทั่วโลกต้องใช้เวลา) นี่คือ eventual consistency
เก็บกวาด
npx wrangler r2 object delete "edge-store-files-[ชื่อเล่นคุณ]/notes/hello.txt" --remote
npx wrangler delete
npx wrangler r2 bucket delete edge-store-files-[ชื่อเล่นคุณ]
npx wrangler kv namespace list | grep -B1 -A1 LINKS # ดู id
npx wrangler kv namespace delete --namespace-id [KV_NAMESPACE_ID]
rm hello.txt(bucket ต้องว่างก่อนถึงลบได้ — ถ้าอัปโหลดผ่าน API ไว้หลายไฟล์ ให้ลบทุก object ก่อน)
กับดักที่เจอบ่อย
| อาการ | สาเหตุ / แก้ |
|---|---|
| แก้ค่าใน KV แล้วบางคนยังเห็นค่าเก่า | eventual consistency + cacheTtl → อย่าใช้ KV กับข้อมูลที่ต้องเห็นทันที |
429 / ค่าตัวนับหาย |
เขียน key เดียวกันถี่เกิน 1 ครั้ง/วินาที → D1 หรือ Durable Objects |
wrangler kv key put แล้ว Worker บน production ไม่เห็น |
ลืม --remote → ค่าไปอยู่ใน storage จำลองในเครื่อง |
| อัปโหลด R2 จาก stream แล้ว error เรื่องความยาว | body ไม่มี Content-Length → ส่งแบบรู้ขนาด (--data-binary) หรืออ่านเป็น ArrayBuffer ก่อน |
| ใครก็อัปโหลด/ลบไฟล์ได้ | endpoint เขียนไม่มี auth → ตรวจ token ทุก method ที่ไม่ใช่ GET |
| ลบ bucket ไม่ได้ | ยังมี object ค้าง → ลบให้หมดก่อน |
เปิด r2.dev URL ทิ้งไว้ |
public ทั้ง bucket และไม่มี WAF/cache ของโซน → ถ้าจะ public ใช้ custom domain หรือเสิร์ฟผ่าน Worker |
สรุปจำง่าย
KV = อ่านเยอะ เขียนน้อย ยอมช้าได้สักพัก — R2 = ไฟล์ ไม่มีค่า egress — ตัวนับ/ข้อมูลสัมพันธ์ไป D1 — คำสั่ง wrangler กับข้อมูลจริงใส่
--remoteเสมอ — endpoint เขียนต้องมี auth