Wireshark 解密 HTTPS 完整教程:SSLKEYLOGFILE 配置与实战

TCP 握手看得清清楚楚,DNS 查询也是明文,一路看到 TLS 握手之后就只剩 Application Data——这是所有人第一次抓 HTTPS 时的共同体验。

这不是抓包失败,是 TLS 在正常工作。想看到里面的 HTTP 请求头、请求参数和响应内容,需要把 会话密钥交给 Wireshark。本文讲的是桌面浏览器上最干净的一条路:用 SSLKEYLOGFILE 让浏览器自己把密钥写出来。

如果你要解的是手机 App 的流量,思路不同(走代理 + 装证书),见移动端抓包与 HTTPS 解密。

一句话方案:设置环境变量 SSLKEYLOGFILE 指向一个文本文件,完全退出浏览器再重新打开,然后在 Wireshark 的 Preferences → Protocols → TLS → (Pre)-Master-Secret log filename 里选中同一个文件。之后抓的 HTTPS 就会自动解密。

一、先搞清原理:为什么服务器私钥解不了

网上流传一种说法:「拿到服务器私钥就能解密 HTTPS」。这个说法在 2010 年之前是对的,现在基本失效了——原因在于密钥交换方式变了。

早期的 TLS 用 RSA 密钥交换:客户端生成一个随机数,用服务器的公钥加密后发过去,服务器用私钥解开。这种情况下,谁有私钥谁就能还原出对称密钥,从而解密全部流量。

现在的 TLS(1.2 的 ECDHE 套件和全部 TLS 1.3)用临时椭圆曲线密钥交换。双方各自生成一对临时密钥,交换公钥后各自算出同一个对称密钥,这个密钥既不在网络上传输,也不落盘,会话结束就销毁。服务器私钥在这个过程里只用来签名证明身份,跟加密数据的密钥没有任何关系。

这就是所谓的前向保密:即使服务器私钥将来泄露,历史流量依然解不开。所以想解密,只能从会话的两端想办法——要么拿到客户端算出的密钥,要么在中间做代理。

方案原理适用场景局限
SSLKEYLOGFILE浏览器把会话密钥写入文件本机浏览器、命令行工具只能解自己机器上的会话
中间人代理代理以自签证书扮成服务器手机 App、无法设环境变量的程序需装证书,部分 App 有证书固定
服务器私钥用私钥还原密钥仅 RSA 密钥交换的旧套件对 ECDHE / TLS 1.3 完全无效

本文讲的第一个方案,是三者里最省事的:不动网络结构、不装任何证书、不影响业务。

二、SSLKEYLOGFILE 是什么,凭什么能解

SSLKEYLOGFILE 原本是 NSS(Mozilla 的加密库)提供的一个调试特性:设置这个环境变量后,库会把每个 TLS 会话的对称密钥按固定格式追加写进指定文件。Chromium 系浏览器和 Firefox 都继承了这个机制。

写出来的文件长这样,每行一条记录:

CLIENT_RANDOM 5f3a...(64字节十六进制) 8b21...(96字节)
CLIENT_HANDSHAKE_TRAFFIC_SECRET 5f3a... 3c9d...
SERVER_HANDSHAKE_TRAFFIC_SECRET 5f3a... a71e...
CLIENT_TRAFFIC_SECRET_0 5f3a... 6b02...
SERVER_TRAFFIC_SECRET_0 5f3a... f45c...

CLIENT_RANDOM 开头的是 TLS 1.2 及更早版本用的(后跟主密钥),其余四种是 TLS 1.3 的分阶段密钥。5f3a... 这一列是客户端随机数(ClientHello 里就能看到),Wireshark 靠它把密钥和具体的连接对应起来。

所以这个文件等于万能钥匙:谁拿到它,配合对应的抓包文件,就能解出全部明文。这一点在第七节还会再强调。

三、配置:三步走通

第 1 步:设置环境变量

三个平台的设置位置不同,注意路径要写绝对路径,文件不需要提前创建(浏览器会自动建)。

Windows:按 Win + R 输入 sysdm.cpl 回车,切到「高级」→「环境变量」,在上半部分的用户变量里点「新建」:

变量名:SSLKEYLOGFILE
变量值:C:\Temp\sslkeys.log

目录必须先存在(C:\Temp 通常就有)。用系统变量也行,但用户变量更保险——避免被组策略覆盖。

macOS:GUI 应用不读 shell 的 ~/.zshrc,要让 Finder 启动的浏览器也生效,得用 launchctl:

launchctl setenv SSLKEYLOGFILE $HOME/sslkeys.log
# 验证
launchctl getenv SSLKEYLOGFILE

这个设置在重启后失效,要长期生效可以写一个 LaunchAgent plist,或者干脆从终端启动浏览器(open -a "Google Chrome" 不会继承终端环境变量,需要直接运行可执行文件)。

Linux:写进 shell 配置即可,从终端启动的浏览器会继承:

export SSLKEYLOGFILE=$HOME/sslkeys.log
# 追加到 ~/.bashrc 或 ~/.zshrc
这一步最容易失败的地方:环境变量只对新启动的进程生效。设完之后必须把浏览器彻底退出——Windows 上确认任务管理器里没有残留的 chrome.exe(Chrome 关闭窗口后仍会驻留后台),macOS 上用 Cmd + Q 而不是点红点。很多人卡在这里,以为方法不管用。

第 2 步:让浏览器产生流量

重新打开浏览器,随便访问几个 HTTPS 网站。然后去看那个文件(Windows 上是 C:\Temp\sslkeys.log):

# Linux / macOS 查看最后几行
tail -n 5 ~/sslkeys.log

# Windows PowerShell
Get-Content C:\Temp\sslkeys.log -Tail 5

文件里有内容、且行数随浏览持续增加,说明这一步成功了。如果文件根本没被创建,回到第 1 步检查环境变量名有没有拼错、路径目录是否存在、权限是否允许写入。

第 3 步:在 Wireshark 里挂载密钥文件

打开 Wireshark,进 Edit → Preferences(macOS 是 Wireshark → Settings…),左侧协议树里找到最下面的 Protocols,展开后找 TLS(旧版本叫 SSL)。

右侧有一个字段 (Pre)-Master-Secret log filename,点 Browse 选中刚才那个密钥文件,确定。这个设置是全局的,设一次之后所有抓包都会尝试用它解密。

然后开始抓包、在浏览器里访问目标网站。解密成功的标志是:原本只有 TLS 的包列表里,出现了 HTTP 或 HTTP/2 协议的条目,点开能看到完整的请求方法、URL、请求头和响应体。在包详情面板的 TLS 层上方,会多出一个 Decrypted TLS 标签页。

四、浏览器支持情况

不是所有浏览器都吐密钥,这一点在选工具时得先确认。

浏览器支持 SSLKEYLOGFILE备注
Chrome支持需完全退出后台进程后重启
Edge支持同为 Chromium 内核,行为一致
Firefox支持同样读环境变量,无需改 about:config
Safari不支持无对应开关,需改用代理方案
curl / wget支持用 OpenSSL 的版本会读该变量

Safari 用户想抓本机流量,最现实的办法是开无痕窗口临时用 Chrome 抓一遍,或者走中间人代理方案。不要在这上面花太多时间——浏览器层面没有可用的口子。

五、TLS 1.3 与 QUIC 的特殊情况

TLS 1.3 为什么必须用密钥日志

TLS 1.3 把握手中除了 ServerHello 之外的部分全部加密了——包括证书交换。这意味着你在抓包里连「对方用了什么证书」都看不到,服务器私钥更没有用武之地。SSLKEYLOGFILE 是唯一可行的解密途径,好在 Wireshark 3.0 起就完整支持 TLS 1.3 的四种流量密钥。

如果解密后只看到握手成功但应用数据仍是密文,先确认 Wireshark 版本不低于 3.0(当前稳定版 4.6.9 完全没问题),再检查密钥文件是不是在抓包开始之后才写入的——密钥日志只覆盖写入之后的会话。

QUIC / HTTP3 流量

Chrome 和 Edge 对支持 HTTP/3 的站点会优先走 QUIC(UDP 443),这时你在 TCP 上看不到任何东西,容易误判成「抓不到包」。

好消息是 QUIC 内部用的也是 TLS 1.3,密钥同样会写进 key log,Wireshark 4.x 能直接解开。如果发现 QUIC 流量解不开,有两种处理:

排查阶段禁用 QUIC 是很常见的做法,定位完再改回来即可。

六、解密失败?6 个排查点

按出现频率从高到低排列,基本能覆盖九成情况。

1. 浏览器没有真正重启。最经典。Windows 上 Chrome 关窗口后仍有后台进程(尤其是开启了「关闭后继续运行后台应用」),环境变量不会重新读取。任务管理器里结束所有 chrome.exe 再打开。

2. 密钥文件路径不一致。环境变量里写的是 C:\Temp\sslkeys.log,Wireshark 里却选了别的路径,或者反过来。两边必须是同一个文件。

3. 抓包早于密钥写入。密钥日志只对写入之后的会话有效。如果先抓包、后设变量,那段时间的流量解不开——重新抓一遍就好。

4. 企业代理做了 TLS 拦截。公司网络里如果部署了 SSL 检测设备或代理,浏览器实际是和代理做 TLS,代理再和服务器做一次。你抓到的密钥是「浏览器 ↔ 代理」这一段的,而想看的业务内容在「代理 ↔ 服务器」那一段——后者需要代理自己的密钥日志,通常拿不到。识别方法:看证书签发者是不是公司自己的 CA。

5. 密钥文件权限问题。某些系统的临时目录有访问控制,浏览器写不进去,文件一直是空的或根本不存在。换到用户主目录下再试。

6. 用的是不支持的应用。比如某些 Electron 应用、Java 程序、Go 编译的客户端,它们各有自己的 TLS 实现,不读 SSLKEYLOGFILE。这类只能走代理方案。

七、安全与合规:这个文件比你想的危险

密钥日志文件里存的是会话密钥本身。任何同时拿到「密钥文件 + 抓包文件」的人,都能解出全部明文——包括登录 Cookie、表单提交的密码、接口返回的个人信息。

几条必须遵守的实践:

合规底线:这套方法只能解密你自己设备上、你自己产生的流量——因为密钥来自你自己的浏览器。试图解密他人流量既做不到,也不合法。在企业环境抓包前请取得书面授权。

八、常见问题

能解密别人的 HTTPS 吗?
不能。SSLKEYLOGFILE 的密钥由你自己的浏览器在本地生成,只对应你自己发起的会话。别人设备上的密钥你拿不到,服务器私钥对 ECDHE / TLS 1.3 也无能为力。这是 TLS 前向保密的设计目标,不是可以绕过的限制。
TLS 1.3 的流量能解吗?
能,而且只能靠密钥日志。TLS 1.3 把证书交换都加密了,服务器私钥完全无用。Wireshark 3.0 起支持 TLS 1.3 的四种流量密钥,当前稳定版直接可用。
手机 App 的 HTTPS 怎么解?
手机上没有 SSLKEYLOGFILE 这个入口,得走中间人代理:手机连电脑代理、安装并信任代理的 CA 证书。部分 App 有证书固定(Pinning),检测到代理证书就断连,需要额外处理。完整流程见移动端抓包指南。
密钥文件会被滥用吗?
会。它等于对应抓包文件的万能钥匙,能解出 Cookie、密码、个人信息。用完立即删除,不要提交到 git、不要留在共享目录。开启期间也尽量不访问网银等敏感站点。
解密后部分内容还是乱码?
常见两种情况:响应体被 gzip / br 压缩,需要在 Wireshark 里开启解压(Preferences → Protocols → HTTP → 勾选解压实体主体);或者数据是二进制的 protobuf、WebSocket 帧,Wireshark 无法自动还原成可读文本。
设置完环境变量,浏览器里看不到文件生成?
依次检查:变量名是否拼成 SSLKEYLOGFILE(全大写)、路径目录是否存在且有写权限、浏览器是否完全退出后重启、是否用了不支持的浏览器(Safari)。另外确认启动浏览器的进程真的继承了这个环境变量——从 Dock 或开始菜单启动和从终端启动,继承关系不同。

HTTPS 这一关过了,说明你已经能看清流量的真实内容。接下来值得补的两块:过滤器语法用来在海量解密流量里快速定位,五步故障排查法把「看到的现象」翻译成「问题的原因」。