Lorixen.
AR

صور موقع Next.js مكسورة من مصدر خارجي: ضبط remotePatterns

باختصار: إذا كان موقعك مبنياً بـ Next.js، ويعرض صور منتجات أو عقارات أو أطباق من مصدر خارجي، مثل لوحة إدارة المحتوى أو خدمة تخزين سحابية أو نظام المتجر، ثم ظهرت صور مكسورة أو خطأ يقول إن المضيف غير مضبوط في next.config.js، فالسبب أن مكوّن الصور في Next.js لا يقبل أي رابط خارجي. توثيق Next.js يقول إن الرابط الخارجي المطلق يجب أن يُضبط عبر remotePatterns، وإن أي بروتوكول أو مضيف أو منفذ أو مسار غير مطابق يُرد عليه بخطأ 400. الحل: أضف نمطاً دقيقاً يصف مصدر صورك فعلاً، بدل فتح كل المصادر.

متى تظهر المشكلة؟

مكتب عقاري في عمّان أطلق موقعاً جديداً بـ Next.js يعرض الشقق المتاحة. صور الشقق يرفعها الموظفون إلى نظام إدارة محتوى منفصل، يخزنها على نطاق خاص به. في التجربة الأولى عملت الصور. ثم غيّر مزود نظام المحتوى نطاق تخزين الصور، أو فعّل المكتب شبكة توزيع محتوى بنطاق جديد، فظهرت مكان الصور مربعات فارغة.

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

لماذا يرفض Next.js الصور الخارجية؟

مكوّن الصور في Next.js لا يعرض الصورة الأصلية مباشرة، بل يمررها عبر خدمة تحسين الصور التابعة للموقع: يصغّرها، ويحوّل صيغتها، ويخزنها. هذا مفيد للسرعة، لكنه يعني أن خادمك سيجلب ويعالج أي صورة يُطلب منه معالجتها.

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

كيف يعمل remotePatterns؟

التوثيق يشرح أن remotePatterns يُضبط في ملف next.config.js، ويمكن كتابته كرابط أو ككائن يحدد:

  • البروتوكول: مثل https.
  • اسم المضيف: النطاق الذي تأتي منه الصور.
  • المنفذ: عادة فارغ.
  • المسار: مثل مجلد محدد في التخزين.
  • معاملات البحث: ما يأتي بعد علامة الاستفهام في الرابط.

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

استخدم النجوم بحذر

التوثيق يذكر أنماط النجمة: نجمة واحدة تطابق جزءاً واحداً من المسار أو نطاقاً فرعياً واحداً، ونجمتان تطابقان أي عدد من أجزاء المسار في النهاية أو النطاقات الفرعية في البداية. ويذكر أن هذه الصيغة لا تعمل في منتصف النمط.

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

لا تتجاهل معاملات البحث

نقطة دقيقة يذكرها التوثيق: حذف خاصية البحث من النمط يسمح بكل معاملات البحث، وهذا قد يسمح لجهات خبيثة بتحسين روابط لم تقصدها. وينصح باستخدام قيمة محددة لضمان مطابقة دقيقة.

إذا كانت روابط صورك لا تحتوي معاملات بحث أصلاً، فاضبطها على قيمة فارغة كما في أمثلة التوثيق. وإذا كانت تحتوي معاملاً ثابتاً مثل رقم إصدار، فحدده.

الإعداد القديم domains

قد يجد المطور الجديد في المشروع إعداداً قديماً اسمه domains. التوثيق يقول إنه مهمل منذ Next.js 14 لصالح remotePatterns الأكثر صرامة، لحماية التطبيق من المستخدمين الخبيثين. ويشرح أن domains لا يدعم أنماط النجمة، ولا يستطيع تقييد البروتوكول أو المنفذ أو المسار، وأنه لأن معظم خوادم الصور البعيدة مشتركة بين عملاء متعددين، فالأكثر أماناً استخدام remotePatterns لضمان تحسين الصور المقصودة فقط.

إذا كان مشروعك ما زال يستخدم domains، فهذه فرصة لنقله إلى remotePatterns أثناء إصلاح المشكلة.

الصور المحلية لها قاعدة مشابهة

إذا كانت بعض الصور في مجلد داخل الموقع نفسه، فالتوثيق يذكر إعداداً مقابلاً اسمه localPatterns، يسمح بتحسين الصور من مسارات محلية محددة ويحجب غيرها. ويعطي مثالاً يضمن أن رابط الصورة يجب أن يبدأ بمجلد محدد دون معاملات بحث، وأن أي مسار آخر يُرد عليه بخطأ 400.

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

ويذكر التوثيق خياراً آخر للصور الثابتة: استيرادها مباشرة في الكود، فتحصل تلقائياً على بصمة في اسمها وتخزين مؤقت طويل.

خيار unoptimized ومتى يُستخدم

التوثيق يذكر خاصية unoptimized التي تعطّل تحسين الصور. ويذكر أن خدمة التحسين، لأسباب أمنية، لا تمرر الترويسات عند جلب الصورة الأصلية، وأنه إذا كانت الصورة تحتاج مصادقة، فيمكن التفكير في استخدام unoptimized.

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

إذا كان موقعك خلف شبكة توزيع محتوى

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

قائمة عند إضافة مصدر صور جديد

  1. احصل على رابط صورة حقيقي من المصدر الجديد، وانظر إلى بروتوكوله ونطاقه ومساره.
  2. أضف نمطاً في remotePatterns يطابق هذا المصدر بأضيق نطاق ممكن.
  3. حدد قيمة البحث بدقة.
  4. أعد بناء الموقع ونشره، لأن الإعداد يُقرأ من ملف الإعداد.
  5. افتح صفحة فيها صور من المصدر الجديد على الهاتف وتأكد من ظهورها.
  6. اطلب من مزود المحتوى إشعاراً مسبقاً قبل أي تغيير في نطاق الصور.

أسئلة شائعة

ليش صور المنتجات بموقعي Next.js طالعة مكسورة؟

غالباً لأن نطاق الصور غير مضبوط في remotePatterns، ونطاقات أو مسارات غير المطابقة يُرد عليها بخطأ 400.

شو الفرق بين domains وremotePatterns؟

domains مهمل منذ Next.js 14، ولا يدعم النجوم ولا يقيد البروتوكول أو المنفذ أو المسار. remotePatterns أدق وأكثر أماناً.

بقدر أسمح لكل المواقع وأرتاح؟

لا يُنصح بذلك. التوثيق يطلب أن تكون الأنماط محددة قدر الإمكان لمنع الاستخدام الخبيث.

الصور بتحتاج تسجيل دخول، شو أعمل؟

التوثيق يقترح التفكير في unoptimized لهذه الصور تحديداً، لأن خدمة التحسين لا تمرر الترويسات.

إذا كانت صور موقعك تختفي كلما غيّرت مصدرها، راسلنا ونضبط الإعدادات معك.

المصادر

WhatsAppاحجز مكالمة