เป้าหมาย
อ่าน 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 ไว้ท้ายสุด ตัวอย่างชุดกฎที่ดีสำหรับเว็บทั่วไป (เรียงตามลำดับจริง):
- หน้า HTML สาธารณะ → Eligible, Edge TTL 1 ชั่วโมง, Browser TTL Respect origin (ให้ purge ได้ทันที)
- path เริ่มด้วย
/assets/(ไฟล์ที่มี hash ในชื่อ) → Eligible, Edge TTL 1 ปี (ignore header), Browser TTL 1 ปี - 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 ปี