cURL による ZIP、tar.gz、gzip のダウンロードと展開
cURL の出力を tar または gzip にパイプで渡すと、ダウンロード中に展開できます。ZIP ファイルは、まず一時ファイルにダウンロードし、その後で unzip を実行します。以下の例ではダウンロードと展開の両方を確認し、既存の出力ディレクトリは再利用しません。
ダウンロード用の基本的な cURL コマンド
Linux 上の Bash、cURL、GNU tar、GNU gzip、Info-ZIP UnZip と、標準ユーティリティの mkdir、mktemp、rm を使用します。コマンドは Ubuntu 24.04 上の Bash 5.2、cURL 8.5.0、GNU tar 1.35、gzip 1.12、UnZip 6.00 でテストしています。PowerShell や汎用の sh 向けのコマンドではありません。
形式に合ったブロックを選び、https://example.com/… の URL を信頼できるダウンロード先の
URL に置き換えてください。所有していて書き込み権限のあるディレクトリから、括弧を含むブロック全体を Bash で実行します。各ブロックは単独で動作します。extract.sh として保存し、bash extract.sh を実行することもできます。
ここで使用する cURL のオプションは次のとおりです。
-f:404 などの HTTP エラー時に、エラーページを展開ツールへ渡さず、エラーを返します。-sS:進捗表示を非表示にしますが、エラーは表示します。-L:リダイレクトを追跡します。-o:標準出力ではなく、指定したファイルにダウンロード内容を書き込みます。
出力ディレクトリは、空であっても存在していてはいけません。mkdir はダウンロード開始前にそのディレクトリを確保します。このコマンドを mkdir -p に変更しないでください。クリーンアップ用のトラップは作成が成功した後にのみ設定されるため、再実行しても前の結果は変更されません。umask 077 は新しく作成する作業ディレクトリを自分のユーザーだけがアクセスできるようにします。ただし、アーカイブ内のエントリには固有のモードが含まれる場合があります。
アーカイブ形式ごとの処理
ZIP アーカイブ(.zip)
Info-ZIP UnZip 6.0 は標準入力からアーカイブを読み込めません。-p オプションは展開したファイルを標準出力に送るもので、ZIP をパイプ経由で入力するためのものではありません。この制約は UnZip のマニュアルに記載されています。展開ツールがファイル内をシークできるよう、ダウンロードした通常のファイルを使用してください。
(
umask 077
dest='./zip-output'
mkdir -- "$dest" || exit
trap 'rm -rf -- "$dest"' EXIT
work=$(mktemp -d) || exit
trap 'rm -rf -- "$work" "$dest"' EXIT
curl -fsSL 'https://example.com/archive.zip' -o "$work/archive.zip" || exit
unzip -q "$work/archive.zip" -d "$dest" </dev/null || exit
rm -rf -- "$work" || exit
trap - EXIT
printf 'Extracted to %s\n' "$dest"
)
成功すると、アーカイブ内のディレクトリ構造を保ったまま、./zip-output/ の配下にファイルが配置されます。mktemp -d は $TMPDIR に、未設定の場合は /tmp に、一意の一時ディレクトリを作成します。削除されるのは、その専用の archive.zip のコピーだけです。カレントディレクトリにある temp.zip という名前のファイルは使用しません。この例は暗号化されていない ZIP ファイル用です。標準入力を閉じることで、対話式の入力プロンプトによってコマンドが待機状態になるのを防ぎます。
gzip 圧縮された tar アーカイブ(.tar.gz または .tgz)
gzip 圧縮された tar アーカイブは、GNU tar に直接ストリーミングできます。
(
set -o pipefail
umask 077
dest='./tar-output'
mkdir -- "$dest" || exit
trap 'rm -rf -- "$dest"' EXIT
curl -fsSL 'https://example.com/archive.tar.gz' | tar -xzf - -C "$dest" || exit
trap - EXIT
printf 'Extracted to %s\n' "$dest"
)
ここでは、-x がファイルを展開し、-z が gzip 圧縮を解除し、-f - が標準入力からアーカイブを読み込み、-C が展開先ディレクトリを指定します。ファイルは ./tar-output/ の配下に配置され、圧縮アーカイブは保存されません。アーカイブに最上位ディレクトリが含まれる場合、そのディレクトリは
tar-output 内に残ります。
Bash の pipefail オプションは、cURL または tar のどちらかが失敗した場合にパイプラインを失敗させます。この設定がないと、展開ツールが成功したことで転送の失敗が見えなくなる場合があります。利用可能なアーカイブのバイト列を送った後に転送エラーが報告される場合も同様です。|| exit はサブシェルから失敗ステータスを返し、クリーンアップを起動します。括弧で囲むことで、これらのシェル設定や exit の呼び出しが対話セッションに影響しないようにしています。
gzip アーカイブ(.gz)
gzip 単体はバイトストリームを圧縮するもので、ディレクトリツリーは提供しません。gzip -dc とリダイレクトを使い、出力ファイル名を明示的に指定します。
(
set -o pipefail
umask 077
dest='./gzip-output'
mkdir -- "$dest" || exit
trap 'rm -rf -- "$dest"' EXIT
curl -fsSL 'https://example.com/file.gz' | gzip -dc > "$dest/payload" || exit
trap - EXIT
printf 'Decompressed to %s/payload\n' "$dest"
)
-d は圧縮を解除し、-c は標準出力に書き込みます。元のファイルが空の場合やバイナリデータを含む場合も、結果は ./gzip-output/payload です。格納先のディレクトリを設けることで、リダイレクトが以前の結果を切り詰めるのを防ぎます。.gz という名前のファイルに実際には tar アーカイブが含まれている場合は、その URL を tar の例で使用して、アーカイブ内のファイルを展開してください。
セキュリティ上の注意点
これらのコマンドは、信頼できる配布元のアーカイブに対して、通常のユーザー権限で使用してください。新しいディレクトリは既存の出力を誤って再利用するのを防ぎますが、サンドボックスではありません。アーカイブ内のパス、リンク、アクセス権限、展開ツールの脆弱性、過大な展開後サイズには引き続き注意が必要です。GNU tar のセキュリティガイダンスでは、信頼できないアーカイブを展開するリスクを説明しています。--strip-components はパス構造を変更するもので、任意のアーカイブを安全にするものではありません。
ストリーミングでは転送完了前にファイルへの書き込みが始まります。終了ステータスがゼロで、成功メッセージが表示されたことを確認してからファイルを使用してください。ダウンロードまたは展開でエラーが起きると、トラップが新しく作成した出力ディレクトリを削除します。強制終了やクリーンアップ時の権限エラーでは、不完全なファイルが残る場合があります。再試行用に新しい出力先を選ぶ前に、そのディレクトリを確認してください。
よくある問題とトラブルシューティング
- 出力先がすでに存在する: 新しい
destの名前を選んでください。コマンドは意図的にダウンロード前に失敗し、既存のディレクトリ、ファイル、シンボリックリンクを保護します。 - cURL が HTTP エラーや接続エラーを報告する: ダウンロード URL とアクセス要件を確認してください。HTTP 200 を返す Web ページでもアーカイブとは限りません。ダウンロード内容を展開ツールが受け付けることも必要です。
- 展開ツールが予期しない EOF、チェックサムエラー、形式の不正を報告する: 処理は失敗したものとして扱ってください。形式を確認し、配布元から完全なコピーを入手してください。
.gzという拡張子だけでは、中身が tar アーカイブかどうかは分かりません。 - 転送が何度も途切れる: 原因を解消してからブロック全体を再実行してください。パイプに再試行フラグを追加するだけではいけません。cURL は下流へ送信済みのバイト列を取り消せません。再試行のドキュメントでも、リダイレクト先の出力にデータが重複して書き込まれる可能性が警告されています。
- 展開中に空き容量が不足する: 展開後のファイルを格納できる容量を確保してください。ZIP の例では、一時ディレクトリにダウンロードしたアーカイブを保存する容量も必要です。
アーカイブを保存するタイミングの選択
tar.gz と gzip のストリーミングでは、圧縮されたダウンロードファイル用のディスク容量を節約できます。配布元のチェックサムとの照合や署名の検証を展開前に行う必要がある場合は、まず新しい作業ディレクトリにダウンロードし、そのファイルを検証してください。展開ツールがアーカイブを受け付けたことは、読み込めたことを示すだけで、誰が公開したものかを証明するものではありません。
