網路和遠端存取

指令 curl

傳送HTTP請求並下載資料

Linux · Bash 範例 · 在所選伺服器上執行的指令

何時使用 curl

使用 curl 檢查 HTTP 回應、下載資源或從伺服器呼叫 API。將傳輸成功與應用程式成功分開,設定合理的逾時並將身份驗證令牌排除在已儲存的命令範例之外。

文法

curl [PARAMETERS] URL

方括號標記可選引數;省略號意味著重複。將範例檔案名稱、使用者名稱和伺服器位址替換為您自己的值。

常見選項和引數

-I
使用 HEAD 方法僅要求 HTTP 標頭。
-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.