الشبكة والوصول عن بعد

الأمر curl

إرسال طلبات HTTP وتنزيل البيانات

Linux · أمثلة Bash · الأوامر تعمل على الخادم المحدد

متى تستخدم curl

استخدم curl لفحص استجابات HTTP أو تنزيل أحد الموارد أو الاتصال بـ API من الخادم. افصل نجاح النقل عن نجاح التطبيق، وقم بتعيين مهلات معقولة واحتفظ برموز المصادقة المميزة خارج أمثلة الأوامر المحفوظة.

بناء الجملة

curl [PARAMETERS] URL

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

الخيارات والوسائط الشائعة

-I
اطلب رؤوس HTTP فقط، باستخدام طريقة HEAD.
-f
قم بإرجاع خطأ لرموز الحالة HTTP 400 وما فوق.
-L
اتبع عمليات إعادة التوجيه؛ يحدد -o ملف النتيجة.

أمثلة الاستخدام

تحقق من رؤوس الموقع

curl -I https://example.com

يتم إجراء طلب رأس فقط؛ تتعامل بعض الخدمات مع هذا الأمر بشكل مختلف عن طلب المحتوى العادي.

قم بتنزيل الملف مع معالجة أخطاء HTTP

curl --fail --location --output ./page.html https://example.com

يتم اتباع عمليات إعادة التوجيه ويستبدل نص الاستجابة الملف المحلي المسمى؛ حالات الخطأ HTTP تسبب الفشل.

طلب JSON مع الحد الزمني

curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status

يتم طلب استجابة JSON بمدة إجمالية محدودة؛ يجب أن توفر نقطة النهاية فعليًا ذلك API.

الملاحظات والقيود

  • مع HTTPS يتم التحقق من الشهادة بشكل افتراضي؛ لا تقم بتعطيل التحقق عبر -k دون سبب منفصل.
  • لا تضع رموزًا مميزة أو كلمات مرور حقيقية في سجل الأوامر ولا تقم بتشغيل البرامج النصية التي تم تنزيلها دون التحقق.

الأسئلة الشائعة واستكشاف الأخطاء وإصلاحها

لماذا ينجح curl عندما يقوم الخادم بإرجاع صفحة خطأ؟

بدون خيار الفشل، لا يزال من الممكن اعتبار تلقي استجابة خطأ HTTP بمثابة عملية نقل ناجحة. افحص كلاً من حالة HTTP وحالة خروج الأمر.

هل يجب علي تعطيل التحقق من الشهادة لإصلاح HTTPS؟

لا تتجاوز الثقة كحل روتيني. تحقق من اسم المضيف ووقت النظام وسلسلة شهادات الخادم وتكوين CA الموثوق به بدلاً من ذلك.

مزيد من المساعدة

تختلف الخيارات حسب الإصدار والتوزيع. تحقق من الوثائق المثبتة باستخدام هذا الأمر: man curl.