加密/哈希

文件哈希

计算文件的 MD5、SHA-256 等哈希值,用于校验下载或比对文件

算法:
将文件拖到此处,或点击选择文件

什么是文件哈希?

文件哈希是对整个文件内容计算哈希值(如 MD5、SHA-256),得到固定长度的摘要。常用于验证下载文件是否完整、未被篡改,或快速比对两个文件是否相同。

支持的算法

  • MD5:128 位,常用于历史校验(不推荐用于安全场景)
  • SHA-1:160 位
  • SHA-256 / SHA-384 / SHA-512:推荐用于文件校验

使用场景

  • 下载校验:对比官方提供的 SHA-256 与本地计算值是否一致
  • 文件去重:通过哈希判断两个文件内容是否相同
  • 备份验证:确认备份文件与源文件一致

所有计算均在浏览器内完成,文件不会上传到服务器。

本工具在浏览器标签页内读取你选择的文件,按整份字节内容算出 MD5、SHA-1、SHA-256、SHA-384 或 SHA-512 的十六进制摘要,文件不上传。适合核对下载包与发布方给出的校验值、判断两份拷贝是否逐字节一致,或在归档前留存文件的指纹。

摘要只覆盖字节,不覆盖你看到的文字

文件的哈希是对磁盘上的字节运算的结果。同一句话在 Windows 上保存时,每个 0x0A 前面会多插一个 0x0D,12 字节就变成 13 字节;UTF-8 BOM 会在开头加 3 个字节;FTP 或邮件的文本模式传输也可能顺手改写换行。这些改动都会改变输入,而哈希的雪崩效应让两边看不出任何关系:CRLF 版本的 SHA-256 与 LF 版本没有共同前缀。把同一目录重新打包成 ZIP 或把 JPEG 再压一遍,图片和文件清单看着没变,字节却全变了。两边摘要不一致时先比字节数:长度相同而摘要不同,差异在内容里;只差 1 个字节,通常就是换行符或末尾多了/少了新行。

摘要长度就是算法的名字

一个十六进制字符承载 4 位,一个摘要字节写成两个字符,因此字符串长度直接对应算法:32 个字符是 128 位的 MD5,40 个是 SHA-1,64 个是 SHA-256,96 个是 SHA-384,128 个是 SHA-512。发布页标错算法时用这个长度一秒就能识别:写着 SHA-256 却只有 40 个字符,其实是 SHA-1;64 个字符的值不可能是 MD5。校验文件里还有第二个坑:sha256sum 的格式是「摘要 + 一两个空格(或空格加 *)+ 文件名」,整行复制会把不属于摘要的文字也带进来。比较字符串时大小写也算差异,本工具的大小写开关正是为只收大写值的发布方准备的。

五种算法各自怎么算出来

Web Crypto 的 crypto.subtle.digest() 提供 SHA-1、SHA-256、SHA-384 与 SHA-512,却不提供 MD5,所以本页自带一份 MD5 实现:先补一个 0x80,补零到块内只剩 8 个字节,再把比特长度写成 64 位小端整数,最后把四个状态字按低字节在前拼成十六进制。正是这些字节序选择,让同一文件的 MD5 与 SHA 摘要在结构上毫无相似之处。SHA 系列走浏览器原语,而该原语只在安全上下文中存在:用普通 HTTP 打开页面,四个 SHA 复选框会被禁用,只剩 MD5 可用。此外,文件会先经 file.arrayBuffer() 整份读入内存,才开始处理第一个分块。

实操示例

同一句话,存成 LF 与 CRLF 两种换行

输入
两个文件:hello world 后接 0x0A(12 字节),以及完全相同的文字后接 0x0D 0x0A(13 字节)。
输出
LF 12 字节——MD5 6f5902ac237024bdd0c176cb93063dc4,SHA-256 a948904f2f0f479b8f8197694b30184b0d2ed1c1cd2a1ec0fb85d299a192a447。CRLF 13 字节——MD5 a0f2a3c1dcd5b1cac71bf0c03f2ff1bd,SHA-256 572a95fee9c0f320030789e4883707affe12482fbb1ea04b3ea8267c87a890fb。

多出的 1 个字节 0x0D 使得 32 个 MD5 字符中变了 31 个、64 个 SHA-256 字符中变了 62 个,两个结果没有任何可肉眼比对的前缀,这正是哈希能发现改动的原理。空文件是唯一有公认答案的输入:MD5 为 d41d8cd98f00b204e9800998ecf8427e,SHA-256 为 e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855。

边界与常见误用

  • 组件本身不设文件大小上限,但会先用 file.arrayBuffer() 把整个文件读进内存,MD5 还会把每个 32 位字存进数组,因此数 GB 的输入可能因内存不足而失败,而不是给出摘要。
  • SHA-1、SHA-256、SHA-384、SHA-512 依赖 crypto.subtle,它只在安全上下文可用;用普通 HTTP 打开页面时这四个复选框会被禁用,只有 MD5 能算。
  • 文件已加入列表后再勾选别的算法或切换大写,不会重新计算:没算过的那几行显示 —,需要在对应卡片上点重新计算。
  • 页面没有「期望值」输入框,算出的十六进制要自己与发布方的字符串比对;文件体积标签最大只到 MB,几 GB 的文件会显示成几千 MB。

相关工具

出问题时先看这里

2 GB 的镜像一直停在「计算中...」,最后整个标签页被系统杀掉;同一个文件只勾 SHA-256 时却能算完。

原因本页的 MD5 是手写 JavaScript,不走浏览器原语。md5FromBuffer() 先按 64 字节边界补位、复制出一份与文件等大的零填充缓冲区,再把每 4 个字节读成 number[] 的一个元素——V8 里每个元素占 8 字节,这个字数组约等于文件的两倍。对 2 GB 的文件来说,2 GB 原始缓冲、2 GB 补位副本、约 4 GB 字数组要同时存在,第一个分块还没开始,常驻内存就已经是文件的四倍。

处理取消 MD5,只留 SHA-256:SHA 路径把同一份缓冲区直接交给 crypto.subtle.digest(),不做复制,峰值内存贴近文件本身大小。确实需要 MD5 就在本地跑 md5sum <文件> 或 certutil -hashfile <文件> MD5,这件事本来不必交给浏览器。

一次拖进八个文件,结果卡片一张一张往外冒,排在最后那个要等很久才从「计算中...」出来。

原因拖放处理是「加一张卡片 → 等这份文件算完 → 再加下一张」:第 i+1 个文件在文件 i 算完之前不会进入 results,所以排队的文件在界面上根本不存在,也看不到自己排第几。本批用的算法在进循环前就固定了,中途改复选框只会作用于下一次拖放。

处理把它当严格串行的队列:大文件分几批拖,最耗时的放最后,过程中让标签页保持在前台。真要并发就在 shell 里用 sha256sum,读盘交给系统,多个进程才能真正重叠。

开着「大写」复制出去的摘要,被接口判成格式不合法,可它和发布方给的值看上去一模一样。

原因大写开关只是在摘要算完之后对十六进制字符串调用 toUpperCase(),底层字节和原本小写的那串都没变;点行复制时复制的就是屏幕上这个写法。用 ^[a-f0-9]{64}$ 校验的字段、区分大小写的唯一索引,以及会把收到的字符串再哈希一次的服务端,都会把 A–F 当成另一个值。

处理摘要要进数据库、JSON 载荷或签名时,把开关关掉;只有拿肉眼对照印刷标签时才打开。已经复制出去了就转回小写再存——摘要字节完全一样,变的只是写法。

把四条摘要依次复制进工单,过两天谁也说不清哪一行是哪个文件。

原因点行复制的只有 r.hashes[alg]:不带文件名、不带算法名,也没有分隔符。四份文件按默认的两种算法各算一遍,就是八串裸十六进制,还混着 32 字符与 64 字符两种长度,事后无法靠内容分辨归属。

处理复制时把卡片上方的文件名一并带上;或在本地用 sha256sum * 生成「摘要 + 文件名」形式的行。对照表里一列只放一种算法,32 字符和 64 字符就不会挤在同一栏。

文件一个字节都没改,这里算出的值和 Windows 那边打印出来的对不上。

原因certutil -hashfile 输出时每两个十六进制字符之间夹一个空格,末尾还跟一句「CertUtil: -hashfile command completed successfully.」,整段复制就把分隔符和这句话一起带了进来,而它们都不属于摘要。PowerShell 是第二个坑:Get-FileHash 默认算 SHA-256,并且把哈希打印成大写。

处理去掉空格、只取哈希那一行,再用「大写」开关把两边写法对齐。对齐之前先确认算法:certutil 给的 32 个字符和 Get-FileHash 的 64 个字符,格式清理得再干净也不会相等。

一个具体场景

三个发布件,一次拖入,和一圈没人要的 32 字符

一次发布有三个文件:安装包 251,658,240 字节、源码包 62,914,560 字节、校验清单 1,184 字节,体积标签分别显示 240.00 MB、60.00 MB、1.16 KB。按默认勾选一次拖进来,每张卡片出 MD5 与 SHA-256 两行,合计 3 × (32 + 64) = 288 个十六进制字符,而发布说明真正用到的只有那三条 64 字符的 SHA-256。所以先取消 MD5 再拖,而不是事后按长度挑行——少一行就少一次把 32 字符抄进 SHA-256 位置的机会。若镜像站只公开 MD5,可以留着它跟该镜像对照,但它不能替代 SHA-256 得出的校验结论。

常见问题

校验下载文件为什么要用哈希而不是文件大小?
大小相同不代表内容相同。官方发布的 SHA-256 值能唯一确认文件内容一字节不差——这是验证安装包未被篡改(供应链攻击防护)的标准手段。做法:官方页面拿到哈希 → 本地计算 → 比对,两边必须用同一算法。
计算大文件会卡浏览器吗?
计算在本地用 Web Crypto 分块进行,浏览器标签页内完成,不上传。几百 MB 的文件通常几秒到十几秒;超大文件(数 GB)受内存限制建议先分卷。计算期间可以切走,完成后结果仍在。
两个文件的 MD5 相同就说明文件一样吗?
实践中可以认为一样,但 MD5 已被构造出碰撞(不同内容相同哈希)。校验场景请优先 SHA-256;如果对比的是"不可信来源"的文件,MD5 相同不但不能证明安全,反而要警惕故意构造的碰撞攻击。

内容复核: