wgetコマンドの使い方｜保存先・再帰・リトライとcurlの違い

wgetは、URLを指定してファイルをダウンロードするコマンドです。 wget URL と書くだけで、URLの末尾と同じ名前のファイルがカレントディレクトリに保存されます。途中で切れたダウンロードの再開、自動リトライ、リンクをたどる再帰取得までを1つのコマンドでこなせるのが特長です。

この記事では、手元に用意したテスト用サーバーに対して GNU Wget 1.21.4 を実際に動かし、そのログを載せています。 「やりたいこと→コマンド」の逆引き早見表、保存先（-P / -O）・再開（-c）・リトライ・再帰取得の実行ログ、403・証明書エラー・タイムアウトを再現したうえでの対処、同じ操作を curl で書くときの対応表、Fedora などで既定になっている wget2 との違いまでを1ページにまとめました。

wgetの逆引き早見表

「やりたいこと」から探せる一覧です。 すべて GNU Wget 1.21.4 で実行して確認しています。

検証環境

実行ログは次の環境で取ったものです。 外部のサイトには接続せず、同じマシン上に Python で立てたテスト用サーバー（HTTP は 7890 番、HTTPS は 7891 番ポート）を相手にしています。ログ中の日時は 2026-10-03 10:00:00 に置き換えています。長いログは、要点の行だけを抜き出して載せている箇所があります。

既定値（リトライ20回、読み取りタイムアウト900秒、再帰の深さ5階層など）は、GNU Wget の公式マニュアルを今回開いて確認した内容です。

基本の使い方とログの読み方

URLを指定してダウンロードする

$ wget http://127.0.0.1:7890/hello.txt
--2026-10-03 10:00:00--  http://127.0.0.1:7890/hello.txt
Connecting to 127.0.0.1:7890... connected.
HTTP request sent, awaiting response... 200 OK
Length: 11 [text/plain]
Saving to: ‘hello.txt’

     0K                                                       100% 2.80M=0s

2026-10-03 10:00:00 (2.80 MB/s) - ‘hello.txt’ saved [11/11]

進み具合の表示は、端末で実行するとバー形式、ログをファイルやパイプに出すと上のような点（ドット）形式になります。

同じ名前のファイルがあるときの動き

もう一度同じURLを取得すると、元のファイルは残したまま .1 を付けた名前で保存します。

$ wget -nv http://127.0.0.1:7890/hello.txt; ls
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/hello.txt [11/11] -> "hello.txt.1" [1]
hello.txt
hello.txt.1

ログの量を調整する（-nv / -q / -S）

スクリプトでは -nv（1行に要約）か -q（何も出さない）が扱いやすくなります。サーバーの応答ヘッダーを見たいときは -S です。

$ wget -S --spider http://127.0.0.1:7890/hello.txt
Spider mode enabled. Check if remote file exists.
--2026-10-03 10:00:00--  http://127.0.0.1:7890/hello.txt
Connecting to 127.0.0.1:7890... connected.
HTTP request sent, awaiting response... 
  HTTP/1.0 200 OK
  Server: SimpleHTTP/0.6 Python/3.11.15
  Content-type: text/plain
  Content-Length: 11
Length: 11 [text/plain]
Remote file exists.

（Date と Last-Modified の2行は省略しています。）--spider は保存せずに存在だけを確かめるモードで、&& と組み合わせて条件分岐に使えます。

$ wget -q --spider http://127.0.0.1:7890/none.txt && echo exists || echo 'not found'
not found

-q でログを消しつつ進み具合のバーだけ出したいときは --show-progress を足します。

$ wget -q --show-progress --progress=bar:force:noscroll http://127.0.0.1:7890/big.bin
big.bin             100%[===================>]   2.86M  --.-KB/s    in 0.004s

保存先を指定する（-P と -O の違い）

-P は「保存するディレクトリ」、-O は「保存するファイル名（パス）」を決めます。 似ていますが役割が違います。

# ファイル名を決める
$ wget -q -O greet.txt http://127.0.0.1:7890/hello.txt; cat greet.txt
hello wget

# ディレクトリを決める（なければ作られる）
$ wget -nv -P /tmp/t189dl/a/b http://127.0.0.1:7890/hello.txt
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/hello.txt [11/11] -> "/tmp/t189dl/a/b/hello.txt" [1]

# 画面に出す
$ wget -qO- http://127.0.0.1:7890/hello.txt
hello wget

直す前と後：-O でディレクトリがないと言われる

-O はディレクトリを作らないため、存在しない場所を指定すると次の表示になります（終了コードは 1）。

$ wget -nv -O out/x.txt http://127.0.0.1:7890/hello.txt
out/x.txt: No such file or directory

$ mkdir -p out && wget -nv -O out/x.txt http://127.0.0.1:7890/hello.txt
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/hello.txt [11/11] -> "out/x.txt" [1]

-P と -O を同時に書いたとき

両方を書くと -O が優先され、-P のディレクトリは使われませんでした。 x.txt は downloads の中ではなく、カレントディレクトリにできています。

$ wget -q -P downloads -O x.txt http://127.0.0.1:7890/hello.txt; ls downloads; ls x.txt
hello.txt
x.txt

（downloads の中の hello.txt は、その前に -P downloads だけで取得したものです。）ディレクトリも名前も決めたいときは、-O downloads/x.txt のように -O にパスごと書きます。

複数URLに -O を付けると1ファイルにつながる

$ wget -nv http://127.0.0.1:7890/hello.txt http://127.0.0.1:7890/docs/page1.html -O both.txt; wc -l both.txt
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/hello.txt [11/11] -> "both.txt" [1]
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/docs/page1.html [67/67] -> "both.txt" [1]
2 both.txt

-O はシェルの > に近い働きで、取得した内容を順に同じファイルへ書き込みます。別々に保存したいときは -P を使います。

リダイレクトやダウンロード用URLでファイル名を整える

URLの末尾がファイル名らしくないとき、wget は URL 末尾の文字列をそのまま名前にします。サーバーが応答ヘッダー（Content-Disposition）で名前を知らせている場合は、--content-disposition でその名前を使えます。

$ wget -nv http://127.0.0.1:7890/dl
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/dl [12/12] -> "dl" [1]

$ wget -nv --content-disposition http://127.0.0.1:7890/dl
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/dl [12/12] -> "report-2026.csv" [1]

リダイレクト（302）は自動でたどりますが、名前は最初のURLの末尾から付きます。次の例では /old から /hello.txt に転送され、old という名前で保存されました。意図した名前にしたいときは -O を使います。

$ wget -nv http://127.0.0.1:7890/old
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/hello.txt [11/11] -> "old" [1]

中断したダウンロードを再開する（-c）

-c を付けると、途中まで保存されたファイルの続きから取得します。 3,000,000 バイトのファイルのうち 1,000,000 バイトだけ手元にある状態で試しました。

$ wget -c --progress=dot:mega http://127.0.0.1:7890/big.bin
--2026-10-03 10:00:00--  http://127.0.0.1:7890/big.bin
Connecting to 127.0.0.1:7890... connected.
HTTP request sent, awaiting response... 206 Partial Content
Length: 3000000 (2.9M), 2000000 (1.9M) remaining [application/octet-stream]
Saving to: ‘big.bin’

     0K ,,,,,,,, ,,,,,,,. ........ ........ ........ .....   100%  631M=0.003s

2026-10-03 10:00:00 (631 MB/s) - ‘big.bin’ saved [3000000/3000000]

206 Partial Content と remaining が出ていれば、続きから取得できています。 , はすでに手元にあった部分、. は今回受け取った部分です。取得後のファイルは元のファイルと一致しました（cmp で確認）。

すでに全部そろっているファイルに -c を付けても、取り直しにはなりません。

$ wget -c http://127.0.0.1:7890/big.bin
HTTP request sent, awaiting response... 416 Requested Range Not Satisfiable

    The file is already fully retrieved; nothing to do.

直す前と後：-c を付け忘れると別名で最初から

# -c なし：途中までの big.bin（1,000,000バイト）はそのまま、big.bin.1 に最初から保存
$ wget -nv http://127.0.0.1:7890/big.bin; ls -l big.bin* | awk '{print $5, $9}'
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/big.bin [3000000/3000000] -> "big.bin.1" [1]
1000000 big.bin
3000000 big.bin.1

リトライとタイムアウトを設定する

既定の動きを知る

公式マニュアルによると、リトライの既定は20回ですが、「接続拒否（connection refused）」と「404 などの見つからないエラー」はリトライの対象外です。タイムアウトは、読み取りの900秒だけが既定で有効になっています。

タイムアウトを再現する（-T と -t）

応答を返さないURL（30秒待たせるようにしたもの）に、タイムアウト3秒・2回までで接続しました。

$ wget -T 3 -t 2 http://127.0.0.1:7890/slow.txt
--2026-10-03 10:00:00--  http://127.0.0.1:7890/slow.txt
Connecting to 127.0.0.1:7890... connected.
HTTP request sent, awaiting response... Read error (Connection timed out) in headers.
Retrying.

--2026-10-03 10:00:00--  (try: 2)  http://127.0.0.1:7890/slow.txt
Connecting to 127.0.0.1:7890... connected.
HTTP request sent, awaiting response... Read error (Connection timed out) in headers.
Giving up.

-T を指定しないと、読み取りは既定の900秒まで待ち続けます。スクリプトで使うときは -T 10 -t 3 のように、待つ時間と回数を自分で決めておくと、処理が長く止まる場面を防げます。終了コードは 4 でした。

接続拒否を再現する（--retry-connrefused）

何も動いていないポート（7892）に接続すると、-t 3 を付けていても1回で終わります。

$ wget -t 3 --waitretry=1 http://127.0.0.1:7892/x.txt
--2026-10-03 10:00:00--  http://127.0.0.1:7892/x.txt
Connecting to 127.0.0.1:7892... failed: Connection refused.

--retry-connrefused を足すと、指定した回数までリトライします。

$ wget -t 3 --waitretry=1 --retry-connrefused http://127.0.0.1:7892/x.txt
--2026-10-03 10:00:00--  http://127.0.0.1:7892/x.txt
Connecting to 127.0.0.1:7892... failed: Connection refused.
Retrying.

--2026-10-03 10:00:00--  (try: 2)  http://127.0.0.1:7892/x.txt
Connecting to 127.0.0.1:7892... failed: Connection refused.
Retrying.

--2026-10-03 10:00:00--  (try: 3)  http://127.0.0.1:7892/x.txt
Connecting to 127.0.0.1:7892... failed: Connection refused.
Giving up.

サーバーを起動した直後で、まだ接続を受け付けていない時間帯に取得したいときに役立ちます。

503 のときだけリトライする（--retry-on-http-error）

2回 503 を返したあと 200 を返すURLで試しました。オプションなしでは、最初の 503 で終了します。

$ wget -t 5 --waitretry=1 http://127.0.0.1:7890/flaky.txt
HTTP request sent, awaiting response... 503 Service Unavailable
2026-10-03 10:00:00 ERROR 503: Service Unavailable.

$ wget -nv -t 5 --waitretry=1 --retry-on-http-error=503 http://127.0.0.1:7890/flaky.txt
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/flaky.txt [11/11] -> "flaky.txt" [2]

コピペ用：途切れても粘り強く取得する組み合わせ

wget -c -t 5 -T 15 --waitretry=10 --retry-connrefused \
     --retry-on-http-error=429,500,502,503,504 \
     -P downloads URL

-c（再開）とリトライを組み合わせておくと、途中で切れても続きから取り直します。上の形のうち -c -t -T --waitretry --retry-connrefused -P の組み合わせはテスト用サーバーで動作を確認しました。--retry-on-http-error に並べたコードのうち、実際に再現したのは 503 です。

再帰取得でまとめてダウンロードする（-r -l -np）

-r はページ内のリンクをたどって取得します。-l で深さ、-np で「親ディレクトリに上らない」を指定するのが基本の組み合わせです。 テスト用サーバーには次の構成を用意しました。

/docs/index.html     → page1.html、guide/、manual.pdf、logo.png、../other/x.html へのリンク
/docs/page1.html     → guide/deep.html へのリンク
/docs/guide/index.html、/docs/guide/deep.html
/other/x.html        （docs の外）

1階層だけ取得する

$ wget -nv -r -l 1 -np http://127.0.0.1:7890/docs/
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/docs/ [164/164] -> "127.0.0.1:7890/docs/index.html" [1]
http://127.0.0.1:7890/robots.txt:
2026-10-03 10:00:00 ERROR 404: File not found.
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/docs/page1.html [67/67] -> "127.0.0.1:7890/docs/page1.html" [1]
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/docs/guide/ [67/67] -> "127.0.0.1:7890/docs/guide/index.html" [1]
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/docs/manual.pdf [5000/5000] -> "127.0.0.1:7890/docs/manual.pdf" [1]
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/docs/logo.png [2000/2000] -> "127.0.0.1:7890/docs/logo.png" [1]
FINISHED --2026-10-03 10:00:00--
Downloaded: 5 files, 7.1K in 0s (176 MB/s)

読み取れることは3つです。

• ホスト名（ここでは 127.0.0.1:7890）のディレクトリが作られ、その下にURLと同じ構成で保存される
• 最初に robots.txt を取りに行く。 再帰取得では、サイト側が示す巡回ルールを確認する動きが既定になっている（今回は用意していないので 404）
• -l 1 なので、2階層目の guide/deep.html は取得していない

-np の有無で変わる範囲

-np を外して2階層まで取得すると、docs の外にある /other/x.html も対象になりました。

$ wget -nv -r -l 2 http://127.0.0.1:7890/docs/ ; find 127.0.0.1:7890 -type f | sort
（ログ省略）
127.0.0.1:7890/docs/guide/deep.html
127.0.0.1:7890/docs/guide/index.html
127.0.0.1:7890/docs/index.html
127.0.0.1:7890/docs/logo.png
127.0.0.1:7890/docs/manual.pdf
127.0.0.1:7890/docs/page1.html
127.0.0.1:7890/other/x.html

指定したディレクトリの配下だけを取得したいときは -np を付けます。 -l を省くと深さは5階層まで（公式マニュアルの既定値）なので、範囲を決めるために -l も明示するのがおすすめです。

ディレクトリの形を整える（-nH --cut-dirs -P）

$ wget -nv -r -l 2 -np -nH --cut-dirs=1 -P site http://127.0.0.1:7890/docs/ ; find site -type f | sort
（ログ省略）
site/guide/deep.html
site/guide/index.html
site/index.html
site/logo.png
site/manual.pdf
site/page1.html

拡張子で絞る（-A / -R）

$ wget -nv -r -l 2 -np -nd -A pdf,png -P assets http://127.0.0.1:7890/docs/; ls assets
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/docs/ [164/164] -> "assets/index.html.tmp" [1]
（中略）
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/docs/manual.pdf [5000/5000] -> "assets/manual.pdf" [1]
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/docs/logo.png [2000/2000] -> "assets/logo.png" [1]
logo.png
manual.pdf

HTML はリンクをたどるために一度 .tmp として取得され、最後に残るのは -A で指定した拡張子だけです。除外したいときは -R を使います。

再帰取得のオプション早見表

-w 1 --random-wait を付けて /docs/ を1階層ぶん取得したところ、5ファイルで全体 5.5 秒かかりました（付けない場合は 0.007 秒）。相手のサーバーに負荷をかけないよう、再帰取得では -w で間隔を空け、取得してよい範囲かどうかを利用規約と robots.txt で確かめてから実行します。

エラーを再現して対処を確かめる

403 Forbidden

テスト用サーバーに「User-Agent に Wget を含むリクエストには 403 を返す」設定を入れて再現しました。

$ wget http://127.0.0.1:7890/forbidden.txt
--2026-10-03 10:00:00--  http://127.0.0.1:7890/forbidden.txt
Connecting to 127.0.0.1:7890... connected.
HTTP request sent, awaiting response... 403 Forbidden
2026-10-03 10:00:00 ERROR 403: Forbidden.

403 は「リクエストは届いたが、サーバーが応じない」という応答です。原因はサーバー側のルールによってさまざまなので、次の順で確かめます。

今回のテスト用サーバーでは、-U で User-Agent を変えると取得できました。

$ wget -nv -U 'Mozilla/5.0 (X11; Linux x86_64)' http://127.0.0.1:7890/forbidden.txt; cat forbidden.txt
2026-10-03 10:00:00 URL:http://127.0.0.1:7890/forbidden.txt [10/10] -> "forbidden.txt" [1]
secret ok

自分が管理していないサイトでは、403 は「自動取得を受け付けていない」という意思表示であることも多いため、まず提供元の案内（API や配布用URL）を探すのが近道です。

証明書エラー

自己署名証明書を使った HTTPS サーバーで再現しました。

$ wget https://127.0.0.1:7891/hello.txt
--2026-10-03 10:00:00--  https://127.0.0.1:7891/hello.txt
Connecting to 127.0.0.1:7891... connected.
ERROR: cannot verify 127.0.0.1's certificate, issued by ‘CN=localhost’:
  Self-signed certificate encountered.
To connect to 127.0.0.1 insecurely, use `--no-check-certificate'.

終了コードは 5 です。おすすめの対処は、信頼する証明書を --ca-certificate で指定することです。 検証を保ったまま接続できます。

$ wget -nv --ca-certificate=../cert.pem https://127.0.0.1:7891/hello.txt -O tls1.txt
2026-10-03 10:00:00 URL:https://127.0.0.1:7891/hello.txt [11/11] -> "tls1.txt" [1]

--no-check-certificate は検証そのものを省くオプションで、接続先が本物かどうかを確かめないまま通信します。

$ wget -nv --no-check-certificate https://127.0.0.1:7891/hello.txt -O tls2.txt
WARNING: cannot verify 127.0.0.1's certificate, issued by ‘CN=localhost’:
  Self-signed certificate encountered.
2026-10-03 10:00:00 URL:https://127.0.0.1:7891/hello.txt [11/11] -> "tls2.txt" [1]

そのほかのエラーと終了コード

$ wget http://127.0.0.1:7890/none.txt
HTTP request sent, awaiting response... 404 File not found
2026-10-03 10:00:00 ERROR 404: File not found.

$ wget http://no-such-host.invalid/a.txt
Resolving no-such-host.invalid (no-such-host.invalid)... failed: Name or service not known.
wget: unable to resolve host address ‘no-such-host.invalid’

スクリプトでは、終了コードで結果を判定できます。 今回の再現で得られた値と、公式マニュアルの定義を並べます。

$ wget -q -O /dev/null http://127.0.0.1:7890/hello.txt && echo OK || echo NG
OK

curlとの違いと書き換え対応表

wget は「ファイルとして保存する」ことが既定、curl は「標準出力に出す」ことが既定です。 wget はリダイレクトを自動でたどり、再帰取得ができます。curl は多くのプロトコルやHTTPメソッドに対応し、API を呼び出す用途に向いています。

同じ操作の書き換え表です。curl の列は curl 8.5.0 で同じテスト用サーバーに対して実行し、結果を確認しました。

同じエラーを curl で再現したときの表示です。

$ curl -sS -f http://127.0.0.1:7890/forbidden.txt
curl: (22) The requested URL returned error: 403

$ curl -sS https://127.0.0.1:7891/hello.txt
curl: (60) SSL certificate problem: self-signed certificate

$ curl -sS -m 2 http://127.0.0.1:7890/slow.txt
curl: (28) Operation timed out after 2001 milliseconds with 0 bytes received

$ curl -sS http://127.0.0.1:7890/old      # -L なしでは何も表示されない
$ curl -sSL http://127.0.0.1:7890/old
hello wget

curl は 503 に対して --retry だけでリトライし、3回目で取得できました（curl -sS -f --retry 5 --retry-delay 1 -o fl.txt URL）。wget では --retry-on-http-error=503 が必要だったので、リトライの対象になる条件が両者で違う点を覚えておくと役立ちます。

wget2（Fedoraなどの既定）での違い

Fedora 40 以降では、wget コマンドの中身が後継の wget2 になっています（Fedora の変更提案ページを今回開いて確認）。よく使うオプションはそのまま通りますが、いくつか違いがあります。Ubuntu 24.04 の wget2 2.1.0 パッケージを作業用ディレクトリに展開して、同じテスト用サーバーで動かしました。

$ wget2 http://127.0.0.1:7890/hello.txt
[0] Downloading 'http://127.0.0.1:7890/hello.txt' ...
Saving 'hello.txt'
HTTP response 200 OK [http://127.0.0.1:7890/hello.txt]

$ wget2 https://127.0.0.1:7891/hello.txt
ERROR: The certificate is NOT trusted. The certificate issuer is unknown. 
Failed to connect: Certificate error

Fedora の変更提案ページでは、wget2 が対応していない機能として FTP と WARC の2つが挙げられています。ログの文言を grep で判定しているスクリプトは、wget2 では表示が変わるため、終了コードで判定する形にしておくと両方で動きます。 どちらが入っているかは wget --version の1行目で確かめられます。

よくある質問

Q. wget でダウンロードしたファイルはどこに保存されますか？ A. 何も指定しなければ、コマンドを実行したカレントディレクトリに、URL末尾の名前で保存されます。場所を変えるなら -P ディレクトリ、名前も決めるなら -O パス/ファイル名 です。-P はディレクトリを作ってくれますが、-O は作らないので先に mkdir -p しておきます。

Q. -t でリトライ回数を指定したのに、1回で終わってしまいます。 A. 接続拒否（Connection refused）や 404・503 などのHTTPエラーは、既定ではリトライの対象になりません。接続拒否には --retry-connrefused、HTTPエラーには --retry-on-http-error=503 のように対象を指定します。

Q. wget -r で関係のないページまで取得されます。 A. -np（親ディレクトリに上らない）と -l 数（深さ）を付けて範囲を決めます。今回の検証でも、-np を外すと指定したディレクトリの外にあるページが取得されました。拡張子で絞るなら -A pdf,png を足します。

Q. wget と curl はどちらを使えばよいですか？ A. ファイルを保存する、途中から再開する、配下をまとめて取得する、といった用途は wget が短く書けます。API を呼び出す、ヘッダーやメソッドを細かく指定する、応答をパイプで次のコマンドに渡す、といった用途は curl が向いています。

まとめ

• wget URL でカレントディレクトリに保存。 名前は -O、ディレクトリは -P で決める
• -P と -O を両方書くと -O が優先される。 複数URLに -O を付けると1ファイルにつながる
• 再開は -c。 ログに 206 Partial Content と remaining が出れば続きから取得できている
• リトライは既定20回だが、接続拒否とHTTPエラーは対象外。 --retry-connrefused と --retry-on-http-error で対象に加える
• 再帰取得は -r -l 数 -np が基本。 -w で間隔を空け、取得範囲と利用規約を確かめてから実行する
• 証明書エラーは --ca-certificate で信頼する証明書を指定する。 --no-check-certificate は手元での一時的な確認に限る
• スクリプトでは終了コードで判定する。 4 はネットワーク、5 は証明書、8 はサーバーのエラー応答。wget2 でも同じ値だった

株式会社RJCでは、wgetやcurlを使ったファイル取得の仕組みを仲間と学び合っています。こうした知識を共有しながら、日々技術を磨いています。

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。