ورقة cURL المرجعية
مرجع curl قابل للبحث والطباعة — طرق HTTP، الترويسات، البيانات والنماذج، المصادقة، التنزيلات، ملفات الارتباط، TLS، الوكلاء وتصحيح الأخطاء. مجانًا.
الأساسيات
12curl https://api.example.com
إرسال طلب GET وطباعة الجسم
curl -o page.html https://example.com
حفظ الاستجابة إلى ملف مسمّى
curl -O https://example.com/file.zip
الحفظ باستخدام اسم الملف البعيد
curl -i https://example.com
عرض ترويسات الاستجابة مع الجسم
curl -I https://example.com
جلب ترويسات الاستجابة فقط (HEAD)
curl -v https://example.com
إخراج مفصّل للطلب/الاستجابة
curl -s https://example.com
وضع صامت، إخفاء التقدّم والأخطاء
curl -sS https://example.com
صامت مع إظهار الأخطاء
curl -L https://example.com
تتبّع إعادة توجيه HTTP (3xx)
curl https://a.com https://b.com
طلب عناوين متعددة في نداء واحد
curl 'https://x.com/p?[1-5]'
استخدام نطاق رقمي للمرور على العناوين
curl --version
طباعة إصدار curl وميزاته
طرق HTTP
9curl -X GET https://api.example.com
إرسال طلب GET صراحةً
curl -X POST https://api.example.com
إرسال طلب POST
curl -X PUT https://api.example.com/1
إرسال طلب PUT لاستبدال مورد
curl -X PATCH https://api.example.com/1
إرسال طلب PATCH لتحديث حقول
curl -X DELETE https://api.example.com/1
إرسال طلب DELETE
curl -I https://api.example.com
إرسال طلب HEAD للترويسات فقط
curl -X OPTIONS https://api.example.com
إرسال طلب OPTIONS تمهيدي
curl --head https://api.example.com
الصيغة المطوّلة لـ -I لطلب HEAD
curl --request POST https://x.com
الصيغة المطوّلة لـ -X لتعيين الطريقة
الترويسات
10curl -H 'Accept: application/json' https://x.com
إضافة ترويسة طلب واحدة
curl -H 'X-Token: abc' -H 'X-Env: dev' https://x.com
إضافة ترويسات متعددة
curl -H 'Content-Type: application/json' https://x.com
إعلان نوع محتوى جسم الطلب
curl -H 'Authorization: Bearer TOKEN' https://x.com
إرسال ترويسة تفويض bearer
curl -H 'Host: example.com' https://1.2.3.4
تجاوز ترويسة Host
curl -H 'Accept-Encoding: gzip' https://x.com
طلب استجابة مضغوطة بـ gzip
curl -A 'MyAgent/1.0' https://x.com
تعيين سلسلة User-Agent
curl -e 'https://ref.com' https://x.com
تعيين ترويسة Referer
curl -H 'X-Debug:' https://x.com
إزالة ترويسة افتراضية بتركها فارغة
curl --compressed https://x.com
طلب الاستجابة وفك ضغطها تلقائياً
إرسال البيانات
11curl -d 'name=Jane&age=30' https://x.com
إرسال بيانات نموذج مُرمّزة URL بـ POST
curl -d '@payload.json' https://x.com
إرسال بيانات مقروءة من ملف بـ POST
curl --data-urlencode 'q=hello world' https://x.com
إرسال حقل واحد مُرمّز URL بـ POST
curl --data-binary '@file.bin' https://x.com
إرسال بايتات خام دون معالجة بـ POST
curl -G --data-urlencode 'q=cats' https://x.com
إلحاق البيانات كسلسلة استعلام GET
curl -X POST -H 'Content-Type: application/json' -d '{"name":"Jane"}' https://x.com
إرسال جسم JSON بـ POST
curl --json '{"name":"Jane"}' https://x.com
إرسال JSON وتعيين ترويسات JSON تلقائياً
curl -F 'name=Jane' https://x.com
إرسال حقل نموذج متعدد الأجزاء
curl -F 'file=@photo.png' https://x.com
رفع ملف كـ multipart form-data
curl -F 'file=@a.pdf;type=application/pdf' https://x.com
رفع ملف بنوع MIME صريح
curl -d '' https://x.com
إرسال POST بجسم فارغ
المصادقة
9curl -u user:pass https://x.com
مصادقة HTTP الأساسية
curl -u user https://x.com
مصادقة أساسية، مطالبة بكلمة المرور
curl -H 'Authorization: Bearer TOKEN' https://x.com
إرسال ترويسة رمز bearer
curl --oauth2-bearer TOKEN https://x.com
إرسال رمز bearer لـ OAuth 2.0
curl --digest -u user:pass https://x.com
استخدام مصادقة HTTP digest
curl --ntlm -u user:pass https://x.com
استخدام مصادقة NTLM
curl --netrc https://x.com
قراءة بيانات الاعتماد من ~/.netrc
curl --netrc-file creds https://x.com
قراءة بيانات الاعتماد من ملف netrc مخصص
curl -H 'X-Api-Key: KEY' https://x.com
إرسال ترويسة مفتاح API
التنزيل والرفع
11curl -O https://x.com/file.zip
التنزيل باستخدام اسم الملف البعيد
curl -o out.zip https://x.com/file.zip
التنزيل إلى اسم ملف مختار
curl -OL https://x.com/file.zip
التنزيل وتتبّع إعادة التوجيه
curl -C - -O https://x.com/file.zip
استئناف تنزيل جزئي
curl --limit-rate 200k -O https://x.com/f
تحديد سقف سرعة النقل
curl -r 0-1023 -o part https://x.com/f
تنزيل نطاق بايتات فقط
curl --retry 3 -O https://x.com/f
إعادة محاولة التنزيل عند الفشل
curl -T file.txt ftp://x.com/
رفع ملف بـ PUT/FTP
curl -T file.txt https://x.com/up
رفع ملف عبر HTTP PUT
curl --create-dirs -o a/b/f.txt https://x.com
إنشاء الأدلة المفقودة للإخراج
curl -# -O https://x.com/file.zip
عرض شريط تقدّم بسيط
ملفات تعريف الارتباط
8curl -b 'session=abc123' https://x.com
إرسال كوكي مضمّن
curl -b cookies.txt https://x.com
إرسال كوكيز من ملف
curl -c cookies.txt https://x.com
كتابة الكوكيز المستلمة إلى jar
curl -b jar.txt -c jar.txt https://x.com
قراءة وتحديث نفس cookie jar
curl -b 'a=1; b=2' https://x.com
إرسال كوكيز متعددة دفعة واحدة
curl -c - https://x.com
طباعة الكوكيز المستلمة إلى stdout
curl --junk-session-cookies -b jar.txt https://x.com
تجاهل كوكيز الجلسة من الـ jar
curl -L -c jar.txt -b jar.txt https://x.com/login
إبقاء الجلسة عبر إعادة التوجيه
TLS / SSL
10curl -k https://x.com
السماح بغير الآمن (تخطّي التحقق من الشهادة)
curl --cacert ca.pem https://x.com
التحقق بحزمة CA مخصصة
curl --capath /etc/ssl/certs https://x.com
استخدام دليل شهادات CA
curl --cert client.pem https://x.com
إرسال شهادة عميل
curl --cert client.pem --key client.key https://x.com
استخدام شهادة عميل ومفتاح خاص
curl --tlsv1.2 https://x.com
اشتراط TLS 1.2 كحد أدنى
curl --tlsv1.3 https://x.com
اشتراط TLS 1.3 كحد أدنى
curl --tls-max 1.2 https://x.com
تحديد سقف إصدار TLS الأعلى
curl --ciphers ECDHE-RSA-AES128-GCM-SHA256 https://x.com
تقييد شفرات TLS المسموحة
curl -vI https://x.com
فحص تفاصيل مصافحة TLS
الوسطاء (proxies)
9curl -x http://proxy:8080 https://x.com
توجيه الطلب عبر وسيط HTTP
curl --proxy http://proxy:8080 https://x.com
الصيغة المطوّلة لـ -x لتعيين وسيط
curl -x proxy:8080 -U user:pass https://x.com
المصادقة لدى الوسيط
curl --proxy-user user:pass -x proxy:8080 https://x.com
الصيغة المطوّلة لبيانات اعتماد الوسيط
curl --socks5 127.0.0.1:1080 https://x.com
استخدام وسيط SOCKS5
curl --socks5-hostname 127.0.0.1:1080 https://x.com
وسيط SOCKS5 مع حل DNS عن بُعد
curl --socks4 127.0.0.1:1080 https://x.com
استخدام وسيط SOCKS4
curl --noproxy example.com https://x.com
تجاوز الوسيط لمضيفين محددين
curl -x '' https://x.com
تعطيل أي وسيط مُهيّأ
التنقيح والإخراج
11curl -w '%{http_code}\n' -o /dev/null -s https://x.com
طباعة رمز حالة HTTP فقط
curl -w '%{time_total}\n' -o /dev/null -s https://x.com
طباعة إجمالي وقت النقل
curl -w '@format.txt' https://x.com
قراءة صيغة write-out من ملف
curl -D headers.txt https://x.com
تفريغ ترويسات الاستجابة إلى ملف
curl -D - -o body.txt https://x.com
الترويسات إلى stdout والجسم إلى ملف
curl --trace trace.txt https://x.com
تتبّع سداسي كامل للنقل
curl --trace-ascii - https://x.com
تتبّع ASCII إلى stdout
curl --trace-time -v https://x.com
إضافة طوابع زمنية للإخراج المفصّل
curl -v https://x.com 2>&1 | less
تصفّح السجل المفصّل صفحة صفحة
curl -sS -o /dev/null -w '%{size_download}\n' https://x.com
طباعة عدد البايتات المنزّلة
curl --libcurl out.c https://x.com
إصدار شيفرة C مكافئة لـ libcurl
المهل وإعادة المحاولة
10curl --connect-timeout 5 https://x.com
تحديد مرحلة الاتصال بالثواني
curl --max-time 30 https://x.com
تحديد سقف وقت العملية كاملة
curl --retry 3 https://x.com
إعادة المحاولة عند الأخطاء العابرة
curl --retry 3 --retry-delay 2 https://x.com
الانتظار بين محاولات الإعادة
curl --retry 5 --retry-max-time 60 https://x.com
تحديد إجمالي وقت إعادة المحاولة
curl --retry-connrefused https://x.com
الإعادة أيضاً عند رفض الاتصال
curl --retry-all-errors https://x.com
الإعادة عند أي خطأ لا العابر فقط
curl --speed-limit 100 --speed-time 10 https://x.com
الإجهاض إذا كان بطيئاً جداً لمدة
curl --keepalive-time 60 https://x.com
تعيين فترة TCP keep-alive
curl --expect100-timeout 1 https://x.com
تحديد انتظار 100-continue
لا يوجد إدخال يطابق “:q”.
هل تحتاج إلى مساعدة؟
هل واجهت مشكلة في هذه الأداة؟ أخبر فريقنا.