Linuxでsha256sumを使ってダウンロードを検証する方法
Linuxのsha256sumでファイルをSHA256SUMSと照合する手順を解説します。1バイト変更すると検証が失敗する実例で、チェックサムが証明する範囲も確認できます。
チェックサムでダウンロードを2分で検証する
チェックサムでダウンロードを検証するには、受け取ったファイルをハッシュ化し、そのハッシュを公開元が示した値とツールで比較します。sha256sumはこの2つの処理を実行できます。単独ではダイジェストを表示し、-cを指定するとダイジェストの一覧を読み込み、一致するファイルを報告します。このガイドでは、作成したファイルを使って一連の手順を実行します。その後、意図的にファイルを壊し、失敗が発生する様子を確認します。説明を読むだけではありません。
全体を通して、次の点を覚えておいてください。チェックサムで確認できるのは、手元のバイト列がそのダイジェストを生成したバイト列と同じかどうかです。誰がそのバイト列を生成したかは確認できません。後者を確認するには、信頼できる署名と鍵が必要です。このガイドの最後では、この2つの違いを具体的に示します。
練習用のファイルを作成する
システムの他の部分に影響しないよう、作業は一時ディレクトリで行います。以下の各コマンドは GNU coreutils に含まれています。Ubuntu または Debian サーバーに標準で用意されている基本コマンドセットなので、インストールは不要です。
mkdir -p ~/checksum-demo
cd ~/checksum-demo
printf 'the payload of a totally ordinary download\n' > payload.txt
sha256sum payload.txt1 行が表示されます。64 個の16進数文字、2 個のスペース、ファイル名の順です。この64文字がファイルのダイジェストです。同じコマンドをもう一度実行しても、同じ行が表示されます。ハッシュ値は決定論的であり、同じ入力からは常に同じ出力が得られるためです。ファイルの文字を1つ変更してもう一度実行すると、ダイジェストは少しだけ変わるのではありません。まったく異なる値になります。入力の1ビットを反転すると、出力のおよそ半分のビットが反転するためです。この性質により、64文字の文字列を4 GBのイメージの代用として使用できます。
SHA256SUMS ファイルを保存して確認する
画面に表示したダイジェストは、翌日には役に立ちません。sha256sum 自体が書き出す形式でファイルに保存すると、後でツールから読み戻せます。
sha256sum payload.txt > SHA256SUMS
cat SHA256SUMS
sha256sum -c SHA256SUMSsha256sum -c はリストの各行を読み取り、その行に記載されたファイルをハッシュ化して、2 つのダイジェストを比較します。正常に実行されると、ファイルごとに 1 行を出力します。
payload.txt: OK終了ステータスも確認してください。スクリプトはテキストではなく、終了ステータスを読み取るためです。echo $? は、正常に完了すると 0 を出力します。SHA256SUMS という名前は規則ではなく慣例ですが、ディストリビューションやほとんどのリリースページで使われています。そのため、同じ名前を使えば、ファイルを開かなくても内容を次の担当者が把握できます。
1 バイト変更してチェックの失敗を確認する
ここで、意図的にファイルを壊します。次のコマンドはオフセット 5 の 1 バイトだけを書き換え、それ以外は変更しません。そのため、ファイルの長さと名前は維持されます。
printf 'X' | dd of=payload.txt bs=1 seek=5 conv=notrunc status=none
cat payload.txt
sha256sum -c SHA256SUMS重要なのは conv=notrunc フラグです。このフラグがないと、dd は書き込みが停止した位置でファイルを切り詰めます。その場合、より明らかな種類の破損を検証することになります。チェック結果は次のようになります。
payload.txt: FAILED
sha256sum: WARNING: 1 computed checksum did NOT matchecho $? は 1 を出力します。FAILED は、ファイルが読み取られ、そのダイジェストがリスト内の値と一致しなかったことを示します。元のバイトを戻し、チェック結果が OK に戻ることを確認します。
printf 'the payload of a totally ordinary download\n' > payload.txt
sha256sum -c SHA256SUMSこれが基本的な手順のすべてです。ファイル内のどこであっても 1 バイト異なるだけで、FAILED が生成されます。接続が切れて途中で止まったダウンロード、前日のビルドを提供するミラー、転送中にファイルを書き換えたプロキシ、誤ったブロックを返したディスク。いずれの場合も、同じ行に結果が表示されます。
リストにダウンロードしていないファイルが記載されている場合
ディストリビューションが提供する実際の SHA256SUMS ファイルには、ダウンロードディレクトリにあるすべてのイメージが記載されています。ここでは、そのうち 1 つをダウンロードしたとします。ただし、プロジェクトがリリースするすべてのイメージが、常に 1 つのリストに含まれるとは限りません。2026 年 11 月時点では、Ubuntu は 24.04 の amd64 用と arm64 用のリリース ISO を、別々のサーバー上にある別々のリストで管理しています。一方、daily Noble リストには amd64 用デスクトップイメージと arm64 用デスクトップイメージが並んで記載されています。ここでは、その状況を再現します。
printf 'a second file\n' > notes.txt
sha256sum payload.txt notes.txt > SHA256SUMS.all
rm notes.txt
sha256sum -c SHA256SUMS.allpayload.txt: OK
sha256sum: notes.txt: No such file or directory
notes.txt: FAILED open or read
sha256sum: WARNING: 1 listed file could not be readFAILED open or read は FAILED とは異なる失敗です。この 2 つを混同すると、切り分けに時間がかかります。FAILED はバイト列が正しくないことを示します。FAILED open or read は sha256sum がファイルを開けなかったか、読み取りを完了できなかったことを示します。そのため、ダイジェストは比較されていません。実際のダウンロードで通常の原因となるのは、作業ディレクトリです。リスト内の相対パスは、コマンドを実行した場所を基準に解決されるためです。ファイルを置いたディレクトリへ移動してから、もう一度実行してください。実際に存在するファイルだけを確認するには、次のように指定します。
sha256sum --ignore-missing -c SHA256SUMS.allこれは payload.txt: OK を出力して、終了ステータス 0 で終了します。リストにある名前が 1 つも存在しない場合、--ignore-missing はファイル数が 0 でも黙って成功しません。no file was verified と報告して、0 以外の終了ステータスで終了します。これは望ましい動作です。何も確認していないのに成功する検証は、最も気付きにくい失敗だからです。
目視せずに公開済みのダイジェストを貼り付ける
64 文字の 16 進数を目視で比較する場面で、この習慣は大きな問題になります。先頭 4 文字と末尾 4 文字だけを確認して一致したと判断する人がいますが、それこそ攻撃者が狙う比較方法です。比較はツールに任せます。EXPECTED に公開元からコピーしたダイジェストを設定します。EXPECTED= の後にコピーした値を指定し、-c が想定する 1 行を作成します。
printf '%s %s\n' "$EXPECTED" payload.txt > payload.sha256
cat payload.sha256
sha256sum -c payload.sha256ダイジェストとファイル名の間には 2 つの空白があります。そのため、フォーマット文字列にも 2 つの空白が含まれます。これは sha256sum が書き出す形式であり、-c が解析する形式です。ダイジェストだけを含むファイルはチェックサム行ではありません。そのため、チェックでは対象ファイルを推測せず、no properly formatted checksum lines found によりファイル全体を拒否します。プロジェクトによっては、BSD のタグ付き形式を公開しています。これは SHA256 (payload.txt) = の後にダイジェストを続ける形式です。GNU coreutils は sha256sum --tag payload.txt でこの形式を書き出し、-c で読み戻します。どちらの形式で保存しても問題ありません。
チェックの動作がおかしい場合は、cat -A SHA256SUMS でリスト自体を確認します。cat -A SHA256SUMS は各行の末尾を $ で示し、通常は見えない文字も表示します。^M$ で終わる行には、Windows のエディターによる復帰文字が含まれています。GNU sha256sum はこの末尾の文字を無視し、それでも OK を出力します。そのため、CRLF のリストがチェックを壊しているわけではありません。ただし、coreutils 以外のツールはこの形式を許容しない場合があります。保存するコピーは tr -d '\r' < SHA256SUMS > SHA256SUMS.clean で正規化します。
チェックサムが証明すること、証明しないこと
チェックサムが証明するのは、1 つだけです。ディスク上のバイト列が、公開されたダイジェストを生成したバイト列と同一であることです。これにより、偶発的な破損は完全に検出できます。ダイジェストを公開したページには触れられないものの、ダウンロードミラー上のファイルを差し替えた不注意な攻撃者に対しても有効です。
作成者が誰であるかは、何も証明しません。ダイジェストが示すのはバイト列に関する事実であり、人に関する事実ではありません。1 つのページがファイルとダイジェストの両方を提供している場合、一方を変更できる人はもう一方も変更できます。その場合、OK の行が示すのは、ミラーが自分自身と一致していることだけです。そこで、チェックサムを計算する価値を確保するルールがあります。ファイルを取得した場所とは別の場所からダイジェストを取得します。たとえば、イメージはミラーまたは torrent から取得し、プロジェクトの公式ドメインから TLS (transport layer security) 経由でダイジェストを取得します。これで攻撃者は、1 か所ではなく 2 か所を制御する必要があります。ただし、検証済みのバイト列を実行したときに何をするかについては、何も分かりません。これは、install script から エージェントの権限で実行される dsh plugin まで、自分の代わりに実行されるものすべてについて確認すべき別の問題です。
アルゴリズムも重要です。SHA-256 (secure hash algorithm, 256-bit output) では、2026 年 10 月時点で既知の衝突がないため、公開者はこれを使用しています。MD5 (message digest 5) と SHA-1 は信頼できません。同じ MD5 ダイジェストを持つ異なるファイルは 2004 年以降作成可能であり、選択プレフィックス SHA-1 衝突は 2020 年に公開されています。MD5SUMS ファイルでも、ダウンロードが途中で切れた場合は検出できます。ランダムな破損は、巧妙に作成された衝突ではないためです。ただし、だます目的の攻撃者を阻止することはできません。プロジェクトが両方を公開している場合は、SHA-256 の行を使用します。
署名が引き継ぐ範囲
署名は、ダイジェストでは確認できない部分を補います。公開者は秘密鍵でダイジェストファイルに署名し、利用者は公開鍵でそれを検証します: gpg --verify SHA256SUMS.asc SHA256SUMS。検証に成功すれば、そのダイジェスト一覧がその鍵を保有する者から提供されたことを確認できます。続いて sha256sum -c SHA256SUMS により、ディスク上のファイルと一覧の対応が確認され、鍵から実際のバイト列まで検証の連鎖がつながります。
弱点は鍵に移ります。ファイルを提供したのと同じページから鍵を取得すると、攻撃者に両方を置き換える機会を与えてしまいます。GnuPG はこの点を正しく扱っており、最初の検証では Good signature と WARNING: This key is not certified with a trusted signature! が表示されます。Good signature は、暗号学的な計算が成立したことを意味します。利用者が想定しているプロジェクトにその鍵が属していることを意味するわけではありません。別ドメインにあるプロジェクトのドキュメントや、すでにその鍵を収録しているディストリビューションのパッケージなど、別の情報源からフィンガープリントを取得し、末尾 8 文字ではなく完全なフィンガープリントを比較してください。これは SSH の秘密鍵に求められるのと同じ注意 です。理由も同じです。鍵が信頼の判断を担い、その後のすべての検証が鍵を引き継ぐためです。
再現可能ビルドは、この考え方をさらに進めます。公開されたダイジェストだけでは、1 台のマシンがビルドしたバイナリを信頼することになります。プロジェクトのビルドが再現可能であれば、誰でも同じソースをコンパイルしてバイト単位で同一の出力を得られるため、独立したビルダーが公開ダイジェストを検証できます。1 台のサーバーの説明をそのまま信頼する必要はありません。自動化されたパイプラインや機械が作成したパッチを通じてコードが届く機会が増えているため、この点は年々重要になっています。ビルドに受け入れる内容を決めるのはポリシーの問題です。AI 支援コードに関するオープンソースポリシーも、サプライチェーンの反対側から同じ仕組みに取り組みます。
パッケージマネージャーはすでにこれを実行しています
Debian と Ubuntu では、apt が、明示的に指示しなくても、すべてのインストールでこの検証チェーンを実行します。パッケージインデックスには、各 .deb ファイルの SHA-256 ダイジェストが含まれています。Release ファイルには、それらのインデックスファイルのダイジェストが含まれます。さらに InRelease には Release に対する署名が含まれます。この署名は、そのリポジトリの Signed-By オプションで指定された鍵に照合されます。指定できる鍵は、/usr/share/keyrings にパッケージがインストールした keyring、/etc/apt/keyrings に配置した鍵ファイル、または .sources ファイル自体に埋め込まれた鍵です。チェーンのどこかで検証に失敗すると、apt はそのことを報告します。ただし、正確な文言は APT のバージョンと、その背後で動作する検証ツールによって異なります。gpgv で検証する APT は、サードパーティーリポジトリの鍵がない場合、The following signatures couldn't be verified because the public key is not available: に続けて NO_PUBKEY と鍵 ID を出力します。Sequoia の sqv で検証する新しい APT は、使用可能な keyring が見つからない場合に The signatures couldn't be verified because no keyring is specified を報告します。それ以外の場合は、Sub-process ... returned an error code の後に sqv 独自のエラーをそのまま出力します。別のメッセージである Hash Sum mismatch は、取得したインデックスが署名済みの Release と一致しないことを示します。通常は、キャッシュプロキシが古いファイルを返したか、ミラーの同期中に取得したことが原因です。
プロジェクトのホームページが、curl からスクリプトを直接 shell にパイプするよう指示している場合は、これを基準に判断してください。その方法では、バイト列は何も検証されず、内容を確認することもできません。さらに、サーバーがスクリプトにはある内容を返し、ブラウザーには別の内容を返す可能性もあります。その後で調査できるコピーも残りません。curl -fsSL <url> -o install.sh でファイルにダウンロードし、ハッシュを計算して、less で内容を読み、最後に実行してください。この習慣にかかる時間は約 20 秒です。これは、他のものをサーバーにインストールする前に、新しい VPS を最初の 10 分で準備する場合にも始める価値があります。
手動でインストールしたファイルのダイジェスト一覧を保持する
apt でインストールしたパッケージは追跡されます。/usr/local/bin にコピーしたバイナリは追跡されず、システム上で監視もされません。ダイジェスト一覧を作成すると、必要なときに確認できるようになります。
printf 'a second file\n' > notes.txt
sha256sum *.txt > inventory.sha256
sha256sum -c --quiet inventory.sha256--quiet は OK 行を削除するため、すべてのファイルが一致する場合は何も出力しません。一致しないファイルがある場合は、各ファイルについて FAILED 行を出力し、標準エラー出力に警告の概要を追加します。つまり、無出力が合格を示し、echo $? がその結果を 0 で確認します。これはスケジュールされたジョブに指定する形式です。--status を使うと、出力を完全になくし、終了ステータスだけを残せます。同じパターンを sha256sum /usr/local/bin/* > ~/local-bin.sha256 で実際のファイルに指定すれば、ベースラインを作成できます。パスは入力したとおりに一覧へ保存されるため、絶対パスを使うと、どのディレクトリからでもチェックできます。
そのベースラインの価値を正しく理解してください。変更されたファイルは検出できます。しかし、すでに root 権限を持つ攻撃者は検出できません。その攻撃者はバイナリを書き換えたのと同じように、inventory.sha256 も簡単に書き換えられるためです。ベースラインに意味を持たせるには、一覧をマシンの外部に保管してください。これは、実際にどの程度 VPS を信頼しているか、そしてその下にあるディスクへほかの誰がアクセスできるかという、より広い問題の一部です。
FAQ
一致するチェックサムは、ダウンロードが安全であることを意味しますか?
いいえ。手元のバイト列が、比較対象のダイジェストと一致したことを意味するだけです。ダイジェストを公開したページを攻撃者が制御している場合、攻撃者は自分のファイルのダイジェストを公開するため、検証結果には OK と表示されます。一致が示すのは整合性です。安全性を確認するには、別の経路で入手した鍵を使って署名を検証する必要があります。その場合に限り、ダイジェストにもその鍵への信頼が引き継がれます。
sha256sum -c が FAILED open or read と表示されるのはなぜですか?
ファイルを開けなかったか、読み取れなかったため、ダイジェストを比較できなかったからです。ファイルが存在しない場合は、その直前に探したファイル名とともに No such file or directory と表示されます。SHA256SUMS ファイル内で / で始まらない名前は、コマンドを実行したディレクトリを基準に解決されます。そのため、ダウンロードを保存したディレクトリへ移動して、もう一度実行してください。一覧にダウンロードしていないファイルも含まれている場合は、--ignore-missing を追加します。open or read のない単独の FAILED は逆の状況を示します。ファイルは読み取られましたが、ダイジェストが一致していません。
ダウンロードの検証に MD5 で十分ですか?
偶発的な破損の検出には十分です。転送の途中で切れたり、ディスクのブロックが破損したりした結果、偶然一致する MD5 ダイジェストが生成される可能性は極めて低いためです。ただし、攻撃者への対策としては不十分です。MD5 ダイジェストが同じ異なるファイルは 2004 年から作成可能であり、SHA-1 も 2020 年に chosen-prefix collision の影響を受けました。プロジェクトが SHA-256 と MD5 の両方を公開している場合は、SHA-256 の行を使用してください。MD5 しか提供しないプロジェクトは、古いリリース手順を示していると考えてください。
sha256sum -c と gpg --verify の違いは何ですか?
sha256sum -c は、ファイルがダイジェストと一致することを確認します。gpg --verify は、特定の秘密鍵の所有者がダイジェストファイルに署名したことを確認します。両者は異なる問いに答えるため、プロジェクトが両方を提供している場合は両方を実行してください。署名によってダイジェスト一覧の信頼性を確認し、そのダイジェスト一覧によってダウンロードしたファイルの信頼性を確認します。
Web ページに表示されたダイジェストと 1 つのファイルを照合するにはどうすればよいですか?
文字列を目視で比較しないでください。ダイジェストとファイル名を、2 個のスペースで区切って 1 行に保存します。その後、sha256sum -c をそのファイルに対して実行し、表示された OK または FAILED を確認します。printf '%s %s\n' で行を作成すると、形式の誤りを避けられます。こうした誤りがあると、sha256sum は no properly formatted checksum lines found と表示してファイルを拒否します。