cURL でファイルをダウンロードして SHA-256 チェックサムを検証
cURL でファイルをダウンロードし、sha256sum で信頼できるチェックサムとバイト列を照合します。以下の Bash スクリプトは、ダウンロードしたファイルを一時ディレクトリに保持し、検証に成功した後にだけ最終的なファイル名を付けます。同じスクリプトをローカルでも GitHub Actions でも実行できます。
信頼できるチェックサムの選択
SHA-256 は 256 ビットのダイジェストを生成し、通常は 64 桁の 16 進数で表記します。ダイジェストの一致によって、ダウンロードしたバイト列を期待値と照合できます。ただし、その値の提供元を証明するものではありません。ダウンロードとチェックサムの両方を置き換えられる者であれば、両者を一致させられます。
期待するチェックサムは、公開元のリリースメタデータから HTTPS 経由で取得し、ダウンロードするバージョン付き URL とともに保管してください。ホスティングサイトとは独立してリリースの真正性を確認する必要がある場合は、所有者の身元を独立した方法で確認した署名鍵を使い、公開元の署名検証手順に従ってください。cURL プロジェクトはリリースアーカイブの分離署名を提供していますが、ここで紹介するチェックサムの例では、それらの署名は検証しません。
Bash による検証の自動化
Bash、HTTPS 対応の cURL ビルド、GNU coreutils の sha256sum、mktemp、ln、rm がある Linux を使用してください。保存先はカレントディレクトリです。書き込み可能で、ハードリンクに対応したファイルシステム上にある必要があります。このスクリプトは GNU ln -T を使います。移植可能な /bin/sh スクリプトでも、macOS 用スクリプトでもありません。例は Ubuntu 24.04 上の Bash 5.2.21、cURL 8.5.0、coreutils 9.4 と、Linux 上の Bash 5.3.15、cURL 8.22.0、coreutils 9.11 でテストしました。
管理下にあるディレクトリに、以下を verify-download.sh として保存してください。以下のように Bash で実行し、シェルに source で読み込まないでください。引数は順に、HTTPS URL、期待する SHA-256 ダイジェスト、ローカルのファイル名の三つです。出力名には空白、先頭のハイフン、リテラルの % 文字を含められますが、スラッシュや改行は含められません。同名のファイル、ディレクトリ、シンボリックリンクがすでにある場合はエラーになり、既存のものは変更しません。
#!/usr/bin/env bash
set -euo pipefail
export LC_ALL=C
if [[ $# -ne 3 ]]; then
printf 'Usage: bash verify-download.sh HTTPS_URL SHA256 OUTPUT_NAME\n' >&2
exit 2
fi
url=$1
expected=$2
output=$3
if [[ $url != https://* || ! $expected =~ ^[[:xdigit:]]{64}$ ]]; then
printf 'Provide an HTTPS URL and a 64-digit hexadecimal SHA-256 checksum.\n' >&2
exit 2
fi
case "$output" in
''|.|..|*/*|*$'\n'*|*$'\r'*)
printf 'Provide a filename without slashes or line breaks.\n' >&2
exit 2
;;
esac
if [[ -e "./$output" || -L "./$output" ]]; then
printf 'Destination already exists: %s\n' "$output" >&2
exit 1
fi
umask 077
temp_dir=$(mktemp -d ./.verify-download.XXXXXX)
trap 'rm -rf -- "$temp_dir"' EXIT
trap 'exit 130' INT
trap 'exit 143' TERM
curl -q -fsSL --globoff --proto '=https' --proto-redir '=https' \
--connect-timeout 10 --max-time 120 --retry 3 \
--output "$temp_dir/payload" --url "$url"
if ! printf '%s %s\n' "$expected" "$temp_dir/payload" | sha256sum --check --status -; then
printf 'SHA-256 mismatch or unreadable download.\n' >&2
exit 1
fi
ln -T -- "$temp_dir/payload" "./$output"
printf 'Verified: %s\n' "$output"
cURL のオプションにより、404 などの HTTP エラーを失敗として扱い(-f)、エラーメッセージを残したまま進行状況の表示を抑え(-sS)、リダイレクトを追跡します(-L)。元のリクエストもリダイレクト先も HTTPS に限定します。--globoff は URL をリテラルとして扱います。先頭に置いた -q は、ローカルの .curlrc によるリクエストの変更を防ぎます。一時的な失敗には最大三回再試行し、転送の試行ごとに
120 秒の制限を設けています。
スクリプトは、ダイジェスト、空白二つ、非公開のペイロードパスからなるチェックサムレコードを一つ作成します。GNU sha256sum --checkは、そのレコードを標準入力から読み取ります。--status により、終了ステータスで検証の成否を判定します。リモートのチェックサムファイルに、検証対象のローカルファイル名を選ばせることはありません。
一致した後、GNU lnが検証済みファイルに最終的な名前を追加します。-T は、保存先にディレクトリが存在する場合も含め、指定された保存先をそのままの名前として扱います。-f を指定しないことで、置き換えを防ぎます。一時ディレクトリを保存先と同じディレクトリ内に置くことで、両方の名前が同じファイルシステム上に存在します。終了時のトラップは一時的な名前とディレクトリを削除し、検証済みファイルは最終的な名前で残ります。
ダウンロードやチェックサムの検証が失敗すると、最終ファイルを作成せずに一時データを削除し、非ゼロの終了ステータスを返します。再実行時は新たにダウンロードを開始し、途中まで取得したバイト列からは再開しません。トラップは通常の割り込みにも対応しますが、電源障害や SIGKILL によって .verify-download.* ディレクトリが残り、手動での削除が必要になることがあります。これは所有するディレクトリへのダウンロード用であり、ファイルを変更できる別のプロセスから保護するものではありません。
cURL リリースの検証
cURL 8.22.0 リリースには
curl-8.22.0.tar.gz が含まれます。リリースメタデータには、そのアセットの
digest が
sha256:d54dd598bf05927a726deb38df31c6a255ba83ff1de57c5d1464dac3ed8f44a1 と記載されています。sha256: に続く 64 文字を期待値として使います。.tar.xz と .zip のアセットは、バイト列もチェックサムも異なります。
これは JSON メタデータであり、sha256sum --check の入力ファイルではありません。ダウンロード URL に .sha256 を付けてチェックサムの URL を推測しないでください。curl-8.5.0.tar.gz.sha256 のそのアドレスにはファイルがありません。ここではリリースアセット向けに公開されたダイジェストを固定し、curl.se からアーカイブをダウンロードします。
bash verify-download.sh \
'https://curl.se/download/curl-8.22.0.tar.gz' \
'd54dd598bf05927a726deb38df31c6a255ba83ff1de57c5d1464dac3ed8f44a1' \
'curl-8.22.0.tar.gz'
成功すると、コマンドは終了ステータスゼロで終了し、次のように出力します。
Verified: curl-8.22.0.tar.gz
これでカレントディレクトリにアーカイブが保存されました。これはソースコードのダウンロードであり、cURL のインストールやアップグレードは行いません。同じ例を再実行するには、別の出力名を使うか、前回のダウンロードを意図的に削除してください。別のリリースを検証するには、対象のアセットを正確に選び、URL とダイジェストの両方を更新します。
GitHub Actions との連携
verify-download.sh をリポジトリのルートに置き、以下のワークフローを .github/workflows/verify-download.yml として保存してください。同じ固定 URL とダイジェストを使用します。最後のステップは Ubuntu の
tar と gzip で検証済みアーカイブの内容を一覧表示します。検証が機能することを確認したら、この部分をビルドステップに置き換えてください。
name: Verify download
on: [push, pull_request]
permissions:
contents: read
jobs:
verify:
runs-on: ubuntu-24.04
timeout-minutes: 10
steps:
- uses: actions/checkout@v6
- name: Download and verify
shell: bash
run: |
bash verify-download.sh \
'https://curl.se/download/curl-8.22.0.tar.gz' \
'd54dd598bf05927a726deb38df31c6a255ba83ff1de57c5d1464dac3ed8f44a1' \
'curl-8.22.0.tar.gz'
- name: Read verified archive
shell: bash
run: tar -tzf curl-8.22.0.tar.gz > /dev/null
GitHub Actions はデフォルトで、失敗後の後続ステップを停止します。この動作を維持してください。continue-on-error や、強制的に成功扱いにする || true を追加すると、検証に失敗しても後続のステップが進んでしまいます。チェックサムの変更は依存関係の更新と併せてレビューしてください。ダウンロード直後のファイルから「期待する」ダイジェストを計算しても、そのファイルをそれ自身と比較するだけです。
トラブルシューティング
curl: (22)などの HTTP エラー:アセットの正確な URL を確認してください。エラーページをリリースアーカイブとして扱ってはいけません。HTTP へのリダイレクトも、到達可能な宛先であっても拒否されます。curl: (18)などの不完全な転送:サーバーが通知した長さのデータが届く前に、レスポンスが閉じられました。接続を確認してから再試行してください。サーバーが短いファイルを成功レスポンスとして返しても、チェックサムの比較で変更されたバイト列を拒否します。- SHA-256 の不一致:リリースバージョンとアーカイブの拡張子を、公開元のメタデータと照合してください。期待するチェックサムを、疑わしいダウンロードから得た値で置き換えないでください。
- 保存先がすでに存在:以前のファイルは保持されます。別のローカル名を選ぶか、以前のダウンロードを確認し、自分で削除してください。
- ハードリンクまたは書き込みのエラー:ハードリンクに対応した、書き込み可能なローカルファイルシステムを使用してください。最終的な名前での保存に失敗すると、チェックサムが一致していても非ゼロの終了ステータスを返します。
