دليل شامل لمسح ذاكرة التخزين المؤقت في Cloudflare: دليل شامل لمسؤولي الويب ومسؤولي DevOps

كيف يؤثر مسح ذاكرة التخزين المؤقت لـ Cloudflare على عملية النشر واستكشاف الأخطاء وإصلاحها؟

يُعدّ مسح ذاكرة التخزين المؤقت لـ Cloudflare خطوةً أساسيةً في دورة إصدار المواقع الإلكترونية والتطبيقات وحلّ مشاكلها. يُغطي هذا الدليل العملي والمتخصص أساليب التنظيف، ونصائح الأمان، وأوامر سطر الأوامر، والأتمتة في التكامل المستمر/التسليم المستمر (CI/CD)، وإعدادات Nginx/Apache وWordPress، بحيث يتمكن مديرو المواقع، وفرق DevOps، وفرق التطوير، والمتداولون، واللاعبون من نشر التغييرات بسرعة وأمان إلى الحافة (أكثر من 85 موقعًا عالميًا) بعد التحديث أو إصلاح الأخطاء.

لماذا من الضروري مسح ذاكرة التخزين المؤقت لـ Cloudflare؟

مسح ذاكرة التخزين المؤقت هذا ضروري عندما تتسبب الإصدارات القديمة من المحتوى (مثل CSS/JS/images أو HTML المخزنة مؤقتًا في Edge) في مشاكل عرض أو أداء غير صحيحة.

• بعد تحديث الملفات الثابتة أو محتوى HTML المخزن مؤقتًا في متصفح Edge.
• بعد نشر تطبيق أو ترحيله، يجب عرض الإصدار الجديد فورًا في Edges.
• لإصلاح مشاكل العرض أو الأخطاء المتعلقة بالمحتوى القديم.
• في السيناريوهات الحساسة للوقت مثل التداول أو الألعاب، يجب تحديث المحتوى المباشر على الفور.

أنواع مسح ذاكرة التخزين المؤقت في كلاود فلير

1) تخلص من كل شيء

مسح جميع ذاكرات التخزين المؤقت في منطقة معينة. عملية سريعة وبسيطة، ولكن مكلف وأحياناً يزيد ذلك من الضغط على المصدر.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"purge_everything":true}'

2) الحذف حسب عنوان URL (الحذف الانتقائي حسب عنوان URL)

حذف ملفات أو صفحات محددة؛ الخيار الأفضل لتحديث أصول أو صفحات محددة لتجنب الآثار الجانبية للحذف الكامل.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"files":["https://example.com/css/app.css","https://example.com/js/app.js"]}'

3) الحذف حسب الوسم — متقدم

التنظيف حسب الوسم مناسب لإبطال صلاحية مجموعة من الموارد التي تحمل علامة معينة؛ مفيد في التطبيقات المعقدة والخدمات المصغرة.

ملحوظة: قد تختلف هذه الميزة في بعض الخطط أو حسابات المؤسسات.

curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
--data '{"tags":["product-123","homepage-v2"]}'

4) وضع التطوير وتجاوز ذاكرة التخزين المؤقت

يؤدي وضع التطوير من لوحة التحكم إلى تعطيل التخزين المؤقت في متصفح Edge لمدة 3 ساعات - وهو مثالي للتطوير قصير المدى.

لتجاوز مسارات واجهة برمجة التطبيقات أو بناءً على ملفات تعريف الارتباط من قواعد الصفحة أو العمال يستخدم.

الحصول على معرّف المنطقة وإنشاء رمز API بأقل قدر من الوصول

يمكنك استخدام واجهة برمجة التطبيقات (API) للحصول على معرّف المنطقة؛ في حقل الاستجابة بطاقة تعريف وهو نفس معرف المنطقة.

curl -X GET "https://api.cloudflare.com/client/v4/zones?name=example.com" \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json"

لإنشاء رمز API، انتقل إلى المسار كلاود فلير ← ملفي الشخصي ← رموز API ← إنشاء رمز امنح الأذونات الضرورية فقط. عادةً ما يكون الإذن المنطقة ← مسح ذاكرة التخزين المؤقت يكفي ذلك لبعض المناطق. تقييد الرموز بمنطقة محددة وتحديد تاريخ انتهاء صلاحيتها يزيد الأمن بشكل ملحوظ.

التحقق من حالة ذاكرة التخزين المؤقت للاستجابة (cf-cache-status)

لتصحيح الأخطاء من رأس الملف حالة ذاكرة التخزين المؤقت cf الاستخدام، وقيمه النموذجية هي: يضرب, يفتقد, منتهي الصلاحية, متحرك, تجاوز, تم التحقق من صحتها.

curl -I -s -D - https://example.com | grep -i cf-cache-status

نصائح حول تكوين الخادم وعناوين الملفات (Nginx/Apache)

للملفات الثابتة (المضغوطة وغير القابلة للتغيير)

يُعد استخدام Cache-Control طويل الأمد جنبًا إلى جنب مع بصمة الملف (التجزئة على اسم الملف) أفضل نهج للأصول لتقليل الحاجة إلى عملية تنظيف كاملة.

location ~* \.(js|css|jpg|jpeg|png|svg|woff2?)$ {
    expires 30d;
    add_header Cache-Control "public, max-age=2592000, s-maxage=2592000, immutable";
}

هذا الإعداد يُضاف إلى الإعدادات الأخرى تخزين كل شيء مؤقتًا / مدة صلاحية التخزين المؤقت على الحافة تتسبب خدمة Cloudflare في تخزين الأصول على الحافة لفترة طويلة.

لصفحات HTML (قابلة للتحديث)

location / {
    add_header Cache-Control "no-cache, must-revalidate, max-age=0";
}

في Cloudflare، يمكنك ضبط قيمة أقل لوقت بقاء ذاكرة التخزين المؤقت Edge Cache أو استخدام قواعد الصفحات لمزيد من التحكم في الصفحات المهمة.

احترم رأسية الأصل

في لوحة تحكم Cloudflare، يوجد خيار في قسم التخزين المؤقت يحدد ما إذا كان Cloudflare سيعتمد على رؤوس المصدر أم سيستخدم إعداداته الخاصة. يُنصح بتفعيل هذا الخيار لمزيد من التحكم. التحكم في ذاكرة التخزين المؤقت للأصل يستخدم.

التكامل مع ووردبريس والإضافات

تتيح إضافة Cloudflare الرسمية لـ WordPress إمكانية الحذف التلقائي بعد النشر أو التحديث.

• تحتوي إضافات التخزين المؤقت مثل WP Rocket أو W3 Total Cache على خيارات تنظيف محلية؛ استخدم التنظيف مع Cloudflare في نفس الوقت لتحديث الحافة أيضًا.
• بالنسبة للمواقع الحيوية (مواقع التداول أو مواقع الألعاب)، قم بتقصير إعدادات TTL وقم بتمكين التطهير الانتقائي للحفاظ على زمن الاستجابة والاستقرار.

أتمتة تنظيف ذاكرة التخزين المؤقت في التكامل المستمر/التسليم المستمر

أضف خطوة بسيطة لحذف عناوين URL المُنشأة بعد النشر التلقائي (GitHub Actions / GitLab CI / Jenkins). تأكد من استخدام إدارة الأسرار لتخزين الرموز المميزة.

- name: Purge Cloudflare cache
  run: |
    curl -X POST "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/purge_cache" \
    -H "Authorization: Bearer ${{ secrets.CF_API_TOKEN }}" \
    -H "Content-Type: application/json" \
    --data "{\"files\": [\"https://example.com/path/to/file.js\"]}"

برامج نصية لنظام لينكس لتنظيف الملفات دفعة واحدة

لحذف قائمة عناوين URL، يمكنك استخدام ملف و jq. ولتحسين الأداء، قسّم الدُفعات إلى 30 دفعة وشغّلها بالتوازي.

cat urls.txt | jq -R -s -c 'split("\n")[:-1]' | \
xargs -I{} curl -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/purge_cache" \
 -H "Authorization: Bearer <API_TOKEN>" -H "Content-Type: application/json" \
 --data '{"files":'{}'}'

نصائح وقيود أمنية

الحد الأدنى من الصلاحيات بالنسبة لرمز API: فقط "مسح ذاكرة التخزين المؤقت" ويقتصر على المناطق الضرورية؛ حدد تاريخ انتهاء الصلاحية.

• حدود المعدل: واجهة برمجة تطبيقات التطهير لها حدود للطلبات؛ تجنب تطهير كل شيء باستمرار واستخدم عمليات التطهير المجمعة عند الحاجة.
• التسجيل: سجل كل عملية حذف في سجلات CI أو سجلات النظام لمعرفة السبب والوقت - وهو أمر مفيد لعمليات التدقيق.

حالات خاصة - العمال، وKV، والمعالجة/وحدة معالجة الرسومات

إذا كنت تستخدم Cloudflare Workers، فقد لا يؤدي مسح ذاكرة التخزين المؤقت القياسية للمنطقة إلى مسح ذاكرة التخزين المؤقت لـ Workers؛ في كود Worker، استخدم cache.delete واستخدم محاليل خاصة.

بالنسبة للملفات الكبيرة مثل النماذج أو ملفات العرض، استخدم خاصية Cache-Control طويلة المدى للملفات غير القابلة للتغيير والتنظيف الانتقائي للتحديثات.

بالنسبة للمستخدمين الحساسين مثل المتداولين واللاعبين، يعد اختيار الموقع المناسب وتكوين شبكة توصيل المحتوى (CDN) أمرًا مهمًا لتقليل زمن الاستجابة (ping)؛ يجب تكوين التخزين المؤقت بذكاء للحفاظ على المحتوى المهم محدثًا.

أفضل الممارسات والنصائح العملية

• استخدم خاصية "تطهير كل شيء" فقط كملاذ أخير. يستخدم.
• استخدم خاصية الحذف حسب عنوان URL أو العلامات لتقليل الآثار الجانبية.
• العناوين التحكم في ذاكرة التخزين المؤقت اضبط نقطة الأصل بشكل صحيح.
• بالنسبة للمحتوى الثابت، استخدم ذاكرة التخزين المؤقت طويلة الأمد + بصمة الموقع لنشر ملفات جديدة دون الحاجة إلى حذف كامل.
• استخدم قواعد الصفحات أو عمال Cloudflare للمسارات الحساسة أو واجهات برمجة التطبيقات التي تحتاج إلى تجاوزها.
• الأتمتة: دمج عملية حذف الحالات (الملفات الجديدة) مع التكامل المستمر بعد كل عملية نشر.
• الأمان: استخدم الرموز المميزة المقيدة وقم بمراجعة الوصول بشكل دوري.

للحفاظ على التوازن بين السرعة والاستقرار، فإن الجمع بين رؤوس العادم الأصلية ورؤوس التطهير الاختيارية يعطي أفضل النتائج.

خاتمة

قد يبدو مسح ذاكرة التخزين المؤقت لـ Cloudflare مهمة بسيطة، لكنها تتطلب فهم أنواع عمليات المسح، والعناوين، وتأثيراتها على الأداء والأمان. مع التكوين الصحيح، بما في ذلك Origin Cache-Control، والوسوم، وعمليات المسح الانتقائية، يمكنك الحفاظ على سرعة واستقرار تطبيقك، خاصةً في البنى التحتية التي تضم أكثر من 85 موقعًا عالميًا وتستخدم خوادم GPU، أو خوادم VPS مخصصة، أو خدمات مكافحة هجمات DDoS.

إذا كنت ترغب في معرفة المزيد عن الخطط أو إعدادات التخزين المؤقت والأتمتة بعد الإصدار، يمكنك الاطلاع على الموارد والصفحات ذات الصلة أو الاتصال بفريق الدعم.

الأسئلة الشائعة