ネットワークとリモートアクセス

コマンド 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.