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

Cache ให้เว็บเร็ว — Cache Rules, cache key, TTL, purge และ cf-cache-status

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

เป้าหมาย

อ่าน header cf-cache-status แล้วบอกได้ทันทีว่าทำไม cache ติดหรือไม่ติด ตั้ง Cache Rules ให้ cache เฉพาะสิ่งที่ควร (ไม่ cache หน้า login) คุม TTL ทั้งที่ edge และเบราว์เซอร์ และ purge เมื่อ deploy ใหม่

Cloudflare cache อะไรเองบ้าง (ไม่ตั้งอะไรเลย)

  • cache ตาม นามสกุลไฟล์ ไม่ใช่ MIME type: css js jpg png gif svg webp avif woff2 pdf zip mp4 ... และ robots.txt
  • HTML และ JSON ไม่ cache โดยปริยาย — เว็บที่หน้า HTML ช้า ต้องตั้ง Cache Rule เอง
  • ไม่ cache เมื่อ origin ตอบ Set-Cookie หรือ Cache-Control: private / no-store / no-cache / max-age=0
  • ถ้า origin ไม่ส่ง Cache-Control เลย ใช้ TTL ตาม status: 200/206/301 = 120 นาที · 302/303 = 20 นาที · 404/410 = 3 นาที

อ่าน cf-cache-status ให้เป็น

ค่า ความหมาย ทำอะไรต่อ
HIT เสิร์ฟจาก cache 🎉
MISS cache ได้แต่ยังไม่มี ไปเอาที่ origin ยิงซ้ำ ควรกลายเป็น HIT
EXPIRED มีแต่หมดอายุ ไปเอาใหม่ ปกติ
REVALIDATED ถาม origin ด้วย ETag/Last-Modified แล้วของเดิมยังใช้ได้ ปกติ ประหยัด bandwidth
UPDATING / STALE เสิร์ฟของเก่าระหว่างรีเฟรช / เพราะ origin ล่ม ดีต่อ uptime
BYPASS ขอ cache ได้ แต่ origin ตอบว่าห้าม (Set-Cookie, no-store) ดู header จาก origin
DYNAMIC ไม่เข้าเงื่อนไข cache เลย (เช่น HTML ที่ไม่มี rule) ตั้ง Cache Rule ถ้าควร cache
NONE/UNKNOWN Cloudflare สร้างคำตอบเอง (Worker, redirect, WAF block) ปกติสำหรับ Workers

Workers ไม่ได้ใช้ Cache Rules แบบเดียวกัน — Worker รัน ก่อน cache ของโซน คำตอบจาก Worker/static assets จึงเห็น NONE หรือไม่มี header นี้เลย (static assets มีชั้น cache ของตัวเองอยู่แล้ว) — Cache Rules มีผลกับ record ที่มี origin จริง และกับ fetch() ที่ Worker ยิงออกไป

Cache Rules — ตัวเลือกที่ใช้บ่อย

ตัวเลือก ค่า ใช้เมื่อ
Cache eligibility Eligible for cache / Bypass cache เลือกว่า cache หรือไม่
Edge TTL ใช้ Cache-Control ถ้ามี (ไม่มี → bypass หรือ → ค่าปริยาย) / Ignore cache-control header and use this TTL origin ไม่ส่ง header ดีๆ → override
Browser TTL Respect origin / Override origin / Bypass อยากให้ edge จำนาน แต่เบราว์เซอร์จำสั้น
Cache Key Cache deception armor, Cache by device type, Sort query string (Ignore query string เฉพาะบางแพลน) กัน cache แตกเพราะ ?utm=
Serve stale content while revalidating เปิด/ปิด ให้ผู้ใช้ไม่ต้องรอ origin
Respect Strong ETags / Origin error page pass-through เปิด/ปิด กรณีเฉพาะ

Free plan สร้างได้ 10 rules ต่อโซน · Cache Rules ซ้อนกันได้: ทุกกฎที่ตรงถูกนำมาใช้ และถ้าตั้งค่าเดียวกันขัดกัน กฎที่อยู่ "ล่างสุด" ชนะ → วางกฎทั่วไปไว้บน กฎ bypass ไว้ท้ายสุด ตัวอย่างชุดกฎที่ดีสำหรับเว็บทั่วไป (เรียงตามลำดับจริง):

  1. หน้า HTML สาธารณะ → Eligible, Edge TTL 1 ชั่วโมง, Browser TTL Respect origin (ให้ purge ได้ทันที)
  2. path เริ่มด้วย /assets/ (ไฟล์ที่มี hash ในชื่อ) → Eligible, Edge TTL 1 ปี (ignore header), Browser TTL 1 ปี
  3. path เริ่มด้วย /admin หรือ /api หรือมี cookie session → Bypass cache (อยู่ท้ายสุดเพื่อชนะกฎข้างบน)

Cache key — ทำไม cache hit ratio ต่ำ

cache key = URL เต็ม (host + path + query string) — /?utm_source=a กับ /?utm_source=b คือ คนละ object → MISS ตลอด

  • เรียง query string (Sort query string) ช่วยให้ ?a=1&b=2 = ?b=2&a=1
  • Cache deception armor: กันการหลอกให้ cache หน้า private ด้วย URL แบบ /account/profile.jpg
  • ห้าม cache หน้าที่ต่างกันตามผู้ใช้ (ตะกร้า, profile) — ข้อมูลคนหนึ่งจะโผล่ให้อีกคนเห็น

Purge

วิธี ใช้เมื่อ
ตาม URL (single-file) แก้ไฟล์ไม่กี่ไฟล์ — Free ได้ 800 URL/วินาที สูงสุด 100 URL ต่อคำขอ
ตาม hostname / tag / prefix deploy ใหม่ทั้งส่วน (ทุกแพลนใช้ได้แล้ว)
Purge Everything ทางสุดท้าย — origin จะโดนถล่มชั่วคราว
Free: purge แบบ hostname/tag/prefix/everything ได้ 5 ครั้ง/นาที · ทางที่ดีกว่า purge คือใส่ hash ในชื่อไฟล์ (app.3f9a1c.js) แล้ว cache ยาวไปเลย

ลองเลย 🧪

ทดลอง A — อ่าน header cache ของเว็บจริง (ไม่ต้องมีอะไร)

URL=https://developers.cloudflare.com/favicon.png
for i in 1 2; do curl -sI "$URL" | grep -iE "^cf-cache-status|^age|^cache-control"; echo ---; done
curl -sI https://developers.cloudflare.com/ | grep -iE "^cf-cache-status|^cache-control"

ผลที่ควรเห็น (ค่าจริงอาจต่าง):

cache-control: public, max-age=...
cf-cache-status: HIT
age: 1234
---
...
cf-cache-status: HIT  (หรือ DYNAMIC สำหรับ HTML ถ้าไม่มี rule)

→ age = วินาทีที่ object อยู่ใน cache แล้ว

ทดลอง B — ตั้ง Cache Rule บนโฮสต์ที่มี origin จริง ผ่าน API ต้องมี hostname ที่ proxied และชี้ไป origin จริง (เช่น เซิร์ฟเวอร์ของคุณ หรือ static.example.com → CloudFront ในบท 05 — ถ้ายังไม่มี ทำทดลองนี้หลังบท 05) และ token ที่มีสิทธิ์ Zone › Cache Rules › Edit + Cache Purge (ใช้ตัวแปร CLOUDFLARE_API_TOKEN, ZONE_ID แบบเดียวกับบท 01)

HOST=[static.example.com]
curl -s -o /dev/null -D - "https://$HOST/" | grep -iE "^cf-cache-status|^cache-control"   # ก่อนตั้ง: HTML มักเป็น DYNAMIC

⚠️ คำสั่งนี้ แทนที่ Cache Rules ทั้งหมดของโซน — ถ้ามีกฎอยู่แล้วให้ตั้งในแดชบอร์ดแทน (หน้า Cache Rules) · กฎ bypass อยู่ ท้ายสุด เพราะกฎที่ตรงทีหลังชนะ

cat > cache-rules.json <<EOF
{
  "rules": [
    {
      "description": "lab: cache html 1h at edge",
      "expression": "(http.host eq \"$HOST\")",
      "action": "set_cache_settings",
      "action_parameters": {
        "cache": true,
        "edge_ttl": { "mode": "override_origin", "default": 3600 },
        "browser_ttl": { "mode": "respect_origin" }
      }
    },
    {
      "description": "lab: bypass admin and api",
      "expression": "(http.host eq \"$HOST\" and (starts_with(http.request.uri.path, \"/admin\") or starts_with(http.request.uri.path, \"/api\")))",
      "action": "set_cache_settings",
      "action_parameters": { "cache": false }
    }
  ]
}
EOF
curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/phases/http_request_cache_settings/entrypoint" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" -H "Content-Type: application/json" \
  --data @cache-rules.json | jq '{success, rules: [.result.rules[]?.description]}'
sleep 20
for i in 1 2 3; do curl -s -o /dev/null -D - "https://$HOST/" | grep -i "^cf-cache-status"; done

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

{ "success": true, "rules": ["lab: cache html 1h at edge", "lab: bypass admin and api"] }
cf-cache-status: MISS
cf-cache-status: HIT
cf-cache-status: HIT

ถ้ายังเป็น BYPASS: origin ส่ง Set-Cookie หรือ no-store — แก้ที่ origin หรือดูว่าหน้านั้นควร cache จริงไหม

ทดลอง C — purge URL เดียวแล้วดูว่ากลับเป็น MISS

curl -s -X POST "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/purge_cache" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" -H "Content-Type: application/json" \
  --data "{\"files\":[\"https://$HOST/\"]}" | jq -c '{success}'
sleep 5
curl -s -o /dev/null -D - "https://$HOST/" | grep -i "^cf-cache-status"

ผลที่ควรเห็น: {"success":true} แล้ว cf-cache-status: MISS (ครั้งต่อไปกลับเป็น HIT)

เก็บกวาด — ลบกฎ lab (ตั้ง entrypoint เป็นชุดว่าง) แล้วลบไฟล์

curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/rulesets/phases/http_request_cache_settings/entrypoint" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" -H "Content-Type: application/json" \
  --data '{"rules":[]}' | jq -c '{success}'
rm cache-rules.json

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

อาการ สาเหตุ / แก้
HTML เป็น DYNAMIC ตลอด HTML ไม่ cache โดยปริยาย → เพิ่ม Cache Rule
BYPASS ทั้งที่มี rule origin ส่ง Set-Cookie / no-store (เช่น framework ใส่ session cookie ทุกหน้า)
ผู้ใช้ A เห็นชื่อผู้ใช้ B cache หน้าที่มีข้อมูลส่วนตัว → bypass ตาม cookie session หรือ path
ตั้ง bypass แล้วแต่ /admin ยัง HIT กฎ bypass อยู่ ก่อน กฎ cache ทั้งโฮสต์ → กฎที่ตรงทีหลังชนะ ย้าย bypass ไปท้ายสุด
hit ratio ต่ำมาก query string สุ่ม (utm_*, fbclid) แตก cache key → เรียง/ตัด query หรือ Transform Rule (บท 04)
deploy แล้วผู้ใช้ยังเห็นของเก่า Browser TTL ยาว (purge ล้างได้แค่ edge ไม่ได้ล้างเบราว์เซอร์) → HTML ใช้ Respect origin + ไฟล์ asset ใส่ hash
Worker ไม่เห็น cf-cache-status ปกติ — Worker รันก่อน cache ของโซน

สรุปจำง่าย

HTML ไม่ cache เอง — อ่าน cf-cache-status ก่อนเดา — Bypass หน้าส่วนตัวก่อน แล้วค่อย cache ที่เหลือ — Edge TTL ยาวได้เพราะ purge ได้ Browser TTL ต้องสั้นเพราะ purge ไม่ถึง — ไฟล์ asset ใส่ hash แล้ว cache 1 ปี