لماذا لا تظهر صوري؟

الصور المعطّلة تُزعج القراء وتُحرج الكتّاب. الخبر الجيد أن أعطال الصور في VeloCMS تعود دائماً تقريباً إلى أحد أربعة أسباب جذرية، ولكل منها حل واضح. لنستعرضها بالترتيب وفق احتمالية الحدوث.

ابدأ بفحص وحدة تحكم المتصفح

افتح الصفحة التي تحتوي الصورة المعطّلة، انقر بزر الماوس الأيمن ← Inspect، وانتقل إلى علامة تبويب Console. أعطال الصور تُنتج عادةً أحد ثلاثة أنواع من الأخطاء: خطأ 403 Forbidden (مشكلة في الصلاحيات أو حماية الروابط)، خطأ CORS (ترويسات cross-origin مفقودة في حاوية R2)، أو net::ERR_FAILED (مشكلة في DNS أو الشبكة). الخطأ المحدد يُحدد القسم التالي الذي يجب الانتقال إليه.

ضبط CORS في حاوية R2

حاويات Cloudflare R2 لا تُفعّل CORS افتراضياً. إذا كنت تقدّم صورك من حاوية Cloudflare R2 خاصة بك، تحتاج إلى إضافة قاعدة CORS تسمح بطلبات GET من نطاق مدونتك. بدون ذلك، يمنع المتصفح تحميل الصور عندما تُقدَّم الصفحة من أصل مختلف عن الحاوية.

[{"AllowedOrigins":["https://yourdomain.com","https://yourblog.velocms.org"],"AllowedMethods":["GET","HEAD"],"AllowedHeaders":["*"],"ExposeHeaders":["ETag"],"MaxAgeSeconds":86400}]

طبّق ذلك عبر لوحة تحكم Cloudflare R2: انتقل إلى R2 ← حاويتك ← Settings ← CORS Policy ← Edit CORS Policy. الصق شيفرة JSON أعلاه مع استبدال قيم النطاق بنطاقك الفعلي. احفظ وانتظر 30 ثانية لانتشار السياسة. ثم أعد تحميل الصفحة التي تحتوي الصور المعطّلة قسراً (Ctrl+Shift+R على Windows/Linux، Cmd+Shift+R على Mac).

تأخر نشر ذاكرة CDN

بعد رفع صورة عبر لوحة التحكم ← الوسائط، تخزّنها VeloCMS في R2 وتُقدّمها عبر شبكة CDN الخاصة بـ Cloudflare. في المرة الأولى التي يحمّل فيها أحد القراء رابط تلك الصورة، تجلبها Cloudflare من R2 وتخزّنها في حافة الشبكة. تكون التحميلات اللاحقة سريعة. لكن إذا رفعتَ صورة ونشرتَ المقال فوراً، ثمة فترة قصيرة (عادةً 10 إلى 60 ثانية) لم تُخزّن فيها عقدة CDN الأقرب لقارئك الصورة بعد. إذا أفاد قارئ بأن صورة كانت معطّلة لحظة نشر المقال وهي الآن تعمل، فتأخر النشر هذا هو على الأرجح السبب.

حماية الروابط المباشرة

إذا فعّلتَ حماية الروابط المباشرة (Hotlink Protection) في Cloudflare (لوحة Cloudflare ← Scrape Shield ← Hotlink Protection)، ستحجب Cloudflare طلبات الصور القادمة من مواقع أخرى. قد يُؤثر ذلك على صورك الخاصة أيضاً إذا لم يكن نطاق مدونتك في قائمة السماح. تحقق من Cloudflare ← Scrape Shield ← Hotlink Protection وأضف نطاق مدونتك (وأي نطاقات معاينة كالنطاق الفرعي .velocms.org) إلى قائمة السماح.

نوع MIME وأخطاء الرفع

يقبل VeloCMS رفع صور بصيغ JPEG وPNG وWebP وGIF. الملفات ذات الامتداد الخاطئ أو الترويسة التالفة قد تبدو مرفوعة بنجاح لكن البيانات الثنائية الفعلية غير صالحة ولا يستطيع المتصفح عرضها. في وحدة تحكم المتصفح، يُظهر ذلك استجابة 200 OK بنوع MIME هو application/octet-stream بدلاً من image/jpeg أو image/webp.

انتقل إلى لوحة التحكم ← الوسائط وابحث عن الصورة المعطّلة.
انقر على إدخال الصورة لفتح لوحة التفاصيل.
جرّب تنزيل الملف مباشرةً باستخدام الرابط المعروض — إذا كان حجم التنزيل صفر بايت أو تالفاً، فشل الرفع في منتصفه.
احذف الإدخال وأعد رفع الملف الأصلي.
إذا فشل الملف ذاته مرة أخرى، تحقق من حد حجم نص الطلب في عملية نشر Railway (الافتراضي 50 ميغابايت — الملفات الخام الكبيرة من كاميرات RAW قد تتجاوز هذا الحد).

الصور المرفوعة عبر السحب والإفلات في المحرر تعمل بطريقة مختلفة عن رفع مكتبة الوسائط. إذا فشل السحب والإفلات لكنّ مكتبة الوسائط تعمل (أو العكس)، اذكر ذلك في طلب الدعم — يُساعد ذلك في تحديد ما إذا كانت المشكلة في معالج ملفات المحرر أم في مسار API.

لا تزال معطّلة بعد كل ما سبق؟

افتح لوحة التحكم ← المراقبة والرصد وابحث عن إدخالات تحتوي «R2» أو «media» في الرسالة قرب وقت الرفع. إذا رأيتَ خطأ «Failed to upload to R2»، فقد يكون CLOUDFLARE_R2_ACCESS_KEY_ID أو CLOUDFLARE_R2_SECRET_ACCESS_KEY أو CLOUDFLARE_R2_BUCKET_NAME خاطئاً. انتقل إلى Railway ← خدمة VeloCMS ← Variables وتحقق مرة أخرى من القيم الثلاثة مقارنةً بـ API token الخاص بـ R2 في لوحة تحكم Cloudflare.