calculate crc32 of a file
計算檔案的 CRC32:比對 8 位數檢查碼

「計算檔案的 CRC32」實際涵蓋的內容

檔案的 CRC-32/ISO-HDLC 是將檔案涵蓋的位元組通過反射多項式 0xEDB88320(初始暫存器 0xFFFFFFFF、最終 XOR 0xFFFFFFFF)所產生的八位數小寫十六進位值。對於 ASCII 位元組 123456789,標準化檢查值為 cbf43926,這就是不同實作辨識相同變體的方式。因此「計算檔案的 CRC32」意謂著決定檔案中哪些位元組屬於涵蓋範圍、將這些位元組轉為 UTF-8 文字或原始十六進位對,並產生一個無正負號 32 位元結果,格式化為恰好八個十六進位數字並保留前置零。

大多數讀者來到這裡,是因為下載頁面、建構腳本或同事在某個檔案旁邊公布了像 cbf43926 這樣的值,並要求他們確認是否相符。挑戰很少在運算本身,幾乎總是在位元組範圍:公布的值涵蓋的是原始位元組、標頭加上本體,還是去掉長度欄位後精簡的本體?弄錯這一點,即使每個工具都是正確的,也會產生與其他所有工具不一致的結果。

如何使用瀏覽器工具計算檔案的 CRC32

CRC32 計算器接受 UTF-8 文字或精確的十六進位位元組,並以八位數小寫十六進位字串形式回傳 CRC-32/ISO-HDLC 值。計算完全在瀏覽器中進行,輸入不會被上傳,而複製動作僅複製 32 位元值,這使得機密資料不會上傳到網路。

  1. 識別所需的 CRC 變體與精確的位元組範圍。本頁僅實作 CRC-32/ISO-HDLC,這是 gzip、ZIP、PNG 以及大多數通用存檔與影像格式所使用的反射多項式 0xEDB88320 變體。
  2. 透過檢查標準值來確認變體:對於 ASCII 位元組 123456789,結果必須為 cbf43926。若預期值不同,表示另一個系統使用的是不同的 32 位元公式,例如 CRC-32C、Koopman、MPEG-2、BZIP2 或 JAMCRC。
  3. 選擇輸入模式。僅在規格將涵蓋的酬載描述為字串時選擇 UTF-8 文字;在規格將酬載描述為精確位元組、標頭、長度欄位或儲存的 CRC 位元組時,選擇十六進位位元組。
  4. 精確輸入酬載。十六進位模式會忽略位元組對之間的空白,但需要偶數位數、拒絕 0x 前綴與奇數尾端半位元組,並保留前置 00 位元組。
  5. 計算後,將結果的所有八位數(含前置零)與預期值比對。相符僅能證明意外錯誤的一致性,並非真實性。

各檔案格式涵蓋位元組的起點與終點

檔案格式並非全部涵蓋相同的位元組。兩個正確的實作結果不一致的最常見原因,就是其中一個包含了標頭或長度欄位,而另一個沒有。下表列出使用 CRC-32/ISO-HDLC 之格式的標準範圍。

格式涵蓋的位元組儲存位置
gzip (RFC 1952)未壓縮的原始位元組,在壓縮前計算結尾區段,little-endian,位於 ISIZE 之前
PNG區塊類型代碼加上區塊資料,針對每個使用 CRC 的 IDAT 與輔助區塊每個區塊的 4 位元組 big-endian 結尾區段
ZIP 本地檔案標頭從簽章到檔名與額外欄位的位元組,不含資料描述子本地標頭中的 4 位元組 little-endian 欄位
ZIP 中央目錄項目從中央目錄標頭簽章到檔案註解結束的位元組中央目錄項目中的 4 位元組 little-endian 欄位
ZIP 資料描述子選用的 4 位元組簽章,接著是 CRC32,再來是壓縮與未壓縮大小在一般用途旗標的第 3 位元被設定時,位於檔案資料之後

驗證下載的檔案時,先找出儲存的值,再確認規格說明涵蓋哪些位元組,最後僅將這些位元組輸入計算器。如需 ZIP、PNG 與 gzip 各格式特定位元組範圍的更深入指引,請參閱如何計算 ZIP、PNG 與 gzip 檔案的 CRC32。

正確比對八位數結果

輸出格式化為恰好八個小寫十六進位數字,且該值被視為無正負號,因此前置零一律會顯示。前置的 0x00 位元組會作為輸入保留並影響最終的八位數輸出,而額外的前置 0x00 位元組也會持續影響結果。因此,刪除前置零或將結果改為大寫,是「幾乎相符」報告的常見原因。

計算器使用由反射多項式 0xEDB88320 建構的 256 項表格、從最低有效位元開始處理每個位元組,並在格式化前以 0xFFFFFFFF 對暫存器取補數。這是 RFC 1952 中針對 gzip 所描述的實用表格驅動方法,並與 zlib 檢查碼手冊 中記錄的演算法一致。在相同位元組序列上與 zlib 的 crc32 函式交叉比對,是快速確認差異來自位元組範圍而非演算法的方法。

常見的變體與位元組範圍錯誤

數種 32 位元 CRC 公式存在著不同的多項式、初始值或最終 XOR 常數。區別參數如下表所列。

變體反射多項式初始值最終 XOR「123456789」的檢查值
CRC-32/ISO-HDLC(本工具)0xEDB883200xFFFFFFFF0xFFFFFFFFcbf43926
CRC-32C(Castagnoli)0x82F63B780xFFFFFFFF0xFFFFFFFFe3069283
CRC-32/MPEG-20x04C11DB70x000000000x000000000376E6E7
CRC-32/BZIP20x04C11DB70xFFFFFFFF0xFFFFFFFFFC891918
CRC-32/JAMCRC0xEDB883200xFFFFFFFF0x00000000340BC6D9

若 123456789 的預期值不是 cbf43926,表示來源使用的是不同的 32 位元公式。同樣常見的情況是:將涵蓋的位元組重新輸入為可見文字,因而遺失了 CR LF 與 LF 之間、UTF-8 與 UTF-16 之間、NFC 與 NFD 標準化之間,或是原始位元組與位元組的 Base64 表示之間的差異。當協定交給你的是位元組時,就貼上位元組;當協定交給你的是文字時,請確認編碼恰好是 UTF-8,沒有 BOM,也沒有標準化的換行轉換。

CRC32 並非安全性或真實性檢查

CRC-32 是一種循環冗餘檢查,設計用於偵測資料中常見的意外變更,例如不穩定磁碟上的位元翻轉或下載被截斷。它是線性的且極易被操控:任何想要讓酬載雜湊成所選 32 位元值的人,都可以在不知道原始資料的情況下構造出該酬載。CRC32 不是加密、不是密碼雜湊、不是訊息驗證碼,也不是數位簽章。

你可以用它來確認解壓縮後的存檔與旁邊公布的數值相符,或是確認寫入磁碟的檔案仍與記憶體中的內容一致。請勿用它來驗證不受信任的軟體、授權指令、保護憑證,或證明檔案來自受信任的發行者。針對對抗式完整性,請透過已驗證的通道傳輸檔案,並同時公布 SHA-256 或更強的密碼學摘要。

檔案大小限制與處理更大檔案的作法

瀏覽器工具最多可處理 5,000,000 位元組的輸入,使表格驅動迴圈在頁面上仍能保持回應速度。輸出絕不會被悄悄截斷:永遠會顯示八個十六進位數字,且該值被視為無正負號,因此任何被接受的輸入結果即為完整的 32 位元檢查值。空白的程式化輸入其 CRC 為 00000000,雖然介面會要求資料以避免意外的空點擊看起來像是有意義的驗證。

對於較大的酬載,請將輸入切分為不超過上限的區塊,分別計算每個區塊自身位元組的 CRC32,再使用演算法的串流特性來合併各區塊的值。若下游消費者已提供參考值,建議使用直接從磁碟讀取檔案或以串流方式處理的工具,讓整個檔案能以單次處理完成雜湊,而無需手動切塊。

若你正在權衡選項,BCC 檢查碼說明:XOR-8 的運作方式與其不足之處對此有詳細說明。