文章目录前情提要前提說明方法一:RSA 私鑰解密(僅適用 TLS 1.2,且 Cipher Suite 無 ECDHE/DHE)方法二:SSLKEYLOGFILE(推薦,TLS 1.2 與 TLS 1.3 皆適用)1. 設置環境變數2. 依 Client 類型確認接入方式3. 抓包 產生流量4. Wireshark 指向 keylog 檔案5. 驗證總結建議前情提要Wireshark will decrypt the TLS (HTTPS) traffic and save the plain text: 將TLS (https) decrypt 並保存明文筆者現職開發 WiFi router/AP/bridge/local controller 產品經常遇到各類傳輸throughput/traffic 問題加上 cyber security 要求高漲的情況下提供一種 debug 的方法前提說明項目TLS 1.2TLS 1.3是否支援 RSA 靜態私鑰解密支援(僅限 Cipher Suite 為 RSA key exchange,不含 ECDHE/DHE)不支援,協定已移除靜態 RSA 金鑰交換,憑證私鑰只用於簽章認證SSLKEYLOGFILE 是否適用適用適用(唯一可行方法)結論:若要一套方法同時涵蓋 TLS 1.2 與 TLS 1.3,應統一採用SSLKEYLOGFILE。RSA 私鑰法僅作為 TLS 1.2 且未使用前向保密時的備選。方法一:RSA 私鑰解密(僅適用 TLS 1.2,且 Cipher Suite 無 ECDHE/DHE)Wireshark → Edit → Preferences → Protocols → TLS「RSA keys list」→ Edit → 新增一筆:IP address(伺服器 IP,可用any)Port(通常 443)Protocol(通常http)Key File(PEM 格式私鑰路徑,若有密碼則填入 Password)抓包須包含完整 handshake(ClientHello ~ Certificate),Wireshark 會自動解密對應 Application Data,顯示在「Decrypted TLS」層。限制:Cipher Suite 名稱含ECDHE/DHE即代表前向保密,此法無效;TLS 1.3 一律無效。方法二:SSLKEYLOGFILE(推薦,TLS 1.2 與 TLS 1.3 皆適用)1. 設置環境變數exportSSLKEYLOGFILE/path/to/keylog.txt需在啟動 client 進程之前設置,同一 shell/進程環境下執行。2. 依 Client 類型確認接入方式Client是否原生支援環境變數備註Chrome / Chromium / Edge是易上手但系統笨重設好變數直接啟動即可自動寫入Firefox是同上curl(OpenSSL/BoringSSL/LibreSSL 編譯,7.61)是環境變數自動生效OpenSSLs_client(1.1.1)否,用參數openssl s_client -keylogfile keylog.txt ...最推薦openssl compile 可以比 curl 更加輕量化Python(3.8)否,需程式碼設置ctx.keylog_filename /path/keylog.txt(需自建ssl.SSLContext,requests需搭配urllib3/httpx自訂 adapter)Node.js(12)否,需程式碼設置監聽tlsSocket.on(keylog, line fs.appendFileSync(path, line))Java(JSSE)否需額外掛 Java agent(如SSLKeyLogWriter)產生自寫 C/C(OpenSSL 1.1.1)否輕量化的極致。需呼叫SSL_CTX_set_keylog_callback()自行寫檔3. 抓包 產生流量先啟動 Wireshark 抓包(或 tcpdump/dumpcap),再執行 client 產生目標連線,抓包時間需涵蓋完整連線過程。此時問題就變成如何將 sslkeylog 移動到 wireshark 的運行平台畢竟比較不可能是使用 client 來運行4. Wireshark 指向 keylog 檔案Edit → Preferences → Protocols → TLS → 「(Pre)-Master-Secret log filename」→ 選擇keylog.txt。5. 驗證打開對應 TCP 連線,Application Data 封包下應出現「Decrypted TLS」層並顯示明文(如 HTTP/2 請求回應)。常見失敗原因:keylog 檔案沒有對應連線記錄(client 實際未寫入,常見於 Python/Node.js 未在程式碼中顯式設置)抓包未包含 ClientHello 等握手起點封包Wireshark 版本過舊,不支援 TLS 1.3 解密(建議 3.0)總結建議若目標流量可能含 TLS 1.3,直接採用 SSLKEYLOGFILE,不要依賴 RSA 私鑰法。RSA 私鑰法僅在舊系統、明確使用 RSA key exchange 且無法修改 client 時才考慮。Python / Node.js / Java 等語言需要額外修改程式碼或掛載 agent 才能產生 keylog,不能只靠設環境變數。