Lorixen.
AR

Django يعرض Bad Request (400) على نطاق جديد: ضبط ALLOWED_HOSTS

باختصار: إذا كان موقعك المبني بـ Django يعرض صفحة بيضاء فيها «Bad Request (400)» فقط بعد ربط نطاق جديد، أو بعد إضافة www، أو بعد نقل الموقع إلى خادم جديد، فالسبب في الغالب إعداد ALLOWED_HOSTS. توثيق Django يشرح أن هذا الإعداد قائمة بأسماء النطاقات التي يُسمح للموقع بخدمتها، وأنه إذا كان DEBUG مطفأً ولم يُضبط ALLOWED_HOSTS بشكل صحيح، فستُرجع كل الطلبات «Bad Request (400)». الإصلاح أن تضيف كل نطاق حقيقي يصل منه الزوار، بشكل محدد، لا أن تضع نجمة تسمح بكل شيء.

كيف تبدأ المشكلة عادة؟

مركز تدريب في عمّان لديه موقع تسجيل للدورات مبني بـ Django. الموقع كان يعمل على النطاق القديم. قرر صاحب المركز شراء نطاق جديد أقصر واستخدامه في الإعلانات، فوجّه النطاق الجديد إلى الخادم نفسه. النطاق القديم يعمل، لكن النطاق الجديد يعرض «Bad Request (400)» فقط، دون أي شرح.

في حالة أخرى، يعمل الموقع على example.jo لكنه يفشل على www.example.jo، فيصل بعض الزبائن إلى الموقع وبعضهم يرى الخطأ، حسب الطريقة التي كتبوا بها العنوان أو الرابط الذي ضغطوا عليه.

هذا مثال توضيحي، والنطاقات هنا أمثلة لا مواقع حقيقية.

لماذا يرفض Django نطاقاً يشير إلى خادمك؟

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

ويوضح التوثيق أن القيمة الافتراضية للإعداد قائمة فارغة. وعندما يكون DEBUG مفعلاً والقائمة فارغة، يتحقق Django من الطلبات مقابل قيم محلية مثل localhost و127.0.0.1. لهذا يعمل الموقع بسلاسة على جهاز المطور، ثم يفشل على الخادم عندما يُطفأ DEBUG كما يجب في الإنتاج.

الإصلاح: أضف النطاقات بدقة

ضع في ALLOWED_HOSTS كل اسم يصل منه الزوار فعلاً. بحسب التوثيق:

  • اسم كامل مثل www.example.jo يُطابق ترويسة Host تماماً، دون حساسية لحالة الأحرف، ودون احتساب رقم المنفذ.
  • قيمة تبدأ بنقطة مثل ‎.example.jo‎ تعمل كبديل لكل النطاقات الفرعية، وتطابق example.jo وwww.example.jo وأي نطاق فرعي آخر.

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

بعد التعديل، يجب إعادة تشغيل تطبيق Django على الخادم كي يقرأ الإعداد الجديد. كثير من الشكاوى من نوع «عدّلت وما زال الخطأ» سببها نسيان هذه الخطوة.

لماذا لا تستخدم النجمة؟

التوثيق يذكر أن القيمة '*' تطابق أي شيء، لكنه يضيف أنك في هذه الحالة مسؤول عن توفير تحقق خاص بك من ترويسة Host، ربما في وسيط برمجي يكون أول عنصر في قائمة MIDDLEWARE. بعبارة أخرى: النجمة لا تحل المشكلة، بل تنقل مسؤولية الحماية إليك. إذا وضعها المطور ليتخلص من الخطأ بسرعة، فقد أزال طبقة حماية دون بديل.

القاعدة العملية: لا تقبل بالنجمة إلا إذا شرح لك المطور أين يتم التحقق البديل.

حالات تنسى إضافتها

قائمة النطاقات ليست دائماً واضحة. راجع هذه الحالات:

  1. نسخة www ونسخة بدونها: إذا كان الموقع يعمل على الاثنين، أو يحول من أحدهما للآخر، فيجب أن يقبل Django الاثنين، أو أن يتم التحويل قبل أن يصل الطلب إليه.
  2. نطاق تجريبي: نسخة الاختبار على نطاق فرعي مختلف تحتاج إدخالها الخاص، ويفضل ألا تكون في نفس قائمة الإنتاج إذا كانت تعمل على خادم آخر.
  3. خادم وسيط أو موازن أحمال: إذا كان أمام Django خادم وسيط، فقد تصل ترويسة Host مختلفة. التوثيق يذكر أنه عند تفعيل USE_X_FORWARDED_HOST تُستخدم ترويسة X-Forwarded-Host في التحقق بدل Host. فعّل هذا فقط إذا كان الوسيط موثوقاً ويضبط الترويسة بنفسه.
  4. فحوصات الصحة الآلية: بعض خدمات المراقبة أو موازنات الأحمال تطلب الموقع بعنوان IP بدل النطاق. إذا ظهر الخطأ في سجلاتك لطلبات من هذا النوع فقط، فاعرف مصدرها قبل إضافة عنوان IP إلى القائمة.

نقطة تقنية للمطور

التوثيق ينبه إلى أن هذا التحقق يحدث فقط عبر الدالة get_host() في كائن الطلب. إذا قرأ الكود ترويسة Host مباشرة، مثل بناء روابط إعادة تعيين كلمة المرور منها، فقد يتجاوز الحماية. اطلب من المطور التأكد أن الروابط التي تُرسل في البريد، مثل روابط تفعيل الحساب، تُبنى بطريقة تعتمد على النطاق المعتمد لا على ما يرسله الزائر.

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

كيف تتأكد أن المشكلة هي ALLOWED_HOSTS فعلاً؟

  • الخطأ يظهر كصفحة بسيطة جداً فيها «Bad Request (400)» دون تصميم الموقع.
  • الخطأ يظهر على نطاق معين ولا يظهر على آخر يشير إلى الخادم نفسه.
  • عند فحص سجلات Django، يظهر تحذير يتعلق بترويسة Host غير صالحة. التوثيق يذكر أن عدم التطابق يجعل get_host() ترفع استثناء SuspiciousOperation.

إذا ظهر الخطأ على كل النطاقات، بما فيها القديم، بعد تحديث الكود، فربما تغير ملف الإعدادات نفسه أو قراءة متغيرات البيئة، وليس النطاق.

راجع القائمة كل فترة

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

قبل ربط أي نطاق جديد

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

أسئلة شائعة

ليش موقع Django بيطلع Bad Request (400) على الدومين الجديد؟

لأن الدومين الجديد غير مضاف إلى ALLOWED_HOSTS، ومع إطفاء DEBUG ترجع كل الطلبات بهذا الخطأ.

الموقع شغال على جهاز المبرمج وخربان على السيرفر، ليش؟

مع DEBUG مفعّل وقائمة فارغة، يقبل Django القيم المحلية مثل localhost فقط، فيعمل عند المبرمج ويفشل في الإنتاج.

هل أحط '*' وبخلص؟

لا يُنصح. التوثيق يقول إنك تصبح مسؤولاً عن تحقق بديل من ترويسة Host.

كيف أسمح بكل النطاقات الفرعية؟

استخدم قيمة تبدأ بنقطة مثل ‎.example.jo‎، فتطابق النطاق الرئيسي وكل نطاقاته الفرعية.

إذا ربطت نطاقاً جديداً بموقعك المبني بـ Django وظهر خطأ 400، اكتب لنا ونضبط الإعدادات معك.

المصادر

WhatsAppاحجز مكالمة