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
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 流量解不开,有两种处理:
- 升级 Wireshark 到较新版本,QUIC 解析在 4.x 上稳定得多;
- 临时禁用 QUIC 让流量回落到 TCP:打开
chrome://flags/#enable-quic,设为 Disabled,重启浏览器。这样所有 HTTP/3 站点都会走 HTTP/2 over TLS,抓包和解密都更省心。
排查阶段禁用 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、表单提交的密码、接口返回的个人信息。
几条必须遵守的实践:
- 用完就删。分析结束后立刻删除密钥文件,不要留在桌面或下载目录。
- 不要提交到版本库。如果放在项目目录里,务必写进
.gitignore。 - 不要在办公环境长期开启。临时设、临时用、用完取消,比一直挂着安全得多。
- 抓包文件同样要脱敏。解密后的 pcap 里可能含真实凭证,转发给同事前先删掉敏感会话。
八、常见问题
HTTPS 这一关过了,说明你已经能看清流量的真实内容。接下来值得补的两块:过滤器语法用来在海量解密流量里快速定位,五步故障排查法把「看到的现象」翻译成「问题的原因」。

