Linux download verifiëren met sha256sum
Leer hoe u een bestand controleert met sha256sum en SHA256SUMS bestanden. Wijzig een byte om de foutmelding te zien en begrijp precies wat een checksum wel en niet bewijst.
Een download verifiëren met een checksum in twee minuten
Om een download met een checksum te verifiëren, genereert u een hash van het ontvangen bestand en laat u een tool deze hash vergelijken met de hash die de uitgever heeft gepubliceerd. sha256sum voert beide delen van deze taak uit: op zichzelf print het een digest, en met -c leest het een lijst met digests en rapporteert het welke bestanden overeenkomen. Deze handleiding doorloopt de volledige procedure met een bestand dat u zelf aanmaakt, waarna u het bestand opzettelijk beschadigt om de foutmelding in de praktijk te zien in plaats van er alleen over te lezen.
Houd gedurende het hele proces één zin in gedachten. Een checksum vertelt u of de bytes die u bezit de bytes zijn die de digest hebben geproduceerd, maar het vertelt u niets over wie ze heeft geproduceerd. Die tweede vraag vereist een handtekening en een sleutel die u vertrouwt. Het laatste deel van deze handleiding laat precies zien waar de grens tussen beide ligt.
Een bestand aanmaken om mee te oefenen
Werk in een tijdelijke map zodat uw acties geen invloed hebben op de rest van het systeem. Elk onderstaand commando is onderdeel van GNU coreutils, de standaardset met commando's die op elke Ubuntu- of Debian-server aanwezig is; er hoeft dus niets geïnstalleerd te worden.
mkdir -p ~/checksum-demo
cd ~/checksum-demo
printf 'the payload of a totally ordinary download\n' > payload.txt
sha256sum payload.txtU krijgt één regel te zien: 64 hexadecimale tekens, twee spaties en vervolgens de bestandsnaam. Die 64 tekens vormen de hash van het bestand. Voer het commando opnieuw uit en de regel is identiek, omdat hashing deterministisch is: dezelfde invoer levert altijd dezelfde uitvoer op. Wijzig één teken in het bestand en voer het commando opnieuw uit; de hash verschuift niet slechts een klein beetje. De reeks ziet er volledig anders uit, omdat het wijzigen van één bit in de invoer ongeveer de helft van de uitvoerbits doet kantelen. Die eigenschap maakt een tekenreeks van 64 tekens een bruikbare vervanger voor een image van 4 GB.
Sla een SHA256SUMS-bestand op en controleer dit vervolgens
Een hash op het scherm is een dag later waardeloos. Schrijf deze naar een bestand in het formaat dat sha256sum zelf gebruikt, zodat de tool het later weer kan inlezen.
sha256sum payload.txt > SHA256SUMS
cat SHA256SUMS
sha256sum -c SHA256SUMSsha256sum -c leest elke regel van de lijst, berekent de hash van het bestand dat op die regel staat en vergelijkt beide hashes. Een succesvolle uitvoering geeft één regel per bestand weer:
payload.txt: OKControleer ook de exit-status, aangezien een script dit leest en nooit de tekst zelf verwerkt. echo $? geeft 0 weer na een foutloze uitvoering. De naam SHA256SUMS is eerder een conventie dan een regel, maar distributies en de meeste releasepagina's gebruiken deze naam. Gebruik deze daarom ook, zodat de volgende persoon weet wat het bestand bevat zonder het te openen.
Wijzig één byte en zie hoe de controle faalt
Maak het bestand nu opzettelijk kapot. Dit schrijft een enkele byte op offset 5 en laat de rest ongemoeid, waardoor het bestand zijn lengte en naam behoudt.
printf 'X' | dd of=payload.txt bs=1 seek=5 conv=notrunc status=none
cat payload.txt
sha256sum -c SHA256SUMSconv=notrunc is de relevante flag: zonder deze flag kapt dd het bestand af op het punt waar het stopt met schrijven, en zou u een veel duidelijker soort schade testen. De controle geeft nu het volgende weer:
payload.txt: FAILED
sha256sum: WARNING: 1 computed checksum did NOT matchecho $? print 1. FAILED betekent dat het bestand is gelezen en dat de digest niet overeenkwam met die in de lijst. Zet de oorspronkelijke bytes terug en bevestig dat de controle weer OK retourneert:
printf 'the payload of a totally ordinary download\n' > payload.txt
sha256sum -c SHA256SUMSDat is de gehele procedure. Eén byte verschil, waar dan ook in het bestand, resulteert in FAILED. Een download die voortijdig is afgebroken door een verbroken verbinding, een mirror die de build van gisteren serveert, een proxy die het bestand tijdens het transport heeft herschreven, een schijf die een defect blok retourneerde: ze leiden allemaal tot diezelfde regel.
Wanneer de lijst een bestand noemt dat u niet heeft gedownload
Een echt SHA256SUMS-bestand van een distributie bevat elk image in de downloadmap, en u heeft er daar één van gedownload. Het bevat niet altijd elk image dat het project uitbrengt: per november 2026 houdt Ubuntu de amd64- en arm64-release-ISO's voor 24.04 in aparte lijsten op aparte servers, terwijl de dagelijkse Noble-lijst de amd64- en arm64-desktop-images naast elkaar bevat. Reproduceer die situatie hier.
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 is een andere fout dan FAILED, en het verwarren van beide kost onnodig tijd. FAILED betekent dat de bytes onjuist zijn. FAILED open or read betekent dat sha256sum het bestand niet kon openen of het inlezen niet kon voltooien, waardoor er geen digest is vergeleken. Bij een echte download is de werkmap meestal de oorzaak, omdat relatieve namen in de lijst worden opgelost vanaf de locatie waar u het commando uitvoert. Ga naar de map met het bestand en voer het opnieuw uit. Om alleen te controleren wat u daadwerkelijk heeft, vraagt u om het volgende:
sha256sum --ignore-missing -c SHA256SUMS.allDit print payload.txt: OK en sluit af met exitcode 0. Als geen van de vermelde namen aanwezig is, slaagt --ignore-missing niet stilletjes bij nul bestanden. Het rapporteert dat no file was verified en sluit af met een non-zero exitcode; dit is het gewenste gedrag, omdat een controle die niets heeft gecontroleerd een fout is die u anders nooit zou opmerken.
Plak een gepubliceerde digest zonder deze handmatig te controleren
Het handmatig vergelijken van 64 hexadecimale tekens is waar deze gewoonte echt tekortschiet. Mensen controleren de eerste vier en de laatste vier tekens en concluderen dat het een match is; dit is precies de vergelijking waar een vastberaden aanvaller op rekent. Laat de tool de vergelijking uitvoeren. Stel EXPECTED in op de digest die u van de uitgever heeft gekopieerd, gebruik EXPECTED= gevolgd door de geplakte waarde, en bouw vervolgens de enkele regel die -c verwacht:
printf '%s %s\n' "$EXPECTED" payload.txt > payload.sha256
cat payload.sha256
sha256sum -c payload.sha256Er staan twee spaties tussen de digest en de bestandsnaam; daarom bevat de format-string er twee. Dit is de vorm die sha256sum schrijft en die -c parseert. Een bestand dat enkel een digest bevat, is geen checksum-regel; de controle wijst het hele bestand daarom af met no properly formatted checksum lines found in plaats van te gokken welk bestand u bedoelde. Sommige projecten publiceren in plaats daarvan de BSD-stijl, SHA256 (payload.txt) = gevolgd door de digest. GNU coreutils schrijft die vorm met sha256sum --tag payload.txt en leest deze terug met -c, dus beide vormen zijn prima om op te slaan.
Wanneer een controle vreemd gedrag vertoont, bekijk de lijst dan met cat -A SHA256SUMS. Dit markeert het einde van elke regel met $ en toont tekens die u anders niet kunt zien. Een regel die eindigt op ^M$ heeft een carriage return opgepikt uit een Windows-editor. GNU sha256sum negeert dat laatste teken en print nog steeds OK, dus een CRLF-lijst is niet de oorzaak van een mislukte controle, hoewel tools buiten coreutils hier minder vergevingsgezind in zijn. Normaliseer de kopie die u bewaart met tr -d '\r' < SHA256SUMS > SHA256SUMS.clean.
Wat bewijst een checksum wel en wat niet?
Een checksum bewijst één ding: de bytes op uw schijf zijn identiek aan de bytes die de gepubliceerde digest hebben gegenereerd. Dit dekt accidentele schade volledig af. Het dekt ook een onvoorzichtige aanvaller die het bestand op een download-mirror heeft vervangen, maar niet de pagina kon aanpassen waarop de digest werd gepubliceerd.
Het bewijst niets over het auteurschap. Een digest is een feit over bytes, geen feit over personen. Als één pagina zowel het bestand als de digest serveert, kan degene die het één kan wijzigen ook het ander wijzigen. Uw OK-regel betekent dan alleen dat de mirror met zichzelf in overeenstemming is. Daarom geldt de volgende regel om checksums zinvol te maken: haal de digest ergens anders vandaan dan waar u het bestand heeft gedownload. Bijvoorbeeld het eigen domein van het project via TLS (transport layer security), terwijl de image van een mirror of een torrent kwam. Een aanvaller moet nu twee locaties beheersen in plaats van één. Het zegt ook niets over wat die geverifieerde bytes doen zodra u ze uitvoert. Dat is een aparte vraag die u moet stellen bij alles wat namens u wordt uitgevoerd, van een installatiescript tot een dsh-plugin die draait met de rechten van uw agent.
Het algoritme is ook van belang. SHA-256 (secure hash algorithm, 256-bit output) heeft per oktober 2026 geen bekende botsingen, en daarom gebruiken uitgevers dit. MD5 (message digest 5) en SHA-1 voldoen niet meer: twee verschillende bestanden met dezelfde MD5-digest zijn sinds 2004 te construeren, en een chosen-prefix SHA-1-botsing werd in 2020 gepubliceerd. Een MD5SUMS-bestand detecteert nog steeds een afgebroken download, omdat willekeurige corruptie geen doelbewust geconstrueerde botsing is. Het kan echter niemand stoppen die u probeert te misleiden. Wanneer een project beide publiceert, gebruik dan de SHA-256-regel.
Waar handtekeningen het overnemen
Een handtekening dicht het gat dat een digest openlaat. De uitgever ondertekent het digest-bestand met een private key, en u controleert dit met de bijbehorende public key: gpg --verify SHA256SUMS.asc SHA256SUMS. Als deze controle slaagt, is de lijst met digests afkomstig van de houder van die key. Vervolgens koppelt sha256sum -c SHA256SUMS het bestand op uw schijf aan de lijst, waardoor de keten loopt van de key tot aan de individuele bytes.
Het zwakke punt verschuift naar de key. Het ophalen van de key vanaf dezelfde pagina die het bestand aanbiedt, geeft beide helften in handen van een aanvaller. GnuPG is hier transparant over; bij een eerste verificatie wordt Good signature getoond, samen met WARNING: This key is not certified with a trusted signature!. Good signature betekent dat de wiskundige controle klopt. Het betekent niet dat de key toebehoort aan het project dat u voor ogen heeft. Haal de fingerprint op via een tweede bron, zoals de documentatie van het project op een ander domein of een distributiepakket dat de key al bevat, en vergelijk de volledige fingerprint in plaats van alleen de laatste acht tekens. Dit vereist dezelfde zorgvuldigheid als een SSH private key, om dezelfde reden: de key vormt de basis van uw vertrouwen, en alles wat daarop volgt erft dit vertrouwen over.
Reproducible builds tillen dit concept naar een hoger niveau. Een gepubliceerde digest bindt u nog steeds aan een binary die door één machine is gebouwd. Wanneer de build van een project reproduceerbaar is, kan iedereen dezelfde broncode compileren en een byte-identiek resultaat verkrijgen. Onafhankelijke bouwers kunnen zo de gepubliceerde digest bevestigen, in plaats van dat u moet vertrouwen op het woord van één server. Dit wordt elk jaar belangrijker, naarmate meer code via geautomatiseerde pipelines en door machines geschreven patches binnenkomt. Beslissen wat u accepteert in een build is een beleidskwestie, en open source-beleid voor AI-ondersteunde code werkt aan dezelfde toeleveringsketen vanuit de andere kant.
Uw pakketbeheerder doet dit al voor u
Op Debian en Ubuntu voert apt deze keten bij elke installatie automatisch uit. De pakketindex bevat een SHA-256 digest voor elk .deb-bestand. Het Release-bestand bevat de digests van die indexbestanden, en InRelease bevat een handtekening over Release, gecontroleerd tegen de sleutel die is benoemd in de Signed-By-optie van die repository: een keyring die een pakket onder /usr/share/keyrings heeft geïnstalleerd, een sleutelbestand dat u in /etc/apt/keyrings heeft geplaatst, of een sleutel ingebed in het .sources-bestand zelf. Wanneer de keten breekt, meldt apt dit, hoewel de exacte bewoording afhangt van de APT-versie en de verifier erachter. APT die verifieert met gpgv print The following signatures couldn't be verified because the public key is not available: gevolgd door NO_PUBKEY en de key ID wanneer de sleutel van een externe repository ontbreekt. Nieuwere APT die verifieert met sqv van Sequoia rapporteert The signatures couldn't be verified because no keyring is specified wanneer het geen bruikbare keyring vindt, en geeft anders de eigen foutmelding van sqv door na Sub-process ... returned an error code. Een andere melding, Hash Sum mismatch, betekent dat de index die u heeft opgehaald niet overeenkomt met de ondertekende Release, wat meestal betekent dat een caching proxy een verouderd bestand heeft geserveerd of dat u een mirror tijdens een synchronisatie heeft getroffen.
Dat is de standaard om tegen af te meten wanneer de homepage van een project u vertelt om een script van curl direct naar een shell te pipen. Niets verifieert de bytes en u ziet ze nooit. De server kan ook het ene teruggeven aan een script en iets anders aan een browser, en u heeft achteraf geen kopie om te inspecteren. Download naar een bestand met curl -fsSL <url> -o install.sh, hash het, lees het met less, en voer het pas daarna uit. Deze gewoonte kost ongeveer twintig seconden, en het is dezelfde gewoonte die de moeite waard is om te starten op een gloednieuwe VPS in de eerste tien minuten, voordat er iets anders op de machine wordt geïnstalleerd.
Houd een lijst met digests bij voor handmatig geïnstalleerde software
Pakketten die via apt zijn geïnstalleerd, worden bijgehouden. Een binary die u naar /usr/local/bin heeft gekopieerd, wordt niet geregistreerd en er is geen systeemproces dat deze controleert. Een digest-lijst maakt dit controleerbaar op aanvraag:
printf 'a second file\n' > notes.txt
sha256sum *.txt > inventory.sha256
sha256sum -c --quiet inventory.sha256--quiet verwijdert de OK regels, waardoor er niets wordt getoond als elk bestand overeenkomt. Wanneer bestanden niet overeenkomen, wordt er voor elk bestand een FAILED regel getoond en wordt de waarschuwingssamenvatting naar standard error gestuurd. Stilte betekent dus dat de controle is geslaagd en echo $? bevestigt dit met 0. Dit is de juiste vorm voor een geplande taak. --status gaat verder en toont helemaal niets, waardoor alleen de exit-status overblijft. Wijs hetzelfde patroon aan met sha256sum /usr/local/bin/* > ~/local-bin.sha256 naar de werkelijke bestanden om een baseline te creëren. Paden worden exact zoals ingevoerd in de lijst opgeslagen; gebruik daarom absolute paden zodat de controle vanuit elke map werkt.
Wees u bewust van de waarde van deze baseline. Het detecteert een gewijzigd bestand. Het detecteert echter geen aanvaller die al over root-rechten beschikt, omdat deze aanvaller inventory.sha256 net zo eenvoudig kan herschrijven als de binary zelf. Bewaar de lijst buiten de machine als u wilt dat deze betrouwbaar blijft. Dit is onderdeel van de bredere vraag over in hoeverre u een VPS daadwerkelijk vertrouwt en wie er nog meer toegang heeft tot de onderliggende schijf.
FAQ
Betekent een overeenkomende checksum dat de download veilig is?
Nee. Het betekent dat de bytes die u heeft overeenkomen met de hash die u heeft gecontroleerd. Als een aanvaller de pagina beheert waarop de hash is gepubliceerd, publiceert deze de hash van het eigen bestand en geeft uw controle OK weer. Een overeenkomst is een bewijs van consistentie. Een veiligheidsclaim vereist een handtekening die is geverifieerd met een sleutel die u uit een andere bron heeft verkregen; pas dan erft de hash dat vertrouwen.
Waarom geeft sha256sum -c de melding FAILED open or read?
Omdat het bestand niet kon worden geopend of gelezen, is er geen hash vergeleken. Wanneer het bestand ontbreekt, staat er direct daarboven een regel met No such file or directory en de naam die werd gezocht. Namen in een SHA256SUMS-bestand die niet beginnen met / worden opgelost vanuit de map waarin u het commando uitvoert. Ga dus naar de map met de download en voer het commando opnieuw uit. Als de lijst ook bestanden bevat die u niet heeft gedownload, voeg dan --ignore-missing toe. Een eenvoudige FAILED zonder open or read is de tegenovergestelde situatie: het bestand is gelezen, maar de hash kwam niet overeen.
Is MD5 voldoende voor het verifiëren van een download?
Voor het detecteren van onbedoelde schade wel. De kans dat een afgebroken overdracht of een defecte schijfsector per ongeluk een overeenkomende MD5-hash produceert, is verwaarloosbaar klein. Tegen een aanvaller is het niet voldoende. Twee verschillende bestanden met dezelfde MD5-hash kunnen sinds 2004 worden geconstrueerd, en SHA-1 werd in 2020 gekraakt door een 'chosen-prefix collision'. Gebruik de SHA-256-regel wanneer een project beide publiceert, en beschouw een project dat alleen MD5 aanbiedt als een teken van een verouderd releaseproces.
Wat is het verschil tussen sha256sum -c en gpg --verify?
sha256sum -c bewijst dat een bestand overeenkomt met een hash. gpg --verify bewijst dat een hashbestand is ondertekend door de houder van een specifieke privésleutel. Ze beantwoorden verschillende vragen, dus voer beide uit wanneer een project beide aanbiedt. De handtekening maakt de hashlijst betrouwbaar, en de hashlijst maakt vervolgens het gedownloade bestand betrouwbaar.
Hoe controleer ik één bestand tegen een hash die op een webpagina staat?
Vergelijk de tekens niet met het blote oog. Sla de hash en de bestandsnaam op één regel op, gescheiden door twee spaties, voer vervolgens sha256sum -c uit op dat bestand en lees de OK of FAILED die het weergeeft. Het opbouwen van de regel met printf '%s %s\n' voorkomt de opmaakfouten waardoor sha256sum het bestand afwijst met no properly formatted checksum lines found.