cURL と b2sum によるダウンロードの検証
一時ファイルにダウンロードし、その BLAKE2b チェックサムを信頼できる配布元の値と比較して、バイト列が一致する場合にのみ保存先を作成します。以下の Bash スクリプトは cURL と b2sum を組み合わせ、既存のファイルを置き換えずに処理します。その後、実際のリリースのチェックサムを使って手順を示します。
配布元から期待するチェックサムを取得
ダウンロードしたファイルに b2sum を実行すると、現在のチェックサムがわかります。ただし、本来のチェックサムはわかりません。対象のリリース、アーキテクチャ、ファイル名に対応する期待値を、信頼できる配布元から取得してください。公式の HTTPS リリースページや、署名を検証済みのチェックサム一覧などが該当します。ダウンロード元と同じ信頼できないミラーからチェックサムをコピーしても、信頼できる照合基準にはなりません。
GNU b2sum のデフォルトは
BLAKE2b-512 で、64 バイトのダイジェストを 128 桁の16進数で表します。このスクリプトでは、その形式が必要です。BLAKE2s、短い BLAKE2b ダイジェスト、SHA-256 は代用できません。配布元が SHA-256 だけを提供している場合は、SHA-256 による検証手順を使用してください。ダウンロードしたファイルを自分でハッシュ化して、BLAKE2b の照合基準を作り出してはいけません。
Linux の前提条件の確認
GNU Bash、HTTPS 対応の cURL、GNU Coreutils がインストール済みの Linux マシンを使用してください。Coreutils には b2sum、mktemp、ln、rm が含まれます。この例は Bash 5.3.15、cURL 8.22.0、Coreutils 9.11 でテストしています。macOS や PowerShell 用の手順ではありません。使用するツールを確認してください。
bash --version && curl --version && b2sum --version
自分で管理するディレクトリ内で、ハードリンクに対応したファイルシステム上で実行してください。保存先には、そのディレクトリ内のファイル名を指定します。別のディレクトリへのパスは指定できません。スペースや先頭のハイフンは使用できますが、スラッシュ、改行、.、.. は拒否されます。ファイルは所有者だけが読み書きできる権限で保存され、既存のファイル、ディレクトリ、シンボリックリンクは変更されません。
検証スクリプト全体の保存
以下を verify-download.sh という名前の新規ファイルとして保存し、bash で実行してください。対話型シェルには貼り付けないでください。エラー時の終了処理は、保存したプログラムを終了させるためのものです。
#!/usr/bin/env bash
set -euo pipefail
export LC_ALL=C
umask 077
if (( $# != 3 )); then
printf 'Usage: bash verify-download.sh HTTPS_URL BLAKE2B_512_HEX FILENAME\n' >&2
exit 2
fi
url=$1
expected=${2,,}
filename=$3
if [[ ! $expected =~ ^[0-9a-f]{128}$ ]]; then
printf 'Expected checksum must contain exactly 128 hexadecimal characters.\n' >&2
exit 2
fi
if [[ $url != https://* ]]; then
printf 'The download URL must use HTTPS.\n' >&2
exit 2
fi
if [[ -z $filename || $filename == */* || $filename == . || $filename == .. ||
$filename == *$'\n'* || $filename == *$'\r'* ]]; then
printf 'Use a filename without slashes or line breaks.\n' >&2
exit 2
fi
destination="./$filename"
if [[ -e $destination || -L $destination ]]; then
printf 'Destination already exists: %s\n' "$destination" >&2
exit 1
fi
temporary=$(mktemp -d ./.b2-download.XXXXXXXX)
trap 'rm -rf -- "$temporary"' EXIT
if ! curl -q -fsSL --globoff --proto '=https' --proto-redir '=https' \
--max-redirs 5 --connect-timeout 10 --max-time 300 \
--output "$temporary/payload" --url "$url"; then
printf 'Download failed; no file saved.\n' >&2
exit 1
fi
if ! printf '%s %s\n' "$expected" "$temporary/payload" |
b2sum --check --strict --status -; then
printf 'Checksum mismatch or unreadable download; no file saved.\n' >&2
exit 1
fi
if ! ln -T -- "$temporary/payload" "$destination"; then
printf 'Destination exists or cannot be created; no file saved.\n' >&2
exit 1
fi
printf 'Verified and saved: %s\n' "$destination"
チェックサム入力は GNU の形式で、ダイジェスト、スペース二個、ファイル名の順に並びます。スクリプトは、ダウンロードした一覧にローカルパスを選ばせず、自身の一時データ用にそのレコードを構築します。--strict は不正な形式のチェックサムレコードを拒否します。また、転送を開始する前に、引数チェックでダイジェスト長が 512 ビットであることを確認します。
最後の処理では、mv ではなくハードリンクを使用します。GNU ln -T は、--force を指定しなければ、保存先が存在する場合に失敗します。最初の確認後に保存先が作成された場合も同様です。一時ファイルを保存先ディレクトリ内に置くことで、ファイルシステムをまたぐリンクを避けます。終了トラップは、通常の成功時と失敗時に専用の一時ディレクトリを削除します。強制終了や停電では残る場合があります。この仕組みはクラッシュ復旧システムではありません。
公開された BLAKE2b チェックサムでリリースをダウンロード
Arch Linux のダウンロードページには、BLAKE2b チェックサム一覧へのリンクがあります。再現可能な例として、参照先が変わる「latest」URL ではなく、2026年9月1日の bootstrap tarball を使用します。約 121 MiB のアーカイブをダウンロードする例であり、このリリースのインストール、展開、実行を指示するものではありません。
配布元のバージョン別チェックサム一覧を HTTPS 経由で読み取ります。
curl -q -fsSL --proto '=https' --proto-redir '=https' --max-time 30 \
--url 'https://archive.archlinux.org/iso/2026.09.01/b2sums.txt'
archlinux-bootstrap-2026.09.01-x86_64.tar.zst で終わる行を探してください。その行の最初のフィールドをコピーします。ISO のチェックサムや、ローカルで生成したチェックサムではありません。以下の呼び出しでは、公開されているその 128 文字の値を使い、一致する tarball を保存します。
(
url='https://archive.archlinux.org/iso/2026.09.01/archlinux-bootstrap-2026.09.01-x86_64.tar.zst'
expected='3893c310ec7d52fd5dee7eec51bc9d611200a5636985c8b627871d1ee85d83821284bcb9a6843afa011a6607ee9ce3202f7e7f5f168f29a07541c0836eeaefd0'
bash verify-download.sh "$url" "$expected" archlinux-bootstrap-2026.09.01-x86_64.tar.zst
)
成功すると、保存したプログラムは次の内容を出力します。
Verified and saved: ./archlinux-bootstrap-2026.09.01-x86_64.tar.zst
保存先が作成されるのは、この時点だけです。期待するチェックサムと一致すれば、空のファイルも有効です。スクリプトが検証するのはバイト列であり、有用なアーカイブになっているかどうかではありません。
ファイル使用前の失敗原因の確認
- チェックサムの不一致: 保存先は作成されず、一時ダウンロードは削除されます。リリース、アーキテクチャ、信頼できる期待値を再確認してください。ダウンロードしたファイル自体のチェックサムを期待値にして、不一致を「修正」してはいけません。
- HTTP、TLS、または転送未完了のエラー: cURL が失敗し、スクリプトはゼロ以外を返し、途中まで取得したデータは削除されます。転送の制限時間は五分です。大きなダウンロードや低速な接続では、意図を持って調整してください。
- 保存先が既存: スクリプトはゼロ以外を返し、既存のバイト列を保持します。以前のダウンロードを確認せずに削除するのではなく、別のファイル名を選んでください。
- 保存先への公開失敗: ハードリンク操作が未対応の場合や、転送中に保存先が作成された場合は成功しません。検証できたというだけでは、ファイルが保存されたことにはなりません。
cURL のオプションによって、転送の失敗を検知できます。-f は大半の HTTP エラーレスポンスを失敗として扱い、-sS は進捗表示を非表示にしつつ診断情報を残し、-L はリダイレクトをたどります。開始 URL とリダイレクトはどちらも HTTPS に限定され、リダイレクトは最大五回です。-q を先頭に置くことで、ローカルの curl 設定が、このコマンドのオプションを無断で変更するのを防ぎます。HTTPS 限定のリダイレクトでも、ホストは変わる場合があります。バイト単位の照合基準は、引き続き信頼できるチェックサムです。
チェックサムの一致が証明すること
一致によって確認できるのは期待するダイジェストとの整合性であり、ファイルが無害であることや、特定の人物が公開したことではありません。この例で信頼の根拠となるのは、Arch Linux の配布元の HTTPS サイトです。攻撃者が配布物とチェックサムの取得元の両方を制御していれば、両方を差し替えられます。その信頼の根拠を超えて配布元を認証するには、配布元の署名検証手順に従い、署名鍵の身元を別途確認してください。
また、このスクリプトは、他のプロセスが作業ディレクトリや保存済みファイルを悪意を持って変更できないことを前提としています。これはローカルでのダウンロード検証であり、サンドボックスでも、検証後にバイト列が変わらないことの保証でもありません。メディアカタログ化ワークフローでは、期待するチェックサムを取得元やリリース情報とともに保管してください。後から比較する際に、根拠を説明できる照合基準として使用できます。
