גישה לרשת ומרחוק

הפקודה 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.