SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Weryfikacja sumy kontrolnej pliku w systemie Linux

Dowiedz się, jak użyć polecenia sha256sum do sprawdzenia integralności pobranych plików. Poradnik pokazuje proces weryfikacji oraz interpretację komunikatu o błędzie sumy.

Verified Every command ran end-to-end on a fresh Ubuntu 24.04 server, August 12, 2026.

Weryfikacja pobranego pliku za pomocą sumy kontrolnej w dwie minuty

Aby zweryfikować pobrany plik za pomocą sumy kontrolnej, należy wygenerować skrót otrzymanego pliku i porównać go z wartością udostępnioną przez wydawcę. Narzędzie sha256sum wykonuje obie części tego zadania: samodzielnie wyświetla skrót, a z flagą -c odczytuje listę skrótów i wskazuje, które pliki są zgodne. Niniejszy przewodnik przeprowadza przez cały proces na przykładzie utworzonego pliku, a następnie celowo go uszkadza, aby umożliwić obserwację błędu w praktyce.

Podczas całego procesu należy pamiętać o jednej zasadzie. Suma kontrolna informuje jedynie, czy posiadane bajty są tymi samymi, które wygenerowały dany skrót; nie dostarcza żadnych informacji o autorze pliku. To drugie zagadnienie wymaga użycia podpisu cyfrowego oraz zaufanego klucza. Ostatnia część przewodnika dokładnie wyjaśnia różnicę między tymi dwoma mechanizmami.

Utworzenie pliku do ćwiczeń

Należy pracować w katalogu tymczasowym, aby nie wpływać na pozostałe elementy systemu. Wszystkie poniższe polecenia pochodzą z pakietu GNU coreutils, który stanowi podstawowy zestaw narzędzi dostępny na każdym serwerze Ubuntu lub Debian, zatem nie ma potrzeby instalowania dodatkowego oprogramowania.

mkdir -p ~/checksum-demo
cd ~/checksum-demo
printf 'the payload of a totally ordinary download\n' > payload.txt
sha256sum payload.txt

Otrzymasz jedną linię: 64 znaki szesnastkowe, dwie spacje, a następnie nazwę pliku. Te 64 znaki to skrót (digest) pliku. Uruchom polecenie ponownie, a linia będzie identyczna, ponieważ haszowanie jest deterministyczne: te same dane wejściowe zawsze dają ten sam wynik. Zmień jeden znak w pliku i uruchom polecenie ponownie – skrót nie zmieni się tylko nieznacznie. Będzie wyglądał zupełnie inaczej, ponieważ zmiana jednego bitu wejściowego powoduje zmianę około połowy bitów wyjściowych. Ta właściwość sprawia, że 64-znakowy ciąg znaków może służyć jako użyteczny odpowiednik obrazu o rozmiarze 4 GB.

Zapisywanie pliku SHA256SUMS i jego weryfikacja

Suma kontrolna wyświetlona na ekranie jest bezużyteczna po upływie doby. Należy zapisać ją do pliku w formacie generowanym przez sha256sum, aby narzędzie mogło później odczytać zawartość.

sha256sum payload.txt > SHA256SUMS
cat SHA256SUMS
sha256sum -c SHA256SUMS

sha256sum -c odczytuje każdą linię listy, oblicza skrót pliku wskazanego w tej linii i porównuje oba skróty. Poprawne wykonanie operacji skutkuje wyświetleniem jednej linii dla każdego pliku:

payload.txt: OK

Należy również sprawdzić kod wyjścia, ponieważ skrypty odczytują ten parametr, ignorując tekst. echo $? wyświetla 0 po poprawnym zakończeniu operacji. Nazwa SHA256SUMS jest raczej konwencją niż sztywną zasadą, jednak dystrybucje oraz większość stron z wydaniami oprogramowania ją stosują. Warto używać tej nazwy, aby inni użytkownicy wiedzieli, co zawiera plik bez konieczności jego otwierania.

Zmiana jednego bajta powoduje niepowodzenie weryfikacji

Teraz celowo uszkodź plik. Poniższe polecenie zapisuje pojedynczy bajt pod offsetem 5, nie zmieniając pozostałej zawartości, dzięki czemu plik zachowuje swoją długość oraz nazwę.

printf 'X' | dd of=payload.txt bs=1 seek=5 conv=notrunc status=none
cat payload.txt
sha256sum -c SHA256SUMS

conv=notrunc to kluczowa flaga: bez niej dd obcina plik w miejscu, w którym kończy zapis, co prowadziłoby do testowania znacznie bardziej oczywistego rodzaju uszkodzenia. Weryfikacja wyświetla teraz:

payload.txt: FAILED
sha256sum: WARNING: 1 computed checksum did NOT match

echo $? wypisuje 1. FAILED oznacza, że plik został odczytany, a jego skrót nie zgadza się z tym zawartym na liście. Przywróć oryginalne bajty i potwierdź, że weryfikacja ponownie zwraca OK:

printf 'the payload of a totally ordinary download\n' > payload.txt
sha256sum -c SHA256SUMS

Na tym polega cały nawyk. Jeden bajt różnicy w dowolnym miejscu pliku skutkuje FAILED. Pobieranie przerwane przez zerwane połączenie, serwer lustrzany udostępniający wczorajszą wersję, proxy, które zmodyfikowało plik w trakcie przesyłania, czy dysk, który zwrócił uszkodzony blok: wszystkie te przypadki kończą się tym samym komunikatem.

Gdy lista zawiera plik, którego nie pobrano

Prawidłowy plik SHA256SUMS z dystrybucji zawiera listę wszystkich obrazów znajdujących się w katalogu pobierania, a użytkownik pobrał tylko jeden z nich. Nie zawsze są to wszystkie obrazy, które projekt udostępnia: według stanu na listopad 2026, Ubuntu przechowuje obrazy ISO wersji 24.04 dla architektur amd64 i arm64 na osobnych listach na różnych serwerach, podczas gdy codzienna lista Noble zawiera obrazy desktopowe amd64 i arm64 obok siebie. Należy odtworzyć tę sytuację w tym miejscu.

printf 'a second file\n' > notes.txt
sha256sum payload.txt notes.txt > SHA256SUMS.all
rm notes.txt
sha256sum -c SHA256SUMS.all
payload.txt: OK
sha256sum: notes.txt: No such file or directory
notes.txt: FAILED open or read
sha256sum: WARNING: 1 listed file could not be read

FAILED open or read to inny rodzaj błędu niż FAILED, a ich mylenie prowadzi do straty czasu. FAILED oznacza, że bajty są nieprawidłowe. FAILED open or read oznacza, że sha256sum nie mógł otworzyć pliku lub nie mógł dokończyć jego odczytu, więc suma kontrolna nie została porównana. W przypadku rzeczywistego pobierania najczęstszą przyczyną jest katalog roboczy, ponieważ nazwy względne na liście są rozwiązywane względem miejsca, z którego uruchomiono polecenie. Należy przejść do katalogu zawierającego plik i uruchomić polecenie ponownie. Aby sprawdzić tylko to, co faktycznie posiadasz, należy zażądać weryfikacji konkretnego pliku:

sha256sum --ignore-missing -c SHA256SUMS.all

To polecenie wypisuje payload.txt: OK i kończy działanie z kodem 0. Jeśli żadna z wymienionych nazw nie jest obecna, --ignore-missing nie kończy się cichym sukcesem dla zera plików. Zgłasza, że no file was verified i kończy działanie z kodem różnym od zera, co jest pożądanym zachowaniem, ponieważ wynik pozytywny dla sprawdzenia, które nic nie zweryfikowało, byłby błędem, którego nigdy byś nie zauważył.

Wklejanie opublikowanego skrótu bez weryfikacji wzrokowej

Porównywanie wzrokowe 64 znaków szesnastkowych jest miejscem, w którym ten nawyk zawodzi. Użytkownicy sprawdzają pierwsze cztery i ostatnie cztery znaki, uznając je za zgodne, a jest to dokładnie ten sposób porównania, na który liczy zdeterminowany atakujący. Należy pozwolić narzędziu na wykonanie porównania. Przypisz EXPECTED do skrótu skopiowanego od wydawcy, używając EXPECTED=, a następnie wklejonej wartości, po czym zbuduj pojedynczą linię, której oczekuje -c:

printf '%s  %s\n' "$EXPECTED" payload.txt > payload.sha256
cat payload.sha256
sha256sum -c payload.sha256

Pomiędzy skrótem a nazwą pliku znajdują się dwie spacje, dlatego ciąg formatujący zawiera dwie. Jest to format, w którym zapisuje sha256sum i który odczytuje -c. Plik zawierający wyłącznie skrót nie jest linią sumy kontrolnej, więc weryfikacja odrzuca cały plik z komunikatem no properly formatted checksum lines found zamiast zgadywać, o który plik chodziło. Niektóre projekty publikują sumy w stylu BSD, używając SHA256 (payload.txt) = przed skrótem. GNU coreutils zapisuje tę formę za pomocą sha256sum --tag payload.txt i odczytuje ją za pomocą -c, więc oba formaty są poprawne do zapisu.

Jeśli weryfikacja zachowuje się nietypowo, przejrzyj listę za pomocą cat -A SHA256SUMS, które oznacza koniec każdej linii za pomocą $ i pokazuje znaki, których inaczej nie można zobaczyć. Linia kończąca się na ^M$ zawiera znak powrotu karetki (carriage return) pochodzący z edytora systemu Windows. GNU sha256sum ignoruje ten końcowy znak i nadal wyświetla OK, więc lista z CRLF nie jest przyczyną niepowodzenia weryfikacji, choć narzędzia spoza coreutils są mniej wyrozumiałe w tej kwestii. Znormalizuj przechowywaną kopię za pomocą tr -d '\r' < SHA256SUMS > SHA256SUMS.clean.

Co potwierdza suma kontrolna, a czego nie?

Suma kontrolna potwierdza jedną rzecz: bajty na dysku są identyczne z bajtami, które wygenerowały opublikowany skrót. Zapewnia to pełną ochronę przed przypadkowym uszkodzeniem danych. Chroni również przed niedbałym atakującym, który podmienił plik na serwerze lustrzanym, ale nie uzyskał dostępu do strony publikującej skrót.

Suma kontrolna nie potwierdza autorstwa. Skrót jest faktem dotyczącym bajtów, a nie osób. Jeśli jedna strona udostępnia zarówno plik, jak i skrót, to osoba mogąca zmienić jeden z nich, może zmienić również drugi. W takim przypadku Twoja linia OK oznacza jedynie, że serwer lustrzany jest spójny sam ze sobą. Oto zasada, dzięki której weryfikacja sum kontrolnych ma sens: pobierz skrót z innego źródła niż plik. Na przykład: pobierz obraz z serwera lustrzanego lub sieci torrent, a skrót z domeny projektu zabezpieczonej przez TLS (transport layer security). Wtedy atakujący musiałby przejąć dwa miejsca zamiast jednego. Suma kontrolna nie mówi również nic o tym, co zweryfikowane bajty zrobią po uruchomieniu. Jest to osobna kwestia, którą warto rozważyć w przypadku każdego kodu wykonywanego w Twoim imieniu, od skryptu instalacyjnego po wtyczkę dsh działającą z uprawnieniami Twojego agenta.

Algorytm również ma znaczenie. SHA-256 (secure hash algorithm, 256-bit output) nie posiada znanych kolizji według stanu na październik 2026, dlatego jest stosowany przez wydawców. MD5 (message digest 5) oraz SHA-1 nie są już bezpieczne: dwa różne pliki o tym samym skrócie MD5 można wygenerować od 2004 roku, a kolizję SHA-1 z wybranym prefiksem opublikowano w 2020 roku. Plik MD5SUMS nadal pozwala wykryć niekompletne pobieranie, ponieważ przypadkowe uszkodzenie danych nie jest celowo spreparowaną kolizją. Nie powstrzyma to jednak nikogo, kto próbuje wprowadzić w błąd. Gdy projekt publikuje obie sumy, należy wybrać linię SHA-256.

Gdzie wkraczają podpisy

Podpis wypełnia lukę, którą pozostawia skrót. Wydawca podpisuje plik ze skrótami kluczem prywatnym, a użytkownik weryfikuje go kluczem publicznym: gpg --verify SHA256SUMS.asc SHA256SUMS. Jeśli weryfikacja przebiegnie pomyślnie, oznacza to, że lista skrótów pochodzi od posiadacza tego klucza. Następnie sha256sum -c SHA256SUMS wiąże plik na dysku z listą, a łańcuch zaufania prowadzi od klucza aż do samych bajtów.

Słaby punkt przesuwa się na klucz. Pobranie klucza z tej samej strony, z której pobrano plik, przekazuje obie części ataku w ręce napastnika. GnuPG informuje o tym wprost, a pierwsza weryfikacja wyświetla Good signature wraz z WARNING: This key is not certified with a trusted signature!. Good signature oznacza, że matematyka się zgadza. Nie oznacza to jednak, że klucz należy do projektu, o którym myślisz. Pobierz odcisk klucza z drugiego źródła, na przykład z dokumentacji projektu w innej domenie lub z pakietu dystrybucyjnego, który już zawiera ten klucz, i porównaj pełny odcisk zamiast ostatnich ośmiu znaków. Wymaga to takiej samej dbałości, jak klucz prywatny SSH, z tego samego powodu: klucz jest decyzją o zaufaniu, a wszystko, co znajduje się poniżej w łańcuchu, dziedziczy to zaufanie.

Powtarzalne kompilacje (reproducible builds) rozwijają tę ideę o krok dalej. Opublikowany skrót nadal wiąże użytkownika z plikiem binarnym zbudowanym przez jedną maszynę. Gdy kompilacja projektu jest powtarzalna, każdy może skompilować to samo źródło i uzyskać wynik identyczny co do bajta. Dzięki temu niezależni twórcy mogą potwierdzić opublikowany skrót, zamiast polegać na zapewnieniach jednego serwera. Ma to coraz większe znaczenie, ponieważ coraz więcej kodu trafia do systemów poprzez zautomatyzowane potoki (pipelines) i poprawki generowane maszynowo. Decyzja o tym, co jest akceptowane w kompilacji, jest kwestią polityki, a polityki open source dla kodu wspomaganego przez AI zajmują się tym samym łańcuchem dostaw z drugiej strony.

Menedżer pakietów wykonuje to zadanie automatycznie

W systemach Debian i Ubuntu, apt uruchamia ten łańcuch przy każdej instalacji bez dodatkowych poleceń. Indeks pakietów zawiera sumę kontrolną SHA-256 dla każdego pliku .deb. Plik Release zawiera sumy kontrolne tych plików indeksu, a InRelease zawiera podpis pliku Release, sprawdzany względem klucza określonego w opcji Signed-By danego repozytorium: może to być zestaw kluczy zainstalowany przez pakiet w /usr/share/keyrings, plik klucza umieszczony w /etc/apt/keyrings lub klucz osadzony bezpośrednio w pliku .sources. Gdy łańcuch zostaje przerwany, apt informuje o tym, choć dokładny komunikat zależy od wersji APT i użytego mechanizmu weryfikacji. APT weryfikujący za pomocą gpgv wypisuje The following signatures couldn't be verified because the public key is not available:, a następnie NO_PUBKEY oraz identyfikator klucza, gdy brakuje klucza repozytorium zewnętrznego. Nowszy APT, weryfikujący za pomocą sqv z projektu Sequoia, zgłasza The signatures couldn't be verified because no keyring is specified, gdy nie znajdzie użytecznego zestawu kluczy, a w przeciwnym razie przekazuje błąd narzędzia sqv po Sub-process ... returned an error code. Inny komunikat, Hash Sum mismatch, oznacza, że pobrany indeks nie pasuje do podpisanego pliku Release, co zazwyczaj oznacza, że serwer proxy dostarczył nieaktualny plik lub trafiono na moment synchronizacji serwera lustrzanego.

Jest to standard, do którego należy się odnosić, gdy strona domowa projektu zaleca przekierowanie skryptu z curl bezpośrednio do powłoki. Nic nie weryfikuje bajtów i nigdy ich nie widzisz. Serwer może również zwrócić inną treść skryptowi, a inną przeglądarce, przez co nie masz kopii do późniejszej inspekcji. Pobierz plik za pomocą curl -fsSL <url> -o install.sh, oblicz sumę kontrolną, przejrzyj go za pomocą less i dopiero wtedy uruchom. Ten nawyk zajmuje około dwudziestu sekund i warto go wprowadzić już na nowym VPS w pierwszych dziesięciu minutach jego działania, zanim cokolwiek innego zostanie zainstalowane na serwerze.

Prowadzenie listy sum kontrolnych dla ręcznie instalowanego oprogramowania

Pakiety instalowane przez apt są śledzone automatycznie. Plik binarny skopiowany do /usr/local/bin nie jest objęty tym mechanizmem i żaden proces systemowy go nie monitoruje. Lista sum kontrolnych pozwala na weryfikację takich plików na żądanie:

printf 'a second file\n' > notes.txt
sha256sum *.txt > inventory.sha256
sha256sum -c --quiet inventory.sha256

--quiet pomija linie OK, dzięki czemu nie generuje żadnych danych wyjściowych, gdy wszystkie pliki są zgodne. W przypadku niezgodności, narzędzie wypisuje linię FAILED dla każdego zmienionego pliku i dodaje podsumowanie ostrzeżeń na standardowe wyjście błędów. Cisza oznacza zatem wynik pozytywny, a echo $? potwierdza go za pomocą 0. Jest to format odpowiedni do zadań zaplanowanych. --status działa jeszcze bardziej restrykcyjnie i nie wypisuje niczego, pozostawiając jedynie kod wyjścia. Wskazanie tego samego wzorca dla rzeczywistych plików za pomocą sha256sum /usr/local/bin/* > ~/local-bin.sha256 pozwala utworzyć bazę odniesienia. Ścieżki są zapisywane na liście dokładnie w takiej formie, w jakiej zostały wpisane, dlatego użycie ścieżek bezwzględnych umożliwia uruchomienie weryfikacji z dowolnego katalogu.

Należy mieć świadomość ograniczeń takiej bazy odniesienia. Wykrywa ona zmianę pliku, ale nie wykryje intruza, który uzyskał już uprawnienia root, ponieważ może on zmodyfikować plik inventory.sha256 równie łatwo, jak zmodyfikował plik binarny. Aby lista zachowała swoją wartość, należy przechowywać ją poza serwerem. Jest to element szerszego zagadnienia dotyczącego poziomu zaufania do VPS oraz tego, kto jeszcze ma dostęp do fizycznego nośnika danych.

FAQ

Czy zgodna suma kontrolna oznacza, że pobrany plik jest bezpieczny?

Nie. Oznacza to jedynie, że bajty pliku zgadzają się z sumą kontrolną, z którą zostały porównane. Jeśli atakujący kontroluje stronę, na której opublikowano sumę, opublikuje on sumę swojego własnego pliku, a weryfikacja zwróci OK. Zgodność jest jedynie potwierdzeniem spójności danych. Gwarancja bezpieczeństwa wymaga podpisu zweryfikowanego kluczem uzyskanym z innego źródła; dopiero wtedy suma kontrolna dziedziczy to zaufanie.

Dlaczego sha256sum -c wyświetla FAILED open or read?

Ponieważ nie udało się otworzyć ani odczytać pliku, więc nie przeprowadzono porównania sum. W przypadku braku pliku, w linii powyżej wyświetlany jest komunikat No such file or directory wraz z nazwą szukanego pliku. Nazwy w pliku SHA256SUMS, które nie zaczynają się od /, są rozwiązywane względem katalogu, w którym uruchomiono polecenie. Należy przejść do katalogu z pobranym plikiem i uruchomić polecenie ponownie. Jeśli lista zawiera również pliki, których nie pobrano, należy dodać --ignore-missing. Zwykłe FAILED bez open or read oznacza sytuację odwrotną: plik został odczytany, ale jego suma kontrolna nie zgadza się z oczekiwaną.

Czy MD5 jest wystarczające do weryfikacji pobranego pliku?

W przypadku przypadkowych uszkodzeń – tak. Szansa, że przerwany transfer lub uszkodzony blok dysku przypadkowo wygeneruje pasującą sumę MD5, jest znikoma. W przypadku ataku – nie. Dwa różne pliki o tej samej sumie MD5 można wygenerować od 2004 roku, a SHA-1 uległo kolizji typu chosen-prefix w 2020 roku. Należy wybierać sumy SHA-256, jeśli projekt udostępnia oba rodzaje, a projekty oferujące wyłącznie MD5 traktować jako sygnał przestarzałego procesu wydawniczego.

Jaka jest różnica między sha256sum -c a gpg --verify?

sha256sum -c potwierdza, że plik zgadza się z sumą kontrolną. gpg --verify potwierdza, że plik z sumami został podpisany przez posiadacza konkretnego klucza prywatnego. Odpowiadają one na różne pytania, dlatego należy wykonać obie weryfikacje, jeśli projekt je oferuje. Podpis czyni listę sum wiarygodną, a lista sum z kolei czyni pobrany plik wiarygodnym.

Jak sprawdzić plik względem sumy kontrolnej wyświetlonej na stronie internetowej?

Nie należy porównywać znaków "na oko". Należy zapisać sumę kontrolną i nazwę pliku w jednej linii, oddzielone dwiema spacjami, a następnie uruchomić sha256sum -c dla tego pliku i odczytać OK lub FAILED. Przygotowanie linii za pomocą printf '%s %s\n' pozwala uniknąć błędów formatowania, które powodują, że sha256sum odrzuca plik z komunikatem no properly formatted checksum lines found.

Czy ten artykuł był przydatny?

#checksums#sha256sum#integrity#supply-chain#security