curl コマンドの使い方（URLデータ転送）｜オプションと使用例

どんなコマンド？

こんなときに

HTTP疎通確認、APIテスト、ヘッダー確認、ファイル取得、Web障害調査に使います。

curlは、URLを相手にデータを送受信するコマンドです。HTTPやHTTPSの確認に使われることが多いですが、FTPなど複数のプロトコルにも対応します。

実務では、APIの疎通確認、HTTPヘッダー取得、認証付きリクエスト、ファイルダウンロード、障害調査で頻出します。

大切なのは、標準出力へ本文を出す既定動作、-Iでヘッダーだけを見る、-Lでリダイレクトを追う、-oや-Oで保存方法を変える、といった基礎を押さえることです。

書き方とオプション

組み立ててみるオプションを押すと、下の1行に足されます。もう一度押すと外れます。

$ curl

使用例と実行結果

行を押すとコピーできます。

HTTP/1.1 200 OK
content-type: text/html ...

本文を取らずに応答コードとヘッダーを確認できます。

まず安全に試す

3分ミッション

手を動かすと覚えやすくなります。できたものに印を付けてください（この端末に残ります）。

0 / 2

ヘッダーだけ取得する-Iで応答コードとcontent-typeを確認します。
本文を保存して確認する-L -oでリダイレクト込みの取得を試します。

つまずいたとき

301や302で意図した内容が見えない

原因リダイレクト先を追っていません。

こうする-Lを付けて追跡します。

認証情報をそのまま履歴へ残した

原因コマンドラインへ機密情報を直接書きました。

こうする設定ファイル、環境変数、標準入力などを検討します。

終わったときの数（戻り値）

$ echo $?

0正常終了。転送に成功しました。
>0名前解決失敗、接続失敗、TLS失敗などで転送できませんでした。

気をつけることと入れ方

気をつけること

危険度は中程度です。認証情報や機密ヘッダーをシェル履歴へ残さない工夫が必要です。

環境による違い

機能差はバージョン依存です。TLS、HTTP/2、HTTP/3対応状況はビルドオプションで変わります。

確かめた環境2026-04-09 に確認

よくある質問

wgetとの違いは何ですか。

curlは送受信やAPI確認に強く、wgetは再帰取得や非対話ダウンロードで便利な場面があります。

本文を表示せず状態だけ見たい時はどうしますか。

-Iでヘッダーだけ見るか、-o /dev/nullと-wを組み合わせます。

いっしょに知りたい用語

No.027リポジトリリポジトリは、パッケージとその索引情報を配布する保管場所です。No.031APIAPIは、あるソフトウェアやライブラリが外部へ公開する機能の呼び出し方や約束事を指します。No.208encryption暗号化は、読めるデータを規則に従って読めない形へ変換する処理です。No.210TLSTLSは、通信経路の機密性と改ざん検知、相手確認を提供するための通信保護仕組みです。No.211certificate証明書は、公開鍵と主体情報を結び付け、第三者がその対応を確認できるようにした電子的な証明書です。No.212CA認証局は、公開鍵と主体情報の対応を保証する立場で証明書へ署名する組織や機能です。No.219confidentiality機密性は、許可された主体だけが情報を読める状態を指します。No.220availability可用性は、必要な時に必要な資源へ利用できる状態を指します。No.285HTTPHTTPは、Hypertext Transfer Protocol（HTTP）を略した、ウェブで情報をやり取りするための基本プロトコルです。No.286HTTPSHTTPSは、TLSで保護したHTTP通信です。No.293reverse proxyリバースプロキシは、利用者の前面に置かれ、受けた要求を内部のサーバーへ転送する仕組みです。No.294proxyプロキシは、別の通信先への中継を行う仕組みの総称です。No.295load balancerロードバランサーは、複数の処理先へ負荷を振り分ける仕組みです。No.297DoHDNS over HTTPSは、DNS over HTTPS（DoH）を略した、HTTPS上でDNS問い合わせを行う方式です。No.298CDNCDNは、Content Delivery Network（CDN）を略した、配信拠点を分散させて応答を高速化する仕組みです。No.299web serverウェブサーバーは、HTTPやHTTPSでコンテンツを配信するサーバー役割です。No.300application serverアプリケーションサーバーは、業務ロジックや動的処理を実行するサーバー役割です。No.326registryレジストリは、コンテナイメージを保管・配布するためのサーバーです。No.328KubernetesKubernetesは、コンテナ化したアプリケーションを複数ノードで管理するための基盤です。No.330deploymentDeploymentは、Kubernetesでアプリケーションの望ましい状態を管理するためのリソースです。No.331ingressIngressは、外部からクラスタ内サービスへ到達させる入口の概念です。No.344incidentインシデントは、サービス品質や運用に影響する出来事です。No.345runbookランブックは、運用手順や障害対応手順をまとめた文書です。No.347SLASLAは、Service Level Agreement（SLA）を略した、提供側と利用側の合意条件です。No.348SLOSLOは、Service Level Objective（SLO）を略した、サービス運用上の目標値です。No.349SLISLIは、Service Level Indicator（SLI）を略した、サービス品質を測るための指標です。No.377repository serverリポジトリサーバーは、パッケージやメタデータを配布するサーバーです。No.378mirror serverミラーサーバーは、配布元の内容を複製して提供するサーバーです。No.385cloudクラウドは、クラウドサービスの提供形態や利用範囲を説明するときに使う基礎用語です。No.386IaaSIaaSは、クラウドサービスの提供形態や利用範囲を説明するときに使う基礎用語です。No.387PaaSPaaSは、クラウドサービスの提供形態や利用範囲を説明するときに使う基礎用語です。No.388SaaSSaaSは、クラウドサービスの提供形態や利用範囲を説明するときに使う基礎用語です。No.391serverlessサーバーレスは、環境の複製や配備方法を理解するときに使う基盤用語です。No.392object storageオブジェクトストレージは、クラウドや基盤環境で使われる記録領域の提供方式を表す用語です。No.395BMCBMCは、サーバーを遠隔で監視・制御する管理基盤に関する用語です。No.397RedfishRedfishは、サーバーを遠隔で監視・制御する管理基盤に関する用語です。No.398service meshサービスメッシュは、基盤運用やクラウド設計の品質を考えるときに使う運用設計用語です。No.449integration test結合テストは、変更管理、品質管理、配布運用の流れを理解するための開発運用用語です。

同じ目的のコマンド

No.119vgcreate物理ボリュームを束ねてボリュームグループを作成します。後続のlvcreateやlvextendの土台になります。No.102findmnt現在のマウント情報を検索、整形表示します。mountより見やすく、条件指定もしやすいのが強みです。No.112fsckファイルシステムの整合性を検査し、必要に応じて修復します。障害対応の重要コマンドですが、扱いは慎重さが必要です。No.055comm整列済みファイルを比較し、差集合と共通集合を列ごとに出力します。集合としての差分確認に向きます。No.115mkfsデバイスやイメージへ新しいファイルシステムを作成します。ext4やxfsなどの種類を選べますが、既存データは基本的に失われます。No.135ethtoolネットワークインターフェースのリンク速度、ドライバー、統計、オフロード機能を確認または変更します。