先把版本、平台和文件名对齐
从项目官网进入官方发布页,找到这次下载的完整资产名。版本相同但架构不同,摘要就不同;ZIP、安装程序、APK 也不能互相比较。先选对平台和 CPU 架构,再找该资产对应的 SHA-256,不要拿 Source code 压缩包的摘要去验客户端安装包。
官方可能把摘要放在发布说明、资产详情或单独的校验文件中。并非每个项目都会提供,也不保证校验文件都叫 SHA256SUMS。若只有下载站自己提供的数字,它只能说明你与下载站拿到的内容一致,不能据此证明是官方文件。
这里说的 SHA-256 通常以 64 个十六进制字符显示。算法名称必须一致:SHA-1、SHA-512、SHA3-256 或 Base64 表示的摘要不能直接拿来逐字比较。不要为凑出相同长度自行截断字符串。
算摘要前等待下载真正完成,核对选中的本地文件。浏览器可能给第二份下载加上“(1)”;路径指向旧包,再正确的命令也只会验证旧包。
Windows:只读计算,再比较完整摘要
打开 PowerShell,把下面路径替换成实际下载文件的完整路径。示例文件名不对应任何真实产品或版本。命令只读取文件,不安装、不运行它,也不需要管理员权限。
Get-FileHash -LiteralPath 'C:\Users\你的用户名\Downloads\client-installer.exe' -Algorithm SHA256 | Format-List Algorithm,Hash,Path检查输出里的 Path 是目标文件、Algorithm 是 SHA256,再比较 Hash。LiteralPath 避免把文件名里的方括号等字符当作通配符;单引号保留路径的字面写法。路径包含单引号时,PowerShell 中需要把那个单引号写成两个。
不想肉眼逐字对照,可以把官方的完整十六进制摘要粘贴进下例。不要保留占位文字,也不要复制前面的 SHA256: 标签或文件名。
$expected = '粘贴官方为该资产给出的64位十六进制摘要'
$actual = (Get-FileHash -LiteralPath 'C:\Users\你的用户名\Downloads\client-installer.exe' -Algorithm SHA256).Hash
($expected -match '^[0-9A-Fa-f]{64}$') -and ($actual -eq $expected)只有格式正确且内容一致才返回 True;PowerShell 的普通字符串 -eq 比较不区分大小写,因此 A–F 大小写差异不构成摘要差异。False 只说明这次比较未通过,继续核对输入和资产,不要立刻断言文件被植入恶意代码。
macOS 与 Linux:指定算法,别漏掉文件路径
macOS 可先用系统终端检查 shasum 是否可用;Linux 也可能安装了它。下面显式选择 SHA-256,因为 shasum 不加 -a 时默认是 SHA-1。文件路径中的空格要保留在引号内。
shasum -a 256 "$HOME/Downloads/client-package.dmg"在提供 GNU sha256sum 的 Linux 上,也可直接使用:
sha256sum "$HOME/Downloads/client-package.tar.gz"把文件名和目录换成实际值,比较输出最前面的完整摘要,不把后面的文件名也算进摘要。不要省略文件参数:这类工具可能转而等待标准输入,看起来像“卡住”。若命令不存在,先查当前系统的软件包或项目校验说明,不要为此运行来源不明的一键安装脚本。
发布者若提供校验清单,可按它指定的工具和格式使用 check 模式。shasum 的 -c 读取校验清单而不是安装包;不要把二进制安装文件当作清单喂给它。多资产清单常会列出你没有下载的其他文件,报告这些文件缺失不等于已下载的目标文件摘要错误,仍需逐项看结果。
不匹配时,先排除比较对象错误
- 确认官方页面、Release 标签、资产名、CPU 架构和文件格式属于同一组。
- 确认本地选中的是原始下载包,不是解压后的程序,也不是浏览器留下的另一份同名文件。
- 检查算法与摘要表示方式;手动复制时去掉两端空白,不要删除摘要中间的字符来“修正”结果。
- 以上一致仍不匹配,停止运行这个文件。从已确认的官方地址重新下载,再核对一次;保留原错误用于向维护者反馈。
重新压缩同一批文件也可能改变压缩包字节,所以“解压内容看起来一样”不能代替原包校验。仅改文件名通常不改变内容摘要,但会影响校验清单按文件名查找文件。
若官方替换了同名资产,应核对发布说明和当前资产信息,不要以“肯定只是更新了”为由跳过校验。遇到下载权限拒绝先处理权限,不通过换来源来绕过。
摘要相同,不等于可以忽略签名和系统提示
SHA-256 解决的是内容对应关系。假网站也能同时提供被修改的安装包和一份与它匹配的摘要。因此,可信来源是前提,不是校验命令能替你补上的结论。
数字签名或发布证明还涉及签名者身份和信任链。项目提供这些机制时,按官方说明另行核验;不要把某个 SHA-256 比对成功写成“签名验证通过”。校验一致也不证明软件没有漏洞、架构选对了,或已满足系统要求。
GitHub 对不可变发布提供单独验证流程,官方文档列出 gh release verify 和 gh release verify-asset。它有自己的适用条件,不是所有 Release 都已启用;按需生成的 Source code ZIP/tarball 也不在资产验证支持范围内。普通读者没有 GitHub CLI 时,可先完成本文的本地摘要核对,不必为一个校验任务新建访问凭据。
安装时仍应阅读系统安全提示和项目说明,不因为摘要相同就关闭系统防护。客户端平台要求与下载入口可回到v2rayN 教程或FlClash 教程核对。
校验完留下什么,怎样恢复
记录官方发布页、资产名、算法、完整摘要与校验日期,后续迁移或重复下载时可以对照。无需上传安装包到陌生“在线校验”网站,本机计算已足够。没有可信的预期摘要时,只能说“已计算本地摘要”,不能说“已验证官方一致”。
这些命令没有修改文件或系统设置,无须回滚网络、证书或代理。PowerShell 示例中的两个变量只用于当前会话;用完关闭窗口即可。安装升级是下一步,应另按客户端教程保存必要配置,不要把一次校验混成自动卸载、覆盖或执行。
本文给出校验方法,不声称在各平台测试过某个安装包,也不为任何未实际核验的发布资产背书。
参考资料
以下官方资料于 2026.10.22 核对。命令中的路径与文件名均为示例。