كل المقالات التقنية

تشخيص مشاكل HTTP باستخدام curl: الترويسات وإعادة التوجيه والزمن

استخدموا curl لقراءة الترويسات وتتبع إعادة التوجيه وقياس كل مرحلة وفحص شهادة TLS لفصل مشاكل الشبكة والـ CDN والخادم.

تشخيص مشاكل HTTP باستخدام curl: الترويسات وإعادة التوجيه والزمن

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

١. ابدؤوا بالترويسات فقط

السؤال الأول هو بماذا يرد الخادم فعلاً. اطلبوا الترويسات وتجاهلوا المحتوى:

# Headers only, body discarded
curl -sS -o /dev/null -D - https://example.com/

الخيار -sS يخفي شريط التقدم لكنه يُظهر الأخطاء، و-o /dev/null يتجاهل الصفحة، و-D - يطبع ترويسات الرد على الشاشة. اقرؤوا سطر الحالة أولاً (200 أو 301 أو 403 أو 502) ثم الترويسات التي تفسّر السلوك: Location لإعادة التوجيه وCache-Control وAge للتخزين المؤقت وServer وContent-Type وSet-Cookie إذا كان يمكن تجاوز الكاش بسبب الكوكيز. هذا طلب GET عادي وهو أوفى من -I لأن بعض الخوادم ترد على HEAD بشكل مختلف.

٢. تتبّعوا إعادة التوجيه وعدّوها

مشكلة إعادة التوجيه غالباً قاعدتان تتعارضان. دعوا curl يتبعها ويخبركم أين انتهى:

curl -sSL -o /dev/null -w 'final=%{url_effective} code=%{http_code} redirects=%{num_redirects}\n' http://example.com/

الموقع السليم ينتهي على عنوان HTTPS النهائي بإعادة توجيه واحدة أو بدونها. العدد الكبير أو العنوان النهائي غير المتوقع أو الخطأ Maximum (50) redirects followed يعني حلقة. لرؤية كل خطوة شغّلوا أمر الترويسات بدون -L وتتبعوا قيمة Location يدوياً. للأسباب الشائعة على الاستضافة المشتركة راجعوا دليل إعادة توجيه HTTP إلى HTTPS وwww، وإن كان Cloudflare أمام الموقع فراجعوا دليل حلقة إعادة التوجيه في Cloudflare.

٣. قيسوا أين يذهب الوقت

يطبع الخيار -w متغيرات الزمن بعد النقل. هذه القيم الخمس تفصل زمن الشبكة عن زمن الخادم:

curl -sS -o /dev/null -w 'dns=%{time_namelookup} connect=%{time_connect} tls=%{time_appconnect} ttfb=%{time_starttransfer} total=%{time_total}\n' https://example.com/

القيم ثوانٍ تراكمية منذ البداية. dns هو حل الاسم وconnect اتصال TCP وtls نهاية مصافحة TLS وttfb لحظة وصول أول بايت من الرد. اطرحوا القيم المتجاورة للحصول على زمن كل مرحلة: فجوة كبيرة بين tls وttfb هي وقت قضاه الخادم في بناء الرد، وقيمة كبيرة لـ dns أو connect تشير إلى الشبكة أو الـ resolver. كرّروا ثلاث إلى خمس مرات لأن عينة واحدة ضجيج. وإن كان الانتظار في الخادم فتابعوا مع دليل TTFB.

٤. اختبروا خادماً محدداً مباشرة

أثناء الترحيل أو خلف موزّع أحمال أو CDN تحتاجون غالباً إلى سؤال عنوان IP محدد مع الإبقاء على اسم المضيف الحقيقي. الخيار --resolve يفعل ذلك بلا تعديل أي ملف:

# Ask one specific IP, keep the real hostname for TLS and Host
curl -sS -o /dev/null -D - --resolve example.com:443:203.0.113.10 https://example.com/

يذهب الطلب إلى العنوان المختار لكن curl يرسل ترويسة Host الصحيحة ويستخدم اسم المضيف في TLS، فيبقى فحص الشهادة ذا معنى. قارنوا الرد بالحالة العادية: إن كان الطلب المباشر وحده سريعاً فالمشكلة أمام الخادم (CDN أو DNS أو بروكسي)، وإن كان كلاهما بطيئاً فانظروا في الخادم نفسه.

٥. افحصوا الشهادة والمصافحة

عندما يعرض المتصفح تحذير شهادة، يعرض curl الحقائق نفسها في أسطر قليلة:

curl -svI https://example.com/ 2>&1 | grep -E 'subject:|issuer:|expire date|SSL connection|HTTP/'

سترون الـ subject والـ issuer وتاريخ الانتهاء والبروتوكول المتفق عليه. خطأ مثل SSL certificate problem: unable to get local issuer certificate يعني غالباً أن الخادم يرسل سلسلة ناقصة. لا تستخدموا -k لإخفاء الخطأ، فهو يعطّل التحقق ويخفي المشكلة نفسها التي تبحثون عنها. استخدموه لتجربة قصيرة فقط وليس في سكربت يعمل دون مراقبة.

٦. أرسلوا ما يرسله المتصفح

أحياناً تختلف الصفحة بين المتصفح وcurl. أضيفوا ما يضيفه المتصفح واحداً واحداً وانظروا أيها يغيّر الرد:

curl -sS -o /dev/null -D - --compressed -A 'Mozilla/5.0' -H 'Accept-Language: en' https://example.com/

الخيار --compressed يطلب gzip أو Brotli ويفكّه، و-A يضبط User-Agent و-H يضيف أي ترويسة. إن كان جدار حماية أو إضافة أمان يحجب العملاء المجهولين فالمشتبه الأول هو User-Agent. وللحصول على عرض المستخدم المسجّل لا تلصقوا كوكي جلسة حقيقياً في تذكرة أو محادثة أو سجل أوامر يقرؤه غيركم، بل اختبروا بحساب تجريبي واحذفوه بعد ذلك.

٧. مثال توضيحي وليس قياساً حقيقياً

افترضوا أن أمر القياس طبع ما يلي (أرقام مختلقة لإظهار طريقة القراءة فقط):

dns=0.004 connect=0.021 tls=0.063 ttfb=1.480 total=1.530

DNS والاتصال وTLS معاً نحو 0.06 ثانية، فالشبكة سليمة. يصل أول بايت عند 1.48 ثانية، أي أن نحو 1.4 ثانية صُرفت في إنتاج الصفحة على الخادم، والتحميل استغرق 0.05 ثانية فقط. الخطوة التالية على الخادم (كاش الصفحة أو إضافة بطيئة أو قاعدة البيانات) وليس في المتصفح أو الـ CDN.

٨. أخطاء شائعة

  • الحكم على السرعة من طلب واحد. كرّروا وقارنوا بين كاش دافئ وبارد.
  • استخدام -I وحده. بعض التطبيقات ترد على HEAD بشكل مختلف، فتأكدوا بطلب عادي.
  • نسيان أن curl لا ينفّذ JavaScript. يعرض ما يرسله الخادم لا ما تبنيه الصفحة لاحقاً.
  • الاختبار من الخادم نفسه وافتراض أن المستخدمين يرون الشيء نفسه. قد يختلف DNS وCDN وجدار الحماية من الخارج.
  • ترك -k في أمر أو سكربت فيُخفي أخطاء الشهادة نهائياً.
  • لصق الكوكيز أو الرموز أو ترويسة Authorization في أماكن عامة.

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

لماذا يعرض curl نتيجة مختلفة عن المتصفح؟ للمتصفح كوكيز وكاش وإضافات وJavaScript. أضيفوا ترويسات أو كوكيز إلى curl واحداً واحداً حتى يظهر الفرق، أو جرّبوا المتصفح في نافذة خاصة.

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

هل أستخدم curl للتحقق من عمل الموقع؟ نعم لفحص سريع. استخدموا -w '%{http_code}' ومهلة مثل --max-time 10، وللمراقبة الدائمة استخدموا أداة مراقبة مناسبة بدل حلقة.

هل تشغيل curl على موقع الإنتاج آمن؟ بضعة طلبات غير مؤذية. لا تشغّلوه في حلقة سريعة ولا تختبروا بتحميلات كبيرة وقت الذروة.

١٠. قائمة تحقق سريعة

  1. اطبعوا سطر الحالة والترويسات بطلب GET عادي.
  2. تتبعوا إعادة التوجيه وافحصوا العنوان النهائي وعدد الخطوات.
  3. قيسوا قيم الزمن الخمس عدة مرات.
  4. اسألوا خادماً محدداً بـ --resolve لفصل الواجهة عن الخلفية.
  5. افحصوا subject وissuer وانتهاء الشهادة.
  6. أضيفوا ترويسات المتصفح واحدة واحدة إن اختلفت الردود.
  7. أبعدوا الأسرار عن الأوامر والمخرجات المشتركة.

إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.

تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.

المراجع الرسمية

curl: Manual page · Everything curl: write-out · MDN: HTTP response status codes · RFC 9110: HTTP Semantics